@gitkraken/core-gitlens 0.7.1 → 0.8.0

package/dist/git/providers/branches.d.ts

@@ -30,7 +30,11 @@ export type GitBranchMergedStatus = {
   localBranchOnly?: GitBranchReference;
 };
 export interface GitBranchesSubProvider {
-  getBranch(repoPath: string, name?: string, cancellation?: AbortSignal): Promise<GitBranch | undefined>;
+  getBranch(repoPath: string, name?: string,
+  /** `force`: skips the cached answer and any in-flight read that started before this call, and stores the fresh answer. */
+  options?: {
+    force?: boolean;
+  }, cancellation?: AbortSignal): Promise<GitBranch | undefined>;
   getBranches(repoPath: string, options?: {
     filter?: ((b: GitBranch) => boolean) | undefined;
     ordering?: 'date' | 'author-date' | 'topo' | null;

package/dist/git/providers/commits.d.ts

@@ -112,7 +112,30 @@ export interface GitCommitsSubProvider {
   isAncestorOf(repoPath: string, rev1: string, rev2: string, cancellation?: AbortSignal): Promise<boolean>;
   hasCommitBeenPushed(repoPath: string, rev: string, cancellation?: AbortSignal): Promise<boolean>;
   searchCommits(repoPath: string, search: SearchQuery, options?: GitSearchCommitsOptions, cancellation?: AbortSignal): Promise<SearchCommitsResult>;
-  createUnreachableCommitFromTree?(repoPath: string, tree: string, parent: string, message: string, cancellation?: AbortSignal): Promise<string>;
+  /**
+   * Creates a commit object from a tree via `commit-tree`, with explicit (zero or more) parents and an
+   * optional explicit author/committer — e.g. for merge commits assembled from multiple parents, or a
+   * commit authored on behalf of someone else. Writes the commit object only; it updates no ref, so the
+   * result is unreachable until a caller points a branch/ref at it.
+   *
+   * Signs the commit when `sign` is true, reporting a signing failure as a `SigningError`.
+   */
+  createCommitFromTree?(repoPath: string, tree: string, options: {
+    parents: string[];
+    message: string;
+    author?: {
+      name: string;
+      email: string;
+      date?: Date | string;
+    };
+    committer?: {
+      name: string;
+      email: string;
+      date?: Date | string;
+    };
+    sign?: boolean;
+    source?: unknown;
+  }, cancellation?: AbortSignal): Promise<string>;
   getCommitReachability?(repoPath: string, rev: string, cancellation?: AbortSignal): Promise<GitCommitReachability | undefined>;
   getCommitSignature?(repoPath: string, sha: string): Promise<CommitSignature | undefined>;
   /**

package/dist/git/providers/config.d.ts

@@ -3,7 +3,9 @@ import { SigningConfig, ValidationResult } from "../models/signature.js";
 import { GitUser } from "../models/user.js";
 import { GkConfigInvalidationTarget } from "../cache.js";
 //#region ../git/src/providers/config.d.ts
-export type GitCoreConfigKeys = 'commit.gpgsign' | 'core.excludesFile' | 'diff.guitool' | 'diff.tool' |
+export type GitCoreConfigKeys = 'commit.gpgsign' | 'core.excludesFile' |
+/** `core.hooksPath` — the directory git runs hooks from instead of `$GIT_DIR/hooks` */
+'core.hooksPath' | 'diff.guitool' | 'diff.tool' |
 /** `fetch.prune` — whether `git fetch` removes remote-tracking branches that no longer exist on the remote */
 'fetch.prune' | 'gpg.format' | 'gpg.program' | 'gpg.ssh.program' | 'gpg.ssh.allowedSignersFile' | 'init.defaultBranch' |
 /** `merge.autoStash` — whether `git merge` (and so a merging `git pull`) stashes and reapplies uncommitted changes */
@@ -23,6 +25,10 @@ export type GitCoreConfigKeys = 'commit.gpgsign' | 'core.excludesFile' | 'diff.g
 /** `remote.pushDefault` — the remote `git push` targets when a branch has no explicit push remote configured */
 'remote.pushDefault' | 'user.email' | 'user.name' | 'user.signingkey';
 export type GitConfigKeys = GitCoreConfigKeys |
+/** `remote` — the branch's upstream remote */
+`branch.${string}.remote` |
+/** `merge` — the upstream ref on that remote, e.g. `refs/heads/main`; together with `remote`, this is what `--set-upstream-to` writes, and writing them directly sets an upstream whose remote ref does not exist yet */
+`branch.${string}.merge` |
 /** `vscode-merge-base` — value determined by VS Code that is used to determine the merge base for the current branch. Once `gk-merge-base` is determined, we stop using `vscode-merge-base` */
 `branch.${string}.vscode-merge-base` |
 /** `github-pr-owner-number` — value determined by VS Code/GitHub PR extension that is used to determine the PR number for the current branch */

package/dist/git/providers/operations.d.ts

@@ -56,6 +56,12 @@ export interface GitOperationsSubProvider {
   }, runOptions?: GitOperationRunOptions): Promise<GitOperationResult>;
   pull(repoPath: string, options?: {
     branch?: GitBranchReference | undefined;
+    /**
+     * `'only'` requires a fast-forward (`--ff-only`) and refuses rather than merging or rebasing — a
+     * `branch` checked out nowhere is then fast-forwarded by fetching `<upstream>:<branch>`. Spelled as
+     * `merge`'s option; `--ff`/`--no-ff` are left out because a pull configured to rebase ignores them.
+     */
+    fastForward?: 'only' | undefined;
     rebase?: boolean | undefined;
     tags?: boolean | undefined;
     source?: unknown;

package/dist/git/providers/provider.d.ts

@@ -1,11 +1,13 @@
 import { Uri } from "../../utils/uri.js";
 import { GitProviderDescriptor } from "./types.js";
 import { GitIgnoreFilter } from "../watching/gitIgnoreFilter.js";
+import { RepositoryChange } from "../models/repository.js";
 import { GitMaintenanceSubProvider } from "./maintenance.js";
 import { GitCommitsSubProvider } from "./commits.js";
 import { GitBranchesSubProvider } from "./branches.js";
 import { GitContributorsSubProvider } from "./contributors.js";
 import { GitRevisionSubProvider } from "./revision.js";
+import { CachedGitTypes } from "../cache.js";
 import { GitBlameSubProvider } from "./blame.js";
 import { GitConfigSubProvider } from "./config.js";
 import { GitStagingSubProvider } from "./staging.js";
@@ -36,6 +38,21 @@ export interface GitProvider {
   getIgnoreFilter?(repoPath: string, gitDirPath: string): GitIgnoreFilter;
   getIgnoredUrisFilter?(repoPath: string): Promise<(uri: Uri) => boolean>;
   getLastFetchedTimestamp?(repoPath: string): Promise<number | undefined>;
+  /** Creates a new repository at `path` (`git init`), creating `path` itself if it doesn't yet exist. */
+  init?(path: string, options?: {
+    defaultBranch?: string;
+    bare?: boolean;
+  }): Promise<void>;
+  /**
+   * Notifies the provider that `repoPath` was mutated outside of a typed sub-provider method — e.g. a
+   * consumer that ran a command through the raw `git.run`/`provider.git.run` escape hatch. Fires the same
+   * `cache.onReset`/`repository.onChanged` hooks a typed mutator would, so, exactly as after a typed write,
+   * the provider clears its own caches for `repoPath` (every type, or just `options.cache` when given) and
+   * its pending commands before the host's handlers run.
+   */
+  notifyChanged?(repoPath: string, changes: readonly RepositoryChange[], options?: {
+    cache?: readonly CachedGitTypes[] | 'all';
+  }): void;
   readonly branches: GitBranchesSubProvider;
   readonly commits: GitCommitsSubProvider;
   readonly config: GitConfigSubProvider;

package/dist/git/providers/refs.d.ts

@@ -10,7 +10,11 @@ export interface GitRefsSubProvider {
     forkPoint?: boolean | undefined;
     priority?: GitCommandPriority;
   }, cancellation?: AbortSignal): Promise<string | undefined>;
-  getReference(repoPath: string, ref: string, cancellation?: AbortSignal): Promise<GitReference | undefined>;
+  getReference(repoPath: string, ref: string,
+  /** `force`: skips the cached answer and any in-flight read that started before this call, and stores the fresh answer. */
+  options?: {
+    force?: boolean;
+  }, cancellation?: AbortSignal): Promise<GitReference | undefined>;
   /**
    * Lightweight enumeration of ref tips (heads/remotes/tags) — no enrichment.
    * Use this when you need a SHA-to-refs map; use `getBranches`/`getTags` for full models.
@@ -38,8 +42,39 @@ export interface GitRefsSubProvider {
     } | undefined;
   }, cancellation?: AbortSignal): Promise<boolean>;
   isValidReference(repoPath: string, ref: string, pathOrUri?: string | Uri, cancellation?: AbortSignal): Promise<boolean>;
-  validateReference(repoPath: string, ref: string, relativePath?: string, cancellation?: AbortSignal): Promise<string | undefined>;
-  updateReference(repoPath: string, ref: string, newRef: string, cancellation?: AbortSignal): Promise<void>;
+  validateReference(repoPath: string, ref: string, options?: {
+    relativePath?: string;
+    /** Skips the cached answer and any in-flight read that started before this call, and stores the fresh answer. */
+    force?: boolean;
+  }, cancellation?: AbortSignal): Promise<string | undefined>;
+  /**
+   * Deletes `ref` — a symbolic ref itself, never the ref it points to; `HEAD` is refused. `expected` makes
+   * it a compare-and-swap: the delete is refused unless the ref is at that sha. Without `expected`,
+   * deleting a ref that doesn't exist succeeds — git treats it as already-done rather than an error.
+   *
+   * A local branch (`refs/heads/<name>`) is deleted the way `git branch -d` would leave things, minus its
+   * merged check: refused while checked out in any worktree, and its `branch.<name>` config section and
+   * GitLens's per-branch metadata go with it. Prefer `branches.deleteLocalBranch` unless you need the
+   * compare-and-swap.
+   *
+   * Optional because only a real git host can offer it.
+   *
+   * @throws {ReferenceUpdateError} `'conflict'` when the ref is elsewhere, `'notFound'` when
+   * `expected` was given and the ref doesn't exist, `'checkedOut'` for a branch checked out in a worktree.
+   */
+  deleteReference?(repoPath: string, ref: string, options?: {
+    expected?: string;
+  }, cancellation?: AbortSignal): Promise<void>;
+  /**
+   * Points `ref` at `sha`. `expected` makes it a compare-and-swap: a sha requires the ref to be there
+   * already, `'absent'` requires it not to exist at all (create-only).
+   *
+   * @throws {ReferenceUpdateError} `'conflict'` when the compare-and-swap lost, `'invalidRef'` for a
+   * malformed name, `'invalidObject'` when `sha` is unknown.
+   */
+  updateReference(repoPath: string, ref: string, sha: string, options?: {
+    expected?: string | 'absent';
+  }, cancellation?: AbortSignal): Promise<void>;
 }
 //#endregion
 //# sourceMappingURL=refs.d.ts.map

package/dist/git/providers/revision.d.ts

@@ -24,7 +24,11 @@ export interface GitRevisionSubProvider {
   getTrackedFiles(repoPath: string): Promise<string[]>;
   getTreeEntryForRevision(repoPath: string, path: string, rev: string): Promise<GitTreeEntry | undefined>;
   getTreeForRevision(repoPath: string, rev: string): Promise<GitTreeEntry[]>;
-  resolveRevision(repoPath: string, ref: string, pathOrUri?: string | Uri): Promise<ResolvedRevision>;
+  resolveRevision(repoPath: string, ref: string, pathOrUri?: string | Uri,
+  /** `force`: skips the cached answer and any in-flight read that started before this call, and stores the fresh answer. */
+  options?: {
+    force?: boolean;
+  }): Promise<ResolvedRevision>;
 }
 //#endregion
 //# sourceMappingURL=revision.d.ts.map

package/dist/git/providers/staging.d.ts

@@ -37,6 +37,18 @@ export interface GitStagingSubProvider {
   }): Promise<void>;
   stageAll(repoPath: string): Promise<void>;
   unstageAll(repoPath: string): Promise<void>;
+  /**
+   * Removes untracked files from the working tree (`git clean`). `force` defaults to `true`, since git
+   * refuses to clean without `-f` unless `clean.requireForce` is `false`. Pass
+   * `directories: true` to also remove untracked directories, `ignored: true` to also remove files git
+   * would otherwise skip (gitignored), and `paths` to restrict the clean to specific files/directories.
+   */
+  clean(repoPath: string, options?: {
+    paths?: (string | Uri)[];
+    directories?: boolean;
+    force?: boolean;
+    ignored?: boolean;
+  }): Promise<void>;
 }
 //#endregion
 //# sourceMappingURL=staging.d.ts.map

package/dist/git/providers/worktrees.d.ts

@@ -1,5 +1,6 @@
 import { Uri } from "../../utils/uri.js";
 import { GitWorktree } from "../models/worktree.js";
+import { GitOperationRunOptions } from "./operations.js";
 //#region ../git/src/providers/worktrees.d.ts
 export interface GitWorktreesSubProvider {
   createWorktree(repoPath: string, path: string, options?: {
@@ -8,20 +9,39 @@ export interface GitWorktreesSubProvider {
     detach?: boolean;
     force?: boolean;
     noTracking?: boolean;
-  }): Promise<void>;
+  }, runOptions?: GitOperationRunOptions): Promise<void>;
   createWorktreeWithResult(repoPath: string, path: string, options?: {
     commitish?: string;
     createBranch?: string;
     detach?: boolean;
     force?: boolean;
     noTracking?: boolean;
-  }): Promise<GitWorktree | undefined>;
+  }, runOptions?: GitOperationRunOptions): Promise<GitWorktree | undefined>;
   getWorktree(repoPath: string, predicate: (w: GitWorktree) => boolean, cancellation?: AbortSignal): Promise<GitWorktree | undefined>;
   getWorktrees(repoPath: string, cancellation?: AbortSignal): Promise<GitWorktree[]>;
   getWorktreesDefaultUri(repoPath: string): Uri | undefined;
-  /** Pass `force: 'locked'` to also override a locked worktree */
+  /**
+   * Deletes a worktree. Pass `force: 'locked'` to also override a locked worktree.
+   *
+   * `runOptions` are spread into the underlying git invocation (e.g. `{ timeout: 0 }` for a large
+   * worktree whose removal may exceed the default command timeout).
+   *
+   * On failure, the thrown error's `original` property carries the raw underlying error (stderr/stdout
+   * included) untouched, for a caller that needs to classify a platform-specific failure itself.
+   */
   deleteWorktree(repoPath: string, path: string | Uri, options?: {
     force?: boolean | 'locked';
+  }, runOptions?: GitOperationRunOptions): Promise<void>;
+  /**
+   * Removes administrative files for worktrees whose working directory no longer exists
+   * (`git worktree prune`). Pass `expire` to only prune worktrees that have been inaccessible for longer than the given time.
+   */
+  pruneWorktrees(repoPath: string, options?: {
+    expire?: string;
+  }): Promise<void>;
+  /** Locks a worktree against removal/pruning, optionally recording a reason. */
+  lockWorktree(repoPath: string, path: string | Uri, options?: {
+    reason?: string;
   }): Promise<void>;
   unlockWorktree(repoPath: string, path: string | Uri): Promise<void>;
 }

package/dist/git/run.types.d.ts

@@ -76,6 +76,7 @@ export interface GitResultCache {
     accessTTL?: number;
     cancellation?: AbortSignal;
   }): Promise<GitResult<unknown>>;
+  delete(repoPath: string, key: string): void;
 }
 /**
  * Priority levels for git commands.
@@ -119,6 +120,11 @@ export interface GitRunOptions {
       createTTL?: number;
       accessTTL?: number;
     };
+    /**
+     * Drops this command's cached result first, so the run neither returns the stale value nor joins
+     * an in-flight run of it, and stores the fresh result for later unforced reads.
+     */
+    force?: boolean;
   };
   cwd?: string;
   readonly env?: Record<string, string | undefined>;

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

@@ -1,8 +1,9 @@
 import { Uri } from "../utils/uri.js";
 import { GitProviderDescriptor } from "../git/providers/types.js";
 import { GitIgnoreFilter } from "../git/watching/gitIgnoreFilter.js";
+import { RepositoryChange } from "../git/models/repository.js";
 import { GitServiceContext } from "../git/context.js";
-import { Cache } from "../git/cache.js";
+import { Cache, CachedGitTypes } from "../git/cache.js";
 import { GitProvider } from "../git/providers/provider.js";
 import { FilteredGitFeatures, GitFeatureOrPrefix, GitFeatures } from "../git/features.js";
 import { GitLocation } from "./exec/locator.js";
@@ -96,6 +97,21 @@ export declare class CliGitProvider implements GitProvider {
   /** Returns the resolved git binary path. */
   path(): Promise<string>;
   clone(url: string, parentPath: string): Promise<string | undefined>;
+  /** Creates a new repository at `targetPath` (`git init`), creating it first if it doesn't yet exist. */
+  init(targetPath: string, options?: {
+    defaultBranch?: string;
+    bare?: boolean;
+  }): Promise<void>;
+  /**
+   * Notifies the provider that `repoPath` was mutated outside of a typed sub-provider method — e.g. a
+   * consumer that ran a command through the raw `git.run`/`provider.git.run` escape hatch. Fires the same
+   * `cache.onReset`/`repository.onChanged` hooks a typed mutator would, so, exactly as after a typed write,
+   * the provider clears its own caches for `repoPath` (every type, or just `options.cache` when given) and
+   * its pending commands before the host's handlers run.
+   */
+  notifyChanged(repoPath: string, changes: readonly RepositoryChange[], options?: {
+    cache?: readonly CachedGitTypes[] | 'all';
+  }): void;
   private _blame;
   get blame(): BlameGitSubProvider;
   private _branches;

package/dist/git-cli/cliGitProvider.js

@@ -27,6 +27,7 @@ import { StagingGitSubProvider } from "./providers/staging.js";
 import { StatusGitSubProvider } from "./providers/status.js";
 import { TagsGitSubProvider } from "./providers/tags.js";
 import { WorktreesGitSubProvider } from "./providers/worktrees.js";
+import { promises } from "node:fs";
 import * as path from "node:path";
 //#region ../git-cli/src/cliGitProvider.ts
 /**
@@ -58,7 +59,21 @@ var CliGitProvider = class {
 	context;
 	_localRepositories;
 	constructor(options) {
-		this.context = options.context;
+		const hostHooks = options.context.hooks;
+		this.context = {
+			...options.context,
+			hooks: {
+				...hostHooks,
+				cache: {
+					...hostHooks?.cache,
+					onReset: (repoPath, ...types) => {
+						this._cache.evictCaches(repoPath, ...types);
+						this._git.clearPendingCommands();
+						hostHooks?.cache?.onReset?.(repoPath, ...types);
+					}
+				}
+			}
+		};
 		this._localRepositories = options.localRepositories ?? true;
 		this._git = options.git ?? new Git(options.locator, {
 			...options.gitOptions,
@@ -107,6 +122,27 @@ var CliGitProvider = class {
 		await this._git.run({ cwd: parentPath }, "clone", url, folderPath);
 		return folderPath;
 	}
+	/** Creates a new repository at `targetPath` (`git init`), creating it first if it doesn't yet exist. */
+	async init(targetPath, options) {
+		await promises.mkdir(targetPath, { recursive: true });
+		const args = ["init"];
+		if (options?.defaultBranch) args.push("-b", options.defaultBranch);
+		if (options?.bare) args.push("--bare");
+		await this._git.run({ cwd: targetPath }, ...args);
+	}
+	/**
+	* Notifies the provider that `repoPath` was mutated outside of a typed sub-provider method — e.g. a
+	* consumer that ran a command through the raw `git.run`/`provider.git.run` escape hatch. Fires the same
+	* `cache.onReset`/`repository.onChanged` hooks a typed mutator would, so, exactly as after a typed write,
+	* the provider clears its own caches for `repoPath` (every type, or just `options.cache` when given) and
+	* its pending commands before the host's handlers run.
+	*/
+	notifyChanged(repoPath, changes, options) {
+		const types = options?.cache;
+		if (types == null || types === "all") this.context.hooks?.cache?.onReset?.(repoPath);
+		else if (types.length) this.context.hooks?.cache?.onReset?.(repoPath, ...types);
+		this.context.hooks?.repository?.onChanged?.(repoPath, [...changes]);
+	}
 	_blame;
 	get blame() {
 		return this._blame ??= new BlameGitSubProvider(this._git, this._cache, this);

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

@@ -1 +1 @@
-{"version":3,"file":"cliGitProvider.js","names":[],"sources":["../../../git-cli/src/cliGitProvider.ts"],"sourcesContent":["import * as path from 'node:path';\nimport { Cache } from '@gitlens/git/cache.js';\nimport type { GitServiceContext } from '@gitlens/git/context.js';\nimport type { GitFileStatus } from '@gitlens/git/models/fileStatus.js';\nimport { deletedOrMissing } from '@gitlens/git/models/revision.js';\nimport type { GitProvider, GitProviderDescriptor } from '@gitlens/git/providers/provider.js';\nimport { parseGitRemoteUrl } from '@gitlens/git/utils/remote.utils.js';\nimport { isUncommitted } from '@gitlens/git/utils/revision.utils.js';\nimport { GitIgnoreFilter } from '@gitlens/git/watching/gitIgnoreFilter.js';\nimport { getScopedLogger } from '@gitlens/utils/logger.scoped.js';\nimport { joinPaths, maybeUri, normalizePath, splitPath } from '@gitlens/utils/path.js';\nimport type { Uri } from '@gitlens/utils/uri.js';\nimport { fileUri, joinUriPath, parseUri, toFsPath } from '@gitlens/utils/uri.js';\nimport { fsExists } from './exec/exec.js';\nimport type { FilteredGitFeatures, GitFeatureOrPrefix, GitFeatures } from './exec/features.js';\nimport type { GitFeatureUnsupportedMessage, GitOptions } from './exec/git.js';\nimport { Git } from './exec/git.js';\nimport type { GitLocation } from './exec/locator.js';\nimport { BlameGitSubProvider } from './providers/blame.js';\nimport { BranchesGitSubProvider } from './providers/branches.js';\nimport { CommitsGitSubProvider } from './providers/commits.js';\nimport { ConfigGitSubProvider } from './providers/config.js';\nimport { ContributorsGitSubProvider } from './providers/contributors.js';\nimport { DiffGitSubProvider } from './providers/diff.js';\nimport { GraphGitSubProvider } from './providers/graph.js';\nimport { MaintenanceGitSubProvider } from './providers/maintenance.js';\nimport { OperationsGitSubProvider } from './providers/operations.js';\nimport { PatchGitSubProvider } from './providers/patch.js';\nimport { PausedOperationsGitSubProvider } from './providers/pausedOperations.js';\nimport { RefsGitSubProvider } from './providers/refs.js';\nimport { RemotesGitSubProvider } from './providers/remotes.js';\nimport { RevisionGitSubProvider } from './providers/revision.js';\nimport { StagingGitSubProvider } from './providers/staging.js';\nimport { StashGitSubProvider } from './providers/stash.js';\nimport { StatusGitSubProvider } from './providers/status.js';\nimport { TagsGitSubProvider } from './providers/tags.js';\nimport { WorktreesGitSubProvider } from './providers/worktrees.js';\n\nexport interface CliGitProviderOptions {\n\t/** Use an existing Cache instance, or one will be created */\n\tcache?: Cache;\n\t/** Context providing config and event bus hooks */\n\tcontext: GitServiceContext;\n\t/** Function that resolves the git binary location (path + version) */\n\tlocator: () => Promise<GitLocation>;\n\t/** Pre-built Git executor — when provided, used instead of creating a new Git from locator/options */\n\tgit?: Git;\n\t/** Git execution options (timeout, trust, queue config, hooks, etc.) */\n\tgitOptions?: GitOptions;\n\t/**\n\t * Whether repositories reached through this provider are on the LOCAL filesystem. `false` disables the\n\t * maintenance sub-provider entirely (Live Share): its probes stat local paths, and its writes are\n\t * rejected by the host's command allowlist, so inheriting it yields empty reports and swallowed\n\t * failures rather than an honest \"unsupported here\". Defaults to `true`.\n\t */\n\tlocalRepositories?: boolean;\n}\n\n/**\n * Exposes `isTrackedWithDetails` as a callable method for sub-providers.\n * The class declares it as a regular method, but TypeScript's structural\n * typing makes it inaccessible through the class type alone when consumed\n * internally — this type re-maps it to ensure sub-providers can call it.\n */\nexport type CliGitProviderInternal = Omit<CliGitProvider, 'isTrackedWithDetails'> & {\n\tisTrackedWithDetails: CliGitProvider['isTrackedWithDetails'];\n};\n\n/**\n * A fully-wired CLI-based git provider that executes git commands via `child_process`.\n * Implements both `CliGitProviderInternal` (for internal sub-provider wiring)\n * and `GitProvider` (for registration in a provider registry).\n *\n * @example\n * ```typescript\n * const provider = new CliGitProvider({\n *   context: { events: myEvents },\n *   locator: () => findGitPath(null),\n *   gitOptions: { gitTimeout: 30000 },\n * });\n *\n * const branches = await provider.branches.getBranches(repoPath);\n * const status = await provider.status.getStatus(repoPath);\n * ```\n */\nexport class CliGitProvider implements GitProvider {\n\treadonly descriptor: GitProviderDescriptor = { id: 'git', name: 'Git', virtual: false };\n\n\tprivate readonly _cache: Cache;\n\tprivate readonly _cacheOwned: boolean;\n\tprivate readonly _git: Git;\n\n\treadonly context: GitServiceContext;\n\tprivate readonly _localRepositories: boolean;\n\n\tconstructor(options: CliGitProviderOptions) {\n\t\tthis.context = options.context;\n\t\tthis._localRepositories = options.localRepositories ?? true;\n\t\tthis._git =\n\t\t\toptions.git ??\n\t\t\tnew Git(options.locator, {\n\t\t\t\t...options.gitOptions,\n\t\t\t\tisTrusted:\n\t\t\t\t\toptions.context.workspace?.isTrusted != null\n\t\t\t\t\t\t? () => options.context.workspace!.isTrusted!\n\t\t\t\t\t\t: undefined,\n\t\t\t});\n\t\tthis._cacheOwned = !(options.cache instanceof Cache);\n\t\tthis._cache = options.cache instanceof Cache ? options.cache : new Cache();\n\t}\n\n\t/** The underlying cache instance (for repo path registration, etc.) */\n\tget cache(): Cache {\n\t\treturn this._cache;\n\t}\n\n\t/** The underlying git execution instance (for sub-providers that need direct exec/stream access) */\n\tget git(): Git {\n\t\treturn this._git;\n\t}\n\n\t/** Returns whether the installed git version supports the given feature. */\n\tsupports(feature: GitFeatures): boolean | Promise<boolean> {\n\t\treturn this._git.supports(feature);\n\t}\n\n\t/** Returns all features matching the prefix that the installed git version supports. */\n\tsupported<T extends GitFeatureOrPrefix>(feature: T): FilteredGitFeatures<T>[] | Promise<FilteredGitFeatures<T>[]> {\n\t\treturn this._git.supported(feature);\n\t}\n\n\t/** Throws if the installed git version does not support the given feature. */\n\tasync ensureSupports(feature: GitFeatures, prefix: string, suffix: string): Promise<void>;\n\tasync ensureSupports(feature: GitFeatures, message: GitFeatureUnsupportedMessage): Promise<void>;\n\tasync ensureSupports(\n\t\tfeature: GitFeatures,\n\t\tprefixOrMessage: string | GitFeatureUnsupportedMessage,\n\t\tsuffix?: string,\n\t): Promise<void> {\n\t\treturn typeof prefixOrMessage === 'function'\n\t\t\t? this._git.ensureSupports(feature, prefixOrMessage)\n\t\t\t: this._git.ensureSupports(feature, prefixOrMessage, suffix!);\n\t}\n\n\t/** Returns the installed git version string. */\n\tasync version(): Promise<string> {\n\t\treturn this._git.version();\n\t}\n\n\t/** Returns the resolved git binary path. */\n\tasync path(): Promise<string> {\n\t\treturn this._git.path();\n\t}\n\n\tasync clone(url: string, parentPath: string): Promise<string | undefined> {\n\t\tlet count = 0;\n\t\tconst [, , remotePath] = parseGitRemoteUrl(url);\n\t\tconst remoteName = remotePath.split('/').pop();\n\t\tif (!remoteName) return undefined;\n\n\t\tlet folderPath = joinPaths(parentPath, remoteName);\n\t\twhile ((await fsExists(folderPath)) && count < 20) {\n\t\t\tcount++;\n\t\t\tfolderPath = joinPaths(parentPath, `${remoteName}-${count}`);\n\t\t}\n\n\t\tawait this._git.run({ cwd: parentPath }, 'clone', url, folderPath);\n\n\t\treturn folderPath;\n\t}\n\n\tprivate _blame: BlameGitSubProvider | undefined;\n\tget blame(): BlameGitSubProvider {\n\t\treturn (this._blame ??= new BlameGitSubProvider(\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _branches: BranchesGitSubProvider | undefined;\n\tget branches(): BranchesGitSubProvider {\n\t\treturn (this._branches ??= new BranchesGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _commits: CommitsGitSubProvider | undefined;\n\tget commits(): CommitsGitSubProvider {\n\t\treturn (this._commits ??= new CommitsGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _config: ConfigGitSubProvider | undefined;\n\tget config(): ConfigGitSubProvider {\n\t\treturn (this._config ??= new ConfigGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _contributors: ContributorsGitSubProvider | undefined;\n\tget contributors(): ContributorsGitSubProvider {\n\t\treturn (this._contributors ??= new ContributorsGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _diff: DiffGitSubProvider | undefined;\n\tget diff(): DiffGitSubProvider {\n\t\treturn (this._diff ??= new DiffGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _graph: GraphGitSubProvider | undefined;\n\tget graph(): GraphGitSubProvider {\n\t\treturn (this._graph ??= new GraphGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _maintenance: MaintenanceGitSubProvider | undefined;\n\t// Optional so subclasses whose repos aren't local can report the capability as absent — see\n\t// `VslsGitProvider`. Consumers already treat `maintenance == null` as \"unsupported here\" (web builds\n\t// never register it at all).\n\tget maintenance(): MaintenanceGitSubProvider | undefined {\n\t\tif (!this._localRepositories) return undefined;\n\n\t\treturn (this._maintenance ??= new MaintenanceGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _ops: OperationsGitSubProvider | undefined;\n\tget ops(): OperationsGitSubProvider {\n\t\treturn (this._ops ??= new OperationsGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _patch: PatchGitSubProvider | undefined;\n\tget patch(): PatchGitSubProvider {\n\t\treturn (this._patch ??= new PatchGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _pausedOps: PausedOperationsGitSubProvider | undefined;\n\tget pausedOps(): PausedOperationsGitSubProvider {\n\t\treturn (this._pausedOps ??= new PausedOperationsGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _refs: RefsGitSubProvider | undefined;\n\tget refs(): RefsGitSubProvider {\n\t\treturn (this._refs ??= new RefsGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _remotes: RemotesGitSubProvider | undefined;\n\tget remotes(): RemotesGitSubProvider {\n\t\treturn (this._remotes ??= new RemotesGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _revision: RevisionGitSubProvider | undefined;\n\tget revision(): RevisionGitSubProvider {\n\t\treturn (this._revision ??= new RevisionGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _staging: StagingGitSubProvider | undefined;\n\tget staging(): StagingGitSubProvider {\n\t\treturn (this._staging ??= new StagingGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _stash: StashGitSubProvider | undefined;\n\tget stash(): StashGitSubProvider {\n\t\treturn (this._stash ??= new StashGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _status: StatusGitSubProvider | undefined;\n\tget status(): StatusGitSubProvider {\n\t\treturn (this._status ??= new StatusGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _tags: TagsGitSubProvider | undefined;\n\tget tags(): TagsGitSubProvider {\n\t\treturn (this._tags ??= new TagsGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _worktrees: WorktreesGitSubProvider | undefined;\n\tget worktrees(): WorktreesGitSubProvider {\n\t\treturn (this._worktrees ??= new WorktreesGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tgetAbsoluteUri(pathOrUri: string | Uri, base: string | Uri): Uri {\n\t\tconst baseUri = typeof base !== 'string' ? base : fileUri(base);\n\t\tif (typeof pathOrUri !== 'string') return pathOrUri;\n\t\tif (maybeUri(pathOrUri)) return parseUri(pathOrUri);\n\t\tif (path.isAbsolute(pathOrUri)) return fileUri(pathOrUri);\n\t\treturn joinUriPath(baseUri, pathOrUri);\n\t}\n\n\tgetRelativePath(pathOrUri: string | Uri, base: string | Uri): string {\n\t\tconst [relativePath] = splitPath(toFsPath(pathOrUri), toFsPath(base));\n\t\treturn relativePath;\n\t}\n\n\tasync excludeIgnoredUris(repoPath: string, uris: Uri[]): Promise<Uri[]> {\n\t\tconst filter = this.getIgnoreFilter(repoPath);\n\t\tawait filter.ready();\n\t\treturn uris.filter(uri => {\n\t\t\tconst relativePath = normalizePath(path.relative(repoPath, toFsPath(uri)));\n\t\t\treturn !relativePath || !filter.isIgnored(relativePath);\n\t\t});\n\t}\n\n\tasync getIgnoredUrisFilter(repoPath: string): Promise<(uri: Uri) => boolean> {\n\t\tconst filter = this.getIgnoreFilter(repoPath);\n\t\tawait filter.ready();\n\t\treturn (uri: Uri) => {\n\t\t\tconst relativePath = normalizePath(path.relative(repoPath, toFsPath(uri)));\n\t\t\treturn relativePath ? filter.isIgnored(relativePath) : false;\n\t\t};\n\t}\n\n\tasync getLastFetchedTimestamp(repoPath: string): Promise<number | undefined> {\n\t\treturn this._cache.getLastFetchedTimestamp(repoPath, async (commonPath): Promise<number | undefined> => {\n\t\t\tconst gitDir = await this.config.getGitDir?.(commonPath);\n\t\t\tif (gitDir == null) return undefined;\n\n\t\t\tconst gitDirUri = gitDir.commonUri ?? gitDir.uri;\n\t\t\tconst fetchHeadUri = joinUriPath(gitDirUri, 'FETCH_HEAD');\n\t\t\tconst stats = await this.context.fs.stat(fetchHeadUri);\n\t\t\t// If the file is empty, assume the fetch failed, and don't update the timestamp\n\t\t\tif (stats != null && stats.size > 0) return stats.mtime;\n\n\t\t\treturn undefined;\n\t\t});\n\t}\n\n\tgetIgnoreFilter(repoPath: string): GitIgnoreFilter {\n\t\tlet filter = this._cache.gitIgnore.get(repoPath);\n\t\tif (filter == null) {\n\t\t\tconst gitDir = this._cache.gitDir.get(repoPath);\n\t\t\tconst gitDirPath = gitDir?.uri.fsPath ?? `${repoPath}/.git`;\n\t\t\tfilter = new GitIgnoreFilter({\n\t\t\t\trepoPath: repoPath,\n\t\t\t\tgitDirPath: gitDirPath,\n\t\t\t\tfs: this.context.fs,\n\t\t\t\tgetGlobalExcludesPath:\n\t\t\t\t\tthis.config.getConfig != null\n\t\t\t\t\t\t? async () => this.config.getConfig(repoPath, 'core.excludesFile')\n\t\t\t\t\t\t: undefined,\n\t\t\t});\n\t\t\tthis._cache.gitIgnore.set(repoPath, filter);\n\t\t}\n\t\treturn filter;\n\t}\n\n\tprivate async isTrackedWithDetails(\n\t\tfilePath: string,\n\t\trepoPath: string,\n\t\trev?: string,\n\t): Promise<{ path: string; status?: GitFileStatus; originalPath?: string } | undefined> {\n\t\tif (rev === deletedOrMissing) return undefined;\n\n\t\tconst scope = getScopedLogger();\n\n\t\ttry {\n\t\t\tconst [relativePath, root] = splitPath(filePath, repoPath);\n\n\t\t\t// Check if the file exists in the working tree first (better cache reuse)\n\t\t\tlet tracked = await this.revision.exists(root, relativePath);\n\t\t\tif (tracked) return { path: relativePath };\n\n\t\t\t// If a specific revision was provided, check there too\n\t\t\tif (rev && !isUncommitted(rev)) {\n\t\t\t\ttracked = await this.revision.exists(root, relativePath, rev);\n\t\t\t\tif (!tracked) {\n\t\t\t\t\t// Check the parent revision (file might have been deleted in this rev)\n\t\t\t\t\ttracked = await this.revision.exists(root, relativePath, `${rev}^`);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn tracked ? { path: relativePath } : undefined;\n\t\t} catch (ex) {\n\t\t\tscope?.error(ex);\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tdispose(): void {\n\t\tthis._git.dispose();\n\t\tif (this._cacheOwned) {\n\t\t\tthis._cache.dispose();\n\t\t}\n\t}\n}\n"],"mappings":"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"}
+{"version":3,"file":"cliGitProvider.js","names":["fs"],"sources":["../../../git-cli/src/cliGitProvider.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport * as path from 'node:path';\nimport type { CachedGitTypes } from '@gitlens/git/cache.js';\nimport { Cache } from '@gitlens/git/cache.js';\nimport type { GitServiceContext } from '@gitlens/git/context.js';\nimport type { GitFileStatus } from '@gitlens/git/models/fileStatus.js';\nimport type { RepositoryChange } from '@gitlens/git/models/repository.js';\nimport { deletedOrMissing } from '@gitlens/git/models/revision.js';\nimport type { GitProvider, GitProviderDescriptor } from '@gitlens/git/providers/provider.js';\nimport { parseGitRemoteUrl } from '@gitlens/git/utils/remote.utils.js';\nimport { isUncommitted } from '@gitlens/git/utils/revision.utils.js';\nimport { GitIgnoreFilter } from '@gitlens/git/watching/gitIgnoreFilter.js';\nimport { getScopedLogger } from '@gitlens/utils/logger.scoped.js';\nimport { joinPaths, maybeUri, normalizePath, splitPath } from '@gitlens/utils/path.js';\nimport type { Uri } from '@gitlens/utils/uri.js';\nimport { fileUri, joinUriPath, parseUri, toFsPath } from '@gitlens/utils/uri.js';\nimport { fsExists } from './exec/exec.js';\nimport type { FilteredGitFeatures, GitFeatureOrPrefix, GitFeatures } from './exec/features.js';\nimport type { GitFeatureUnsupportedMessage, GitOptions } from './exec/git.js';\nimport { Git } from './exec/git.js';\nimport type { GitLocation } from './exec/locator.js';\nimport { BlameGitSubProvider } from './providers/blame.js';\nimport { BranchesGitSubProvider } from './providers/branches.js';\nimport { CommitsGitSubProvider } from './providers/commits.js';\nimport { ConfigGitSubProvider } from './providers/config.js';\nimport { ContributorsGitSubProvider } from './providers/contributors.js';\nimport { DiffGitSubProvider } from './providers/diff.js';\nimport { GraphGitSubProvider } from './providers/graph.js';\nimport { MaintenanceGitSubProvider } from './providers/maintenance.js';\nimport { OperationsGitSubProvider } from './providers/operations.js';\nimport { PatchGitSubProvider } from './providers/patch.js';\nimport { PausedOperationsGitSubProvider } from './providers/pausedOperations.js';\nimport { RefsGitSubProvider } from './providers/refs.js';\nimport { RemotesGitSubProvider } from './providers/remotes.js';\nimport { RevisionGitSubProvider } from './providers/revision.js';\nimport { StagingGitSubProvider } from './providers/staging.js';\nimport { StashGitSubProvider } from './providers/stash.js';\nimport { StatusGitSubProvider } from './providers/status.js';\nimport { TagsGitSubProvider } from './providers/tags.js';\nimport { WorktreesGitSubProvider } from './providers/worktrees.js';\n\nexport interface CliGitProviderOptions {\n\t/** Use an existing Cache instance, or one will be created */\n\tcache?: Cache;\n\t/** Context providing config and event bus hooks */\n\tcontext: GitServiceContext;\n\t/** Function that resolves the git binary location (path + version) */\n\tlocator: () => Promise<GitLocation>;\n\t/** Pre-built Git executor — when provided, used instead of creating a new Git from locator/options */\n\tgit?: Git;\n\t/** Git execution options (timeout, trust, queue config, hooks, etc.) */\n\tgitOptions?: GitOptions;\n\t/**\n\t * Whether repositories reached through this provider are on the LOCAL filesystem. `false` disables the\n\t * maintenance sub-provider entirely (Live Share): its probes stat local paths, and its writes are\n\t * rejected by the host's command allowlist, so inheriting it yields empty reports and swallowed\n\t * failures rather than an honest \"unsupported here\". Defaults to `true`.\n\t */\n\tlocalRepositories?: boolean;\n}\n\n/**\n * Exposes `isTrackedWithDetails` as a callable method for sub-providers.\n * The class declares it as a regular method, but TypeScript's structural\n * typing makes it inaccessible through the class type alone when consumed\n * internally — this type re-maps it to ensure sub-providers can call it.\n */\nexport type CliGitProviderInternal = Omit<CliGitProvider, 'isTrackedWithDetails'> & {\n\tisTrackedWithDetails: CliGitProvider['isTrackedWithDetails'];\n};\n\n/**\n * A fully-wired CLI-based git provider that executes git commands via `child_process`.\n * Implements both `CliGitProviderInternal` (for internal sub-provider wiring)\n * and `GitProvider` (for registration in a provider registry).\n *\n * @example\n * ```typescript\n * const provider = new CliGitProvider({\n *   context: { events: myEvents },\n *   locator: () => findGitPath(null),\n *   gitOptions: { gitTimeout: 30000 },\n * });\n *\n * const branches = await provider.branches.getBranches(repoPath);\n * const status = await provider.status.getStatus(repoPath);\n * ```\n */\nexport class CliGitProvider implements GitProvider {\n\treadonly descriptor: GitProviderDescriptor = { id: 'git', name: 'Git', virtual: false };\n\n\tprivate readonly _cache: Cache;\n\tprivate readonly _cacheOwned: boolean;\n\tprivate readonly _git: Git;\n\n\treadonly context: GitServiceContext;\n\tprivate readonly _localRepositories: boolean;\n\n\tconstructor(options: CliGitProviderOptions) {\n\t\t// Every typed write announces itself through `onReset`, so the provider clears its own state there\n\t\t// rather than trusting each host to: a host with no handler still reads fresh after a write. A write\n\t\t// hard-evicts, so a caller after it never joins a read that started before it; watcher-driven clears\n\t\t// reach `Cache.clearCaches` directly and keep sharing in-flight reads.\n\t\tconst hostHooks = options.context.hooks;\n\t\tthis.context = {\n\t\t\t...options.context,\n\t\t\thooks: {\n\t\t\t\t...hostHooks,\n\t\t\t\tcache: {\n\t\t\t\t\t...hostHooks?.cache,\n\t\t\t\t\tonReset: (repoPath, ...types) => {\n\t\t\t\t\t\tthis._cache.evictCaches(repoPath, ...types);\n\t\t\t\t\t\tthis._git.clearPendingCommands();\n\t\t\t\t\t\thostHooks?.cache?.onReset?.(repoPath, ...types);\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t};\n\t\tthis._localRepositories = options.localRepositories ?? true;\n\t\tthis._git =\n\t\t\toptions.git ??\n\t\t\tnew Git(options.locator, {\n\t\t\t\t...options.gitOptions,\n\t\t\t\tisTrusted:\n\t\t\t\t\toptions.context.workspace?.isTrusted != null\n\t\t\t\t\t\t? () => options.context.workspace!.isTrusted!\n\t\t\t\t\t\t: undefined,\n\t\t\t});\n\t\tthis._cacheOwned = !(options.cache instanceof Cache);\n\t\tthis._cache = options.cache instanceof Cache ? options.cache : new Cache();\n\t}\n\n\t/** The underlying cache instance (for repo path registration, etc.) */\n\tget cache(): Cache {\n\t\treturn this._cache;\n\t}\n\n\t/** The underlying git execution instance (for sub-providers that need direct exec/stream access) */\n\tget git(): Git {\n\t\treturn this._git;\n\t}\n\n\t/** Returns whether the installed git version supports the given feature. */\n\tsupports(feature: GitFeatures): boolean | Promise<boolean> {\n\t\treturn this._git.supports(feature);\n\t}\n\n\t/** Returns all features matching the prefix that the installed git version supports. */\n\tsupported<T extends GitFeatureOrPrefix>(feature: T): FilteredGitFeatures<T>[] | Promise<FilteredGitFeatures<T>[]> {\n\t\treturn this._git.supported(feature);\n\t}\n\n\t/** Throws if the installed git version does not support the given feature. */\n\tasync ensureSupports(feature: GitFeatures, prefix: string, suffix: string): Promise<void>;\n\tasync ensureSupports(feature: GitFeatures, message: GitFeatureUnsupportedMessage): Promise<void>;\n\tasync ensureSupports(\n\t\tfeature: GitFeatures,\n\t\tprefixOrMessage: string | GitFeatureUnsupportedMessage,\n\t\tsuffix?: string,\n\t): Promise<void> {\n\t\treturn typeof prefixOrMessage === 'function'\n\t\t\t? this._git.ensureSupports(feature, prefixOrMessage)\n\t\t\t: this._git.ensureSupports(feature, prefixOrMessage, suffix!);\n\t}\n\n\t/** Returns the installed git version string. */\n\tasync version(): Promise<string> {\n\t\treturn this._git.version();\n\t}\n\n\t/** Returns the resolved git binary path. */\n\tasync path(): Promise<string> {\n\t\treturn this._git.path();\n\t}\n\n\tasync clone(url: string, parentPath: string): Promise<string | undefined> {\n\t\tlet count = 0;\n\t\tconst [, , remotePath] = parseGitRemoteUrl(url);\n\t\tconst remoteName = remotePath.split('/').pop();\n\t\tif (!remoteName) return undefined;\n\n\t\tlet folderPath = joinPaths(parentPath, remoteName);\n\t\twhile ((await fsExists(folderPath)) && count < 20) {\n\t\t\tcount++;\n\t\t\tfolderPath = joinPaths(parentPath, `${remoteName}-${count}`);\n\t\t}\n\n\t\tawait this._git.run({ cwd: parentPath }, 'clone', url, folderPath);\n\n\t\treturn folderPath;\n\t}\n\n\t/** Creates a new repository at `targetPath` (`git init`), creating it first if it doesn't yet exist. */\n\tasync init(targetPath: string, options?: { defaultBranch?: string; bare?: boolean }): Promise<void> {\n\t\tawait fs.mkdir(targetPath, { recursive: true });\n\n\t\tconst args = ['init'];\n\t\tif (options?.defaultBranch) {\n\t\t\targs.push('-b', options.defaultBranch);\n\t\t}\n\t\tif (options?.bare) {\n\t\t\targs.push('--bare');\n\t\t}\n\n\t\t// Run inside the target rather than naming it from its parent: a relative `targetPath` would otherwise\n\t\t// be resolved against the parent a second time\n\t\tawait this._git.run({ cwd: targetPath }, ...args);\n\t}\n\n\t/**\n\t * Notifies the provider that `repoPath` was mutated outside of a typed sub-provider method — e.g. a\n\t * consumer that ran a command through the raw `git.run`/`provider.git.run` escape hatch. Fires the same\n\t * `cache.onReset`/`repository.onChanged` hooks a typed mutator would, so, exactly as after a typed write,\n\t * the provider clears its own caches for `repoPath` (every type, or just `options.cache` when given) and\n\t * its pending commands before the host's handlers run.\n\t */\n\tnotifyChanged(\n\t\trepoPath: string,\n\t\tchanges: readonly RepositoryChange[],\n\t\toptions?: { cache?: readonly CachedGitTypes[] | 'all' },\n\t): void {\n\t\tconst types = options?.cache;\n\t\tif (types == null || types === 'all') {\n\t\t\t// No types = everything, for the provider's own clear and the host's handler alike.\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath);\n\t\t} else if (types.length) {\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, ...types);\n\t\t}\n\n\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, [...changes]);\n\t}\n\n\tprivate _blame: BlameGitSubProvider | undefined;\n\tget blame(): BlameGitSubProvider {\n\t\treturn (this._blame ??= new BlameGitSubProvider(\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _branches: BranchesGitSubProvider | undefined;\n\tget branches(): BranchesGitSubProvider {\n\t\treturn (this._branches ??= new BranchesGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _commits: CommitsGitSubProvider | undefined;\n\tget commits(): CommitsGitSubProvider {\n\t\treturn (this._commits ??= new CommitsGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _config: ConfigGitSubProvider | undefined;\n\tget config(): ConfigGitSubProvider {\n\t\treturn (this._config ??= new ConfigGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _contributors: ContributorsGitSubProvider | undefined;\n\tget contributors(): ContributorsGitSubProvider {\n\t\treturn (this._contributors ??= new ContributorsGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _diff: DiffGitSubProvider | undefined;\n\tget diff(): DiffGitSubProvider {\n\t\treturn (this._diff ??= new DiffGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _graph: GraphGitSubProvider | undefined;\n\tget graph(): GraphGitSubProvider {\n\t\treturn (this._graph ??= new GraphGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _maintenance: MaintenanceGitSubProvider | undefined;\n\t// Optional so subclasses whose repos aren't local can report the capability as absent — see\n\t// `VslsGitProvider`. Consumers already treat `maintenance == null` as \"unsupported here\" (web builds\n\t// never register it at all).\n\tget maintenance(): MaintenanceGitSubProvider | undefined {\n\t\tif (!this._localRepositories) return undefined;\n\n\t\treturn (this._maintenance ??= new MaintenanceGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _ops: OperationsGitSubProvider | undefined;\n\tget ops(): OperationsGitSubProvider {\n\t\treturn (this._ops ??= new OperationsGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _patch: PatchGitSubProvider | undefined;\n\tget patch(): PatchGitSubProvider {\n\t\treturn (this._patch ??= new PatchGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _pausedOps: PausedOperationsGitSubProvider | undefined;\n\tget pausedOps(): PausedOperationsGitSubProvider {\n\t\treturn (this._pausedOps ??= new PausedOperationsGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _refs: RefsGitSubProvider | undefined;\n\tget refs(): RefsGitSubProvider {\n\t\treturn (this._refs ??= new RefsGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _remotes: RemotesGitSubProvider | undefined;\n\tget remotes(): RemotesGitSubProvider {\n\t\treturn (this._remotes ??= new RemotesGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _revision: RevisionGitSubProvider | undefined;\n\tget revision(): RevisionGitSubProvider {\n\t\treturn (this._revision ??= new RevisionGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _staging: StagingGitSubProvider | undefined;\n\tget staging(): StagingGitSubProvider {\n\t\treturn (this._staging ??= new StagingGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _stash: StashGitSubProvider | undefined;\n\tget stash(): StashGitSubProvider {\n\t\treturn (this._stash ??= new StashGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _status: StatusGitSubProvider | undefined;\n\tget status(): StatusGitSubProvider {\n\t\treturn (this._status ??= new StatusGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _tags: TagsGitSubProvider | undefined;\n\tget tags(): TagsGitSubProvider {\n\t\treturn (this._tags ??= new TagsGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tprivate _worktrees: WorktreesGitSubProvider | undefined;\n\tget worktrees(): WorktreesGitSubProvider {\n\t\treturn (this._worktrees ??= new WorktreesGitSubProvider(\n\t\t\tthis.context,\n\t\t\tthis._git,\n\t\t\tthis._cache,\n\t\t\tthis as unknown as CliGitProviderInternal,\n\t\t));\n\t}\n\n\tgetAbsoluteUri(pathOrUri: string | Uri, base: string | Uri): Uri {\n\t\tconst baseUri = typeof base !== 'string' ? base : fileUri(base);\n\t\tif (typeof pathOrUri !== 'string') return pathOrUri;\n\t\tif (maybeUri(pathOrUri)) return parseUri(pathOrUri);\n\t\tif (path.isAbsolute(pathOrUri)) return fileUri(pathOrUri);\n\t\treturn joinUriPath(baseUri, pathOrUri);\n\t}\n\n\tgetRelativePath(pathOrUri: string | Uri, base: string | Uri): string {\n\t\tconst [relativePath] = splitPath(toFsPath(pathOrUri), toFsPath(base));\n\t\treturn relativePath;\n\t}\n\n\tasync excludeIgnoredUris(repoPath: string, uris: Uri[]): Promise<Uri[]> {\n\t\tconst filter = this.getIgnoreFilter(repoPath);\n\t\tawait filter.ready();\n\t\treturn uris.filter(uri => {\n\t\t\tconst relativePath = normalizePath(path.relative(repoPath, toFsPath(uri)));\n\t\t\treturn !relativePath || !filter.isIgnored(relativePath);\n\t\t});\n\t}\n\n\tasync getIgnoredUrisFilter(repoPath: string): Promise<(uri: Uri) => boolean> {\n\t\tconst filter = this.getIgnoreFilter(repoPath);\n\t\tawait filter.ready();\n\t\treturn (uri: Uri) => {\n\t\t\tconst relativePath = normalizePath(path.relative(repoPath, toFsPath(uri)));\n\t\t\treturn relativePath ? filter.isIgnored(relativePath) : false;\n\t\t};\n\t}\n\n\tasync getLastFetchedTimestamp(repoPath: string): Promise<number | undefined> {\n\t\treturn this._cache.getLastFetchedTimestamp(repoPath, async (commonPath): Promise<number | undefined> => {\n\t\t\tconst gitDir = await this.config.getGitDir?.(commonPath);\n\t\t\tif (gitDir == null) return undefined;\n\n\t\t\tconst gitDirUri = gitDir.commonUri ?? gitDir.uri;\n\t\t\tconst fetchHeadUri = joinUriPath(gitDirUri, 'FETCH_HEAD');\n\t\t\tconst stats = await this.context.fs.stat(fetchHeadUri);\n\t\t\t// If the file is empty, assume the fetch failed, and don't update the timestamp\n\t\t\tif (stats != null && stats.size > 0) return stats.mtime;\n\n\t\t\treturn undefined;\n\t\t});\n\t}\n\n\tgetIgnoreFilter(repoPath: string): GitIgnoreFilter {\n\t\tlet filter = this._cache.gitIgnore.get(repoPath);\n\t\tif (filter == null) {\n\t\t\tconst gitDir = this._cache.gitDir.get(repoPath);\n\t\t\tconst gitDirPath = gitDir?.uri.fsPath ?? `${repoPath}/.git`;\n\t\t\tfilter = new GitIgnoreFilter({\n\t\t\t\trepoPath: repoPath,\n\t\t\t\tgitDirPath: gitDirPath,\n\t\t\t\tfs: this.context.fs,\n\t\t\t\tgetGlobalExcludesPath:\n\t\t\t\t\tthis.config.getConfig != null\n\t\t\t\t\t\t? async () => this.config.getConfig(repoPath, 'core.excludesFile')\n\t\t\t\t\t\t: undefined,\n\t\t\t});\n\t\t\tthis._cache.gitIgnore.set(repoPath, filter);\n\t\t}\n\t\treturn filter;\n\t}\n\n\tprivate async isTrackedWithDetails(\n\t\tfilePath: string,\n\t\trepoPath: string,\n\t\trev?: string,\n\t): Promise<{ path: string; status?: GitFileStatus; originalPath?: string } | undefined> {\n\t\tif (rev === deletedOrMissing) return undefined;\n\n\t\tconst scope = getScopedLogger();\n\n\t\ttry {\n\t\t\tconst [relativePath, root] = splitPath(filePath, repoPath);\n\n\t\t\t// Check if the file exists in the working tree first (better cache reuse)\n\t\t\tlet tracked = await this.revision.exists(root, relativePath);\n\t\t\tif (tracked) return { path: relativePath };\n\n\t\t\t// If a specific revision was provided, check there too\n\t\t\tif (rev && !isUncommitted(rev)) {\n\t\t\t\ttracked = await this.revision.exists(root, relativePath, rev);\n\t\t\t\tif (!tracked) {\n\t\t\t\t\t// Check the parent revision (file might have been deleted in this rev)\n\t\t\t\t\ttracked = await this.revision.exists(root, relativePath, `${rev}^`);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn tracked ? { path: relativePath } : undefined;\n\t\t} catch (ex) {\n\t\t\tscope?.error(ex);\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tdispose(): void {\n\t\tthis._git.dispose();\n\t\tif (this._cacheOwned) {\n\t\t\tthis._cache.dispose();\n\t\t}\n\t}\n}\n"],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-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 { BranchErrorReason, CheckoutErrorReason, CherryPickErrorReason, CommitErrorReason, FetchErrorReason, GitCommandError, GitSearchErrorReason, GitWarningKey, GitWarnings, MergeErrorReason, PausedOperationAbortErrorReason, PausedOperationContinueErrorReason, PullErrorReason, PushErrorReason, RebaseErrorReason, ReferenceUpdateErrorReason, 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";
@@ -51,7 +51,9 @@ export declare const GitErrors: {
   readonly noRemoteReference: RegExp;
   readonly noRemoteRepositorySpecified: RegExp;
   readonly noUpstream: RegExp;
+  readonly noTrackingInformation: RegExp;
   readonly notAValidObjectName: RegExp;
+  readonly notPossibleToFastForward: RegExp;
   readonly notAWorkingTree: RegExp;
   readonly noUserNameConfigured: RegExp;
   readonly nothingToCommit: RegExp;
@@ -67,7 +69,13 @@ export declare const GitErrors: {
   readonly rebaseMultipleBranches: RegExp;
   readonly revertAborted: RegExp;
   readonly revertInProgress: RegExp;
+  readonly refAlreadyExists: RegExp;
+  readonly refBadName: RegExp;
   readonly refLocked: RegExp;
+  readonly refNonexistentObject: RegExp;
+  readonly refNotAValidSha: RegExp;
+  readonly refUnableToResolve: RegExp;
+  readonly refValueMismatch: RegExp;
   readonly remoteAhead: RegExp;
   readonly remoteConnectionFailed: RegExp;
   readonly remoteRejected: RegExp;
@@ -103,7 +111,7 @@ export type PushForceOptions = {
   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 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' | 'update-ref' | 'update-ref-delete' | 'worktree-create' | 'worktree-delete';
 type GitCommandToReasonMap = {
   branch: BranchErrorReason;
   checkout: CheckoutErrorReason;
@@ -122,6 +130,8 @@ type GitCommandToReasonMap = {
   'stash-apply': StashApplyErrorReason;
   'stash-push': StashPushErrorReason;
   tag: TagErrorReason;
+  'update-ref': ReferenceUpdateErrorReason;
+  'update-ref-delete': ReferenceUpdateErrorReason;
   'worktree-create': WorktreeCreateErrorReason;
   'worktree-delete': WorktreeDeleteErrorReason;
 };