@gitkraken/core-gitlens 0.7.2 → 0.9.0

package/dist/git/features.d.ts

@@ -1,5 +1,5 @@
 //#region ../git/src/features.d.ts
-export type GitFeatures = 'git:checkout:pathspec-from-file' | 'git:commit-graph' | 'git:commit-graph:changed-paths' | 'git:for-each-ref:worktreePath' | 'git:fsmonitor' | 'git:fsmonitor:linux' | 'git:ignoreRevsFile' | 'git:index:skipHash' | 'git:maintenance' | 'git:maintenance:pack-refs' | 'git:maintenance:start' | 'git:maintenance:start:systemd' | 'git:manyFiles' | 'git:merge-tree:merge-base' | 'git:merge-tree:write-tree' | 'git:push:force-if-includes' | 'git:rebase:autosquash' | 'git:rev-parse:end-of-options' | 'git:signing:ssh' | 'git:signing:x509' | 'git:sparse-index' | 'git:stash:push:pathspecs' | 'git:stash:push:staged' | 'git:stash:push:stdin' | 'git:status:find-renames' | 'git:status:porcelain-v2' | 'git:untrackedCache' | 'git:worktrees';
+export type GitFeatures = 'git:checkout:pathspec-from-file' | 'git:commit-graph' | 'git:commit-graph:changed-paths' | 'git:fetch:no-write-fetch-head' | 'git:for-each-ref:worktreePath' | 'git:fsmonitor' | 'git:fsmonitor:linux' | 'git:ignoreRevsFile' | 'git:index:skipHash' | 'git:maintenance' | 'git:maintenance:pack-refs' | 'git:maintenance:start' | 'git:maintenance:start:systemd' | 'git:manyFiles' | 'git:merge-tree:merge-base' | 'git:merge-tree:write-tree' | 'git:push:force-if-includes' | 'git:rebase:autosquash' | 'git:rev-parse:end-of-options' | 'git:signing:ssh' | 'git:signing:x509' | 'git:sparse-index' | 'git:stash:push:pathspecs' | 'git:stash:push:staged' | 'git:stash:push:stdin' | 'git:status:find-renames' | 'git:status:porcelain-v2' | 'git:untrackedCache' | 'git:worktrees';
 type ExtractPrefix<T> = T extends `${infer Prefix}:${infer Rest}` ? Rest extends `${infer SubPrefix}:${string}` ? T | `${Prefix}:${SubPrefix}` | Prefix : T | Prefix : never;
 export type GitFeatureOrPrefix = ExtractPrefix<GitFeatures>;
 export type FilteredGitFeatures<T extends GitFeatureOrPrefix> = T extends GitFeatures ? T : Extract<GitFeatures, T | `${T}:${string}`>;

package/dist/git/features.js

@@ -4,6 +4,7 @@ const gitFeaturesByVersion = /* @__PURE__ */ new Map([
 	["git:checkout:pathspec-from-file", "2.26"],
 	["git:commit-graph", "2.24"],
 	["git:commit-graph:changed-paths", "2.31"],
+	["git:fetch:no-write-fetch-head", "2.29"],
 	["git:for-each-ref:worktreePath", "2.23"],
 	["git:fsmonitor", "2.37"],
 	["git:fsmonitor:linux", "2.55"],

package/dist/git/features.js.map

@@ -1 +1 @@
-{"version":3,"file":"features.js","names":[],"sources":["../../../git/src/features.ts"],"sourcesContent":["// GitFeature's must start with `git:` to be recognized in all usages\nexport type GitFeatures =\n\t| 'git:checkout:pathspec-from-file'\n\t| 'git:commit-graph'\n\t| 'git:commit-graph:changed-paths'\n\t| 'git:for-each-ref:worktreePath'\n\t| 'git:fsmonitor'\n\t| 'git:fsmonitor:linux'\n\t| 'git:ignoreRevsFile'\n\t| 'git:index:skipHash'\n\t| 'git:maintenance'\n\t| 'git:maintenance:pack-refs'\n\t| 'git:maintenance:start'\n\t| 'git:maintenance:start:systemd'\n\t| 'git:manyFiles'\n\t| 'git:merge-tree:merge-base'\n\t| 'git:merge-tree:write-tree'\n\t| 'git:push:force-if-includes'\n\t| 'git:rebase:autosquash'\n\t| 'git:rev-parse:end-of-options'\n\t| 'git:signing:ssh'\n\t| 'git:signing:x509'\n\t| 'git:sparse-index'\n\t| 'git:stash:push:pathspecs'\n\t| 'git:stash:push:staged'\n\t| 'git:stash:push:stdin'\n\t| 'git:status:find-renames'\n\t| 'git:status:porcelain-v2'\n\t| 'git:untrackedCache'\n\t| 'git:worktrees';\n\ntype ExtractPrefix<T> = T extends `${infer Prefix}:${infer Rest}`\n\t? Rest extends `${infer SubPrefix}:${string}`\n\t\t? T | `${Prefix}:${SubPrefix}` | Prefix\n\t\t: T | Prefix\n\t: never;\n\nexport type GitFeatureOrPrefix = ExtractPrefix<GitFeatures>;\nexport type FilteredGitFeatures<T extends GitFeatureOrPrefix> = T extends GitFeatures\n\t? T\n\t: Extract<GitFeatures, T | `${T}:${string}`>;\n\nexport const gitMinimumVersion = '2.7.2';\nexport const gitFeaturesByVersion = new Map<GitFeatures, string>([\n\t['git:checkout:pathspec-from-file', '2.26'],\n\t// 2.24 is when git READS the commit-graph file by default (core.commitGraph on); writing it for\n\t// older gits would be dead weight.\n\t['git:commit-graph', '2.24'],\n\t// Changed-path Bloom filters (`--changed-paths`), the v2 filter format — pre-2.31 shipped Bloom filters\n\t// with real correctness bugs (bad results for merge commits), so 2.31 is the safe floor to write them.\n\t['git:commit-graph:changed-paths', '2.31'],\n\t['git:for-each-ref:worktreePath', '2.23'],\n\t// `core.fsmonitor=true` selects the built-in FSMonitor daemon (accepting a bool rather than only a\n\t// hook path). This 2.37 floor is the Windows + macOS one.\n\t['git:fsmonitor', '2.37'],\n\t// Linux got its own FSMonitor backend (inotify) only in 2.55, hence a separate floor. Note the backend\n\t// places a watch on EVERY directory, so a large repo can exhaust `fs.inotify.max_user_watches` and the\n\t// daemon fails at runtime even on a new enough git — the apply path must still probe, not just gate.\n\t['git:fsmonitor:linux', '2.55'],\n\t['git:ignoreRevsFile', '2.23'],\n\t// `index.skipHash` (skip the trailing index checksum for faster writes); part of `feature.manyFiles`.\n\t['git:index:skipHash', '2.40'],\n\t// `git maintenance run --task=…`. The `maintenance` builtin + `commit-graph`/`gc` tasks are 2.29, but\n\t// the loose-objects + incremental-repack tasks the auto tier uses landed in 2.30 (and `core.multiPackIndex`\n\t// is default-on from 2.30, so no separate midx config write is needed) — 2.30 is the safe floor.\n\t['git:maintenance', '2.30'],\n\t// The pack-refs maintenance task landed one release after the maintenance builtin.\n\t['git:maintenance:pack-refs', '2.31'],\n\t// `git maintenance start` — the subcommands exist from 2.30 (cron only); launchctl (macOS) + schtasks\n\t// (Windows) scheduling arrived in 2.31, so 2.31 is the cross-platform-safe floor.\n\t['git:maintenance:start', '2.31'],\n\t// `git maintenance start` systemd-timer scheduling. On Linux, 2.31–2.33 is cron-only and modern distros\n\t// often ship without cron (scheduling then silently fails); the systemd fallback arrived in 2.34.\n\t['git:maintenance:start:systemd', '2.34'],\n\t// `feature.manyFiles` umbrella (index v4 + untracked cache + skipHash where available).\n\t['git:manyFiles', '2.24'],\n\t['git:merge-tree:merge-base', '2.40'],\n\t// `merge-tree --write-tree` mode with `-z`/`--name-only`/`--no-messages`; the older trivial mode can't check conflicts\n\t['git:merge-tree:write-tree', '2.38'],\n\t['git:push:force-if-includes', '2.30.0'],\n\t// `--autosquash` WITHOUT `-i` (folding `fixup!`/`squash!` commits into a plain/automatic rebase).\n\t// Interactive rebases support autosquash on every git version GitLens supports, so this floor only\n\t// gates the non-interactive path.\n\t['git:rebase:autosquash', '2.44'],\n\t['git:rev-parse:end-of-options', '2.30'],\n\t['git:signing:ssh', '2.34.0'],\n\t['git:signing:x509', '2.19.0'],\n\t// Sparse-index support debuted earlier, but 2.33 shipped a corruption fix and 2.34 broadened command\n\t// support. Use 2.34 as the conservative floor before offering a repository mutation.\n\t['git:sparse-index', '2.34'],\n\t['git:stash:push:pathspecs', '2.13.2'],\n\t['git:stash:push:staged', '2.35.0'],\n\t['git:stash:push:stdin', '2.30.0'],\n\t['git:status:find-renames', '2.18'],\n\t['git:status:porcelain-v2', '2.11'],\n\t// `core.untrackedCache=true` (repo-local cache of untracked-file scans — the auto-tier config lever).\n\t['git:untrackedCache', '2.8'],\n\t['git:worktrees', '2.17.0'],\n]);\n"],"mappings":";AA0CA,MAAa,oBAAoB;AACjC,MAAa,uCAAuB,IAAI,IAAyB;CAChE,CAAC,mCAAmC,MAAM;CAG1C,CAAC,oBAAoB,MAAM;CAG3B,CAAC,kCAAkC,MAAM;CACzC,CAAC,iCAAiC,MAAM;CAGxC,CAAC,iBAAiB,MAAM;CAIxB,CAAC,uBAAuB,MAAM;CAC9B,CAAC,sBAAsB,MAAM;CAE7B,CAAC,sBAAsB,MAAM;CAI7B,CAAC,mBAAmB,MAAM;CAE1B,CAAC,6BAA6B,MAAM;CAGpC,CAAC,yBAAyB,MAAM;CAGhC,CAAC,iCAAiC,MAAM;CAExC,CAAC,iBAAiB,MAAM;CACxB,CAAC,6BAA6B,MAAM;CAEpC,CAAC,6BAA6B,MAAM;CACpC,CAAC,8BAA8B,QAAQ;CAIvC,CAAC,yBAAyB,MAAM;CAChC,CAAC,gCAAgC,MAAM;CACvC,CAAC,mBAAmB,QAAQ;CAC5B,CAAC,oBAAoB,QAAQ;CAG7B,CAAC,oBAAoB,MAAM;CAC3B,CAAC,4BAA4B,QAAQ;CACrC,CAAC,yBAAyB,QAAQ;CAClC,CAAC,wBAAwB,QAAQ;CACjC,CAAC,2BAA2B,MAAM;CAClC,CAAC,2BAA2B,MAAM;CAElC,CAAC,sBAAsB,KAAK;CAC5B,CAAC,iBAAiB,QAAQ;AAC3B,CAAC"}
+{"version":3,"file":"features.js","names":[],"sources":["../../../git/src/features.ts"],"sourcesContent":["// GitFeature's must start with `git:` to be recognized in all usages\nexport type GitFeatures =\n\t| 'git:checkout:pathspec-from-file'\n\t| 'git:commit-graph'\n\t| 'git:commit-graph:changed-paths'\n\t| 'git:fetch:no-write-fetch-head'\n\t| 'git:for-each-ref:worktreePath'\n\t| 'git:fsmonitor'\n\t| 'git:fsmonitor:linux'\n\t| 'git:ignoreRevsFile'\n\t| 'git:index:skipHash'\n\t| 'git:maintenance'\n\t| 'git:maintenance:pack-refs'\n\t| 'git:maintenance:start'\n\t| 'git:maintenance:start:systemd'\n\t| 'git:manyFiles'\n\t| 'git:merge-tree:merge-base'\n\t| 'git:merge-tree:write-tree'\n\t| 'git:push:force-if-includes'\n\t| 'git:rebase:autosquash'\n\t| 'git:rev-parse:end-of-options'\n\t| 'git:signing:ssh'\n\t| 'git:signing:x509'\n\t| 'git:sparse-index'\n\t| 'git:stash:push:pathspecs'\n\t| 'git:stash:push:staged'\n\t| 'git:stash:push:stdin'\n\t| 'git:status:find-renames'\n\t| 'git:status:porcelain-v2'\n\t| 'git:untrackedCache'\n\t| 'git:worktrees';\n\ntype ExtractPrefix<T> = T extends `${infer Prefix}:${infer Rest}`\n\t? Rest extends `${infer SubPrefix}:${string}`\n\t\t? T | `${Prefix}:${SubPrefix}` | Prefix\n\t\t: T | Prefix\n\t: never;\n\nexport type GitFeatureOrPrefix = ExtractPrefix<GitFeatures>;\nexport type FilteredGitFeatures<T extends GitFeatureOrPrefix> = T extends GitFeatures\n\t? T\n\t: Extract<GitFeatures, T | `${T}:${string}`>;\n\nexport const gitMinimumVersion = '2.7.2';\nexport const gitFeaturesByVersion = new Map<GitFeatures, string>([\n\t['git:checkout:pathspec-from-file', '2.26'],\n\t// 2.24 is when git READS the commit-graph file by default (core.commitGraph on); writing it for\n\t// older gits would be dead weight.\n\t['git:commit-graph', '2.24'],\n\t// Changed-path Bloom filters (`--changed-paths`), the v2 filter format — pre-2.31 shipped Bloom filters\n\t// with real correctness bugs (bad results for merge commits), so 2.31 is the safe floor to write them.\n\t['git:commit-graph:changed-paths', '2.31'],\n\t['git:fetch:no-write-fetch-head', '2.29'],\n\t['git:for-each-ref:worktreePath', '2.23'],\n\t// `core.fsmonitor=true` selects the built-in FSMonitor daemon (accepting a bool rather than only a\n\t// hook path). This 2.37 floor is the Windows + macOS one.\n\t['git:fsmonitor', '2.37'],\n\t// Linux got its own FSMonitor backend (inotify) only in 2.55, hence a separate floor. Note the backend\n\t// places a watch on EVERY directory, so a large repo can exhaust `fs.inotify.max_user_watches` and the\n\t// daemon fails at runtime even on a new enough git — the apply path must still probe, not just gate.\n\t['git:fsmonitor:linux', '2.55'],\n\t['git:ignoreRevsFile', '2.23'],\n\t// `index.skipHash` (skip the trailing index checksum for faster writes); part of `feature.manyFiles`.\n\t['git:index:skipHash', '2.40'],\n\t// `git maintenance run --task=…`. The `maintenance` builtin + `commit-graph`/`gc` tasks are 2.29, but\n\t// the loose-objects + incremental-repack tasks the auto tier uses landed in 2.30 (and `core.multiPackIndex`\n\t// is default-on from 2.30, so no separate midx config write is needed) — 2.30 is the safe floor.\n\t['git:maintenance', '2.30'],\n\t// The pack-refs maintenance task landed one release after the maintenance builtin.\n\t['git:maintenance:pack-refs', '2.31'],\n\t// `git maintenance start` — the subcommands exist from 2.30 (cron only); launchctl (macOS) + schtasks\n\t// (Windows) scheduling arrived in 2.31, so 2.31 is the cross-platform-safe floor.\n\t['git:maintenance:start', '2.31'],\n\t// `git maintenance start` systemd-timer scheduling. On Linux, 2.31–2.33 is cron-only and modern distros\n\t// often ship without cron (scheduling then silently fails); the systemd fallback arrived in 2.34.\n\t['git:maintenance:start:systemd', '2.34'],\n\t// `feature.manyFiles` umbrella (index v4 + untracked cache + skipHash where available).\n\t['git:manyFiles', '2.24'],\n\t['git:merge-tree:merge-base', '2.40'],\n\t// `merge-tree --write-tree` mode with `-z`/`--name-only`/`--no-messages`; the older trivial mode can't check conflicts\n\t['git:merge-tree:write-tree', '2.38'],\n\t['git:push:force-if-includes', '2.30.0'],\n\t// `--autosquash` WITHOUT `-i` (folding `fixup!`/`squash!` commits into a plain/automatic rebase).\n\t// Interactive rebases support autosquash on every git version GitLens supports, so this floor only\n\t// gates the non-interactive path.\n\t['git:rebase:autosquash', '2.44'],\n\t['git:rev-parse:end-of-options', '2.30'],\n\t['git:signing:ssh', '2.34.0'],\n\t['git:signing:x509', '2.19.0'],\n\t// Sparse-index support debuted earlier, but 2.33 shipped a corruption fix and 2.34 broadened command\n\t// support. Use 2.34 as the conservative floor before offering a repository mutation.\n\t['git:sparse-index', '2.34'],\n\t['git:stash:push:pathspecs', '2.13.2'],\n\t['git:stash:push:staged', '2.35.0'],\n\t['git:stash:push:stdin', '2.30.0'],\n\t['git:status:find-renames', '2.18'],\n\t['git:status:porcelain-v2', '2.11'],\n\t// `core.untrackedCache=true` (repo-local cache of untracked-file scans — the auto-tier config lever).\n\t['git:untrackedCache', '2.8'],\n\t['git:worktrees', '2.17.0'],\n]);\n"],"mappings":";AA2CA,MAAa,oBAAoB;AACjC,MAAa,uCAAuB,IAAI,IAAyB;CAChE,CAAC,mCAAmC,MAAM;CAG1C,CAAC,oBAAoB,MAAM;CAG3B,CAAC,kCAAkC,MAAM;CACzC,CAAC,iCAAiC,MAAM;CACxC,CAAC,iCAAiC,MAAM;CAGxC,CAAC,iBAAiB,MAAM;CAIxB,CAAC,uBAAuB,MAAM;CAC9B,CAAC,sBAAsB,MAAM;CAE7B,CAAC,sBAAsB,MAAM;CAI7B,CAAC,mBAAmB,MAAM;CAE1B,CAAC,6BAA6B,MAAM;CAGpC,CAAC,yBAAyB,MAAM;CAGhC,CAAC,iCAAiC,MAAM;CAExC,CAAC,iBAAiB,MAAM;CACxB,CAAC,6BAA6B,MAAM;CAEpC,CAAC,6BAA6B,MAAM;CACpC,CAAC,8BAA8B,QAAQ;CAIvC,CAAC,yBAAyB,MAAM;CAChC,CAAC,gCAAgC,MAAM;CACvC,CAAC,mBAAmB,QAAQ;CAC5B,CAAC,oBAAoB,QAAQ;CAG7B,CAAC,oBAAoB,MAAM;CAC3B,CAAC,4BAA4B,QAAQ;CACrC,CAAC,yBAAyB,QAAQ;CAClC,CAAC,wBAAwB,QAAQ;CACjC,CAAC,2BAA2B,MAAM;CAClC,CAAC,2BAA2B,MAAM;CAElC,CAAC,sBAAsB,KAAK;CAC5B,CAAC,iBAAiB,QAAQ;AAC3B,CAAC"}

package/dist/git/models/reflog.d.ts

@@ -1,5 +1,11 @@
 import { Shape } from "../../utils/types.js";
 //#region ../git/src/models/reflog.d.ts
+/** One entry of `refs.getReflogEntries`; {@link GitReflog} is the aggregated HEAD walk instead */
+export interface GitReflogEntry {
+  readonly sha: string;
+  /** The reflog subject, `%gs`. */
+  readonly message: string;
+}
 export interface GitReflog {
   readonly repoPath: string;
   readonly records: GitReflogRecord[];

package/dist/git/models/reflog.js.map

@@ -1 +1 @@
-{"version":3,"file":"reflog.js","names":[],"sources":["../../../../git/src/models/reflog.ts"],"sourcesContent":["import { formatDate, fromNow } from '@gitlens/utils/date.js';\nimport { loggable } from '@gitlens/utils/decorators/log.js';\nimport { memoize } from '@gitlens/utils/decorators/memoize.js';\nimport type { Shape } from '@gitlens/utils/types.js';\nimport { shortenRevision } from '../utils/revision.utils.js';\n\nexport interface GitReflog {\n\treadonly repoPath: string;\n\treadonly records: GitReflogRecord[];\n\n\treadonly count: number;\n\treadonly total: number;\n\treadonly limit: number | undefined;\n\treadonly hasMore: boolean;\n\tmore?(limit: number | undefined): Promise<GitReflog | undefined>;\n}\n\nexport type GitReflogRecordShape = Shape<GitReflogRecord>;\n\n@loggable(i => `${shortenRevision(i.sha)}|${i.command}`)\nexport class GitReflogRecord {\n\tprivate _previousSha: string | undefined;\n\n\tconstructor(\n\t\tpublic readonly repoPath: string,\n\t\tpublic readonly sha: string,\n\t\tprivate _selector: string,\n\t\tpublic readonly date: Date,\n\t\tpublic readonly command: string,\n\t\tpublic readonly commandArgs: string | undefined,\n\t\tpublic readonly details: string | undefined,\n\t) {}\n\n\t@memoize()\n\tget HEAD(): string {\n\t\tif (this._selector == null || this._selector.length === 0) return '';\n\n\t\tif (this._selector.startsWith('refs/heads')) {\n\t\t\treturn this._selector.substring(11);\n\t\t}\n\n\t\tif (this._selector.startsWith('refs/remotes')) {\n\t\t\treturn this._selector.substring(13);\n\t\t}\n\n\t\treturn this._selector;\n\t}\n\n\tget previousSha(): string | undefined {\n\t\treturn this._previousSha;\n\t}\n\n\t@memoize()\n\tget previousShortSha(): string {\n\t\treturn shortenRevision(this._previousSha);\n\t}\n\n\tget selector(): string {\n\t\treturn this._selector;\n\t}\n\n\t@memoize()\n\tget shortSha(): string {\n\t\treturn shortenRevision(this.sha);\n\t}\n\n\t/** @internal Called by the parser to set previousSha/selector before the record is published */\n\tupdate(previousSha?: string, selector?: string): void {\n\t\tif (previousSha !== undefined) {\n\t\t\tthis._previousSha = previousSha;\n\t\t}\n\t\tif (selector !== undefined) {\n\t\t\tthis._selector = selector;\n\t\t}\n\t}\n\n\tstatic is(record: unknown): record is GitReflogRecord {\n\t\treturn record instanceof GitReflogRecord;\n\t}\n\n\tstatic formatDate(record: GitReflogRecordShape, format?: string | null): string {\n\t\treturn formatDate(record.date, format ?? 'MMMM Do, YYYY h:mma');\n\t}\n\n\tstatic formatDateFromNow(record: GitReflogRecordShape): string {\n\t\treturn fromNow(record.date);\n\t}\n}\n"],"mappings":";;;;;;;AAoBO,IAAM,kBAAA,mBAAN,MAAM,gBAAgB;CAIX;CACA;CACR;CACQ;CACA;CACA;CACA;CATjB;CAEA,YACC,UACA,KACA,WACA,MACA,SACA,aACA,SACC;EAPe,KAAA,WAAA;EACA,KAAA,MAAA;EACR,KAAA,YAAA;EACQ,KAAA,OAAA;EACA,KAAA,UAAA;EACA,KAAA,cAAA;EACA,KAAA,UAAA;CACd;CAEH,IACI,OAAe;EAClB,IAAI,KAAK,aAAa,QAAQ,KAAK,UAAU,WAAW,GAAG,OAAO;EAElE,IAAI,KAAK,UAAU,WAAW,YAAY,GACzC,OAAO,KAAK,UAAU,UAAU,EAAE;EAGnC,IAAI,KAAK,UAAU,WAAW,cAAc,GAC3C,OAAO,KAAK,UAAU,UAAU,EAAE;EAGnC,OAAO,KAAK;CACb;CAEA,IAAI,cAAkC;EACrC,OAAO,KAAK;CACb;CAEA,IACI,mBAA2B;EAC9B,OAAO,gBAAgB,KAAK,YAAY;CACzC;CAEA,IAAI,WAAmB;EACtB,OAAO,KAAK;CACb;CAEA,IACI,WAAmB;EACtB,OAAO,gBAAgB,KAAK,GAAG;CAChC;;CAGA,OAAO,aAAsB,UAAyB;EACrD,IAAI,gBAAgB,KAAA,GACnB,KAAK,eAAe;EAErB,IAAI,aAAa,KAAA,GAChB,KAAK,YAAY;CAEnB;CAEA,OAAO,GAAG,QAA4C;EACrD,OAAO,kBAAA;CACR;CAEA,OAAO,WAAW,QAA8B,QAAgC;EAC/E,OAAO,WAAW,OAAO,MAAM,UAAU,qBAAqB;CAC/D;CAEA,OAAO,kBAAkB,QAAsC;EAC9D,OAAO,QAAQ,OAAO,IAAI;CAC3B;AACD;AAtDE,WAAA,CAAA,QAAQ,CAAA,GAAA,gBAAA,WAAA,QAAA,IAAA;AAmBR,WAAA,CAAA,QAAQ,CAAA,GAAA,gBAAA,WAAA,oBAAA,IAAA;AASR,WAAA,CAAA,QAAQ,CAAA,GAAA,gBAAA,WAAA,YAAA,IAAA;AA1CT,kBAAA,mBAAA,WAAA,CAAA,UAAS,MAAK,GAAG,gBAAgB,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,CAAA,GAAA,eAAA"}
+{"version":3,"file":"reflog.js","names":[],"sources":["../../../../git/src/models/reflog.ts"],"sourcesContent":["import { formatDate, fromNow } from '@gitlens/utils/date.js';\nimport { loggable } from '@gitlens/utils/decorators/log.js';\nimport { memoize } from '@gitlens/utils/decorators/memoize.js';\nimport type { Shape } from '@gitlens/utils/types.js';\nimport { shortenRevision } from '../utils/revision.utils.js';\n\n/** One entry of `refs.getReflogEntries`; {@link GitReflog} is the aggregated HEAD walk instead */\nexport interface GitReflogEntry {\n\treadonly sha: string;\n\t/** The reflog subject, `%gs`. */\n\treadonly message: string;\n}\n\nexport interface GitReflog {\n\treadonly repoPath: string;\n\treadonly records: GitReflogRecord[];\n\n\treadonly count: number;\n\treadonly total: number;\n\treadonly limit: number | undefined;\n\treadonly hasMore: boolean;\n\tmore?(limit: number | undefined): Promise<GitReflog | undefined>;\n}\n\nexport type GitReflogRecordShape = Shape<GitReflogRecord>;\n\n@loggable(i => `${shortenRevision(i.sha)}|${i.command}`)\nexport class GitReflogRecord {\n\tprivate _previousSha: string | undefined;\n\n\tconstructor(\n\t\tpublic readonly repoPath: string,\n\t\tpublic readonly sha: string,\n\t\tprivate _selector: string,\n\t\tpublic readonly date: Date,\n\t\tpublic readonly command: string,\n\t\tpublic readonly commandArgs: string | undefined,\n\t\tpublic readonly details: string | undefined,\n\t) {}\n\n\t@memoize()\n\tget HEAD(): string {\n\t\tif (this._selector == null || this._selector.length === 0) return '';\n\n\t\tif (this._selector.startsWith('refs/heads')) {\n\t\t\treturn this._selector.substring(11);\n\t\t}\n\n\t\tif (this._selector.startsWith('refs/remotes')) {\n\t\t\treturn this._selector.substring(13);\n\t\t}\n\n\t\treturn this._selector;\n\t}\n\n\tget previousSha(): string | undefined {\n\t\treturn this._previousSha;\n\t}\n\n\t@memoize()\n\tget previousShortSha(): string {\n\t\treturn shortenRevision(this._previousSha);\n\t}\n\n\tget selector(): string {\n\t\treturn this._selector;\n\t}\n\n\t@memoize()\n\tget shortSha(): string {\n\t\treturn shortenRevision(this.sha);\n\t}\n\n\t/** @internal Called by the parser to set previousSha/selector before the record is published */\n\tupdate(previousSha?: string, selector?: string): void {\n\t\tif (previousSha !== undefined) {\n\t\t\tthis._previousSha = previousSha;\n\t\t}\n\t\tif (selector !== undefined) {\n\t\t\tthis._selector = selector;\n\t\t}\n\t}\n\n\tstatic is(record: unknown): record is GitReflogRecord {\n\t\treturn record instanceof GitReflogRecord;\n\t}\n\n\tstatic formatDate(record: GitReflogRecordShape, format?: string | null): string {\n\t\treturn formatDate(record.date, format ?? 'MMMM Do, YYYY h:mma');\n\t}\n\n\tstatic formatDateFromNow(record: GitReflogRecordShape): string {\n\t\treturn fromNow(record.date);\n\t}\n}\n"],"mappings":";;;;;;;AA2BO,IAAM,kBAAA,mBAAN,MAAM,gBAAgB;CAIX;CACA;CACR;CACQ;CACA;CACA;CACA;CATjB;CAEA,YACC,UACA,KACA,WACA,MACA,SACA,aACA,SACC;EAPe,KAAA,WAAA;EACA,KAAA,MAAA;EACR,KAAA,YAAA;EACQ,KAAA,OAAA;EACA,KAAA,UAAA;EACA,KAAA,cAAA;EACA,KAAA,UAAA;CACd;CAEH,IACI,OAAe;EAClB,IAAI,KAAK,aAAa,QAAQ,KAAK,UAAU,WAAW,GAAG,OAAO;EAElE,IAAI,KAAK,UAAU,WAAW,YAAY,GACzC,OAAO,KAAK,UAAU,UAAU,EAAE;EAGnC,IAAI,KAAK,UAAU,WAAW,cAAc,GAC3C,OAAO,KAAK,UAAU,UAAU,EAAE;EAGnC,OAAO,KAAK;CACb;CAEA,IAAI,cAAkC;EACrC,OAAO,KAAK;CACb;CAEA,IACI,mBAA2B;EAC9B,OAAO,gBAAgB,KAAK,YAAY;CACzC;CAEA,IAAI,WAAmB;EACtB,OAAO,KAAK;CACb;CAEA,IACI,WAAmB;EACtB,OAAO,gBAAgB,KAAK,GAAG;CAChC;;CAGA,OAAO,aAAsB,UAAyB;EACrD,IAAI,gBAAgB,KAAA,GACnB,KAAK,eAAe;EAErB,IAAI,aAAa,KAAA,GAChB,KAAK,YAAY;CAEnB;CAEA,OAAO,GAAG,QAA4C;EACrD,OAAO,kBAAA;CACR;CAEA,OAAO,WAAW,QAA8B,QAAgC;EAC/E,OAAO,WAAW,OAAO,MAAM,UAAU,qBAAqB;CAC/D;CAEA,OAAO,kBAAkB,QAAsC;EAC9D,OAAO,QAAQ,OAAO,IAAI;CAC3B;AACD;AAtDE,WAAA,CAAA,QAAQ,CAAA,GAAA,gBAAA,WAAA,QAAA,IAAA;AAmBR,WAAA,CAAA,QAAQ,CAAA,GAAA,gBAAA,WAAA,oBAAA,IAAA;AASR,WAAA,CAAA,QAAQ,CAAA,GAAA,gBAAA,WAAA,YAAA,IAAA;AA1CT,kBAAA,mBAAA,WAAA,CAAA,UAAS,MAAK,GAAG,gBAAgB,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,CAAA,GAAA,eAAA"}

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

@@ -2,7 +2,6 @@
 export declare const deletedOrMissing = "0000000000000000000000000000000000000000-";
 export declare const uncommitted = "0000000000000000000000000000000000000000";
 export declare const uncommittedStaged = "0000000000000000000000000000000000000000:";
-export declare const rootSha = "4b825dc642cb6eb9a060e54bf8d69288fbee4904";
 export type GitRevisionRange = `${GitRevisionRangeNotation}${string}` | `${string}${GitRevisionRangeNotation}` | `${string}${GitRevisionRangeNotation}${string}`;
 export type GitRevisionRangeNotation = '..' | '...';
 //#endregion

package/dist/git/models/revision.js

@@ -2,8 +2,7 @@
 const deletedOrMissing = "0000000000000000000000000000000000000000-";
 const uncommitted = "0000000000000000000000000000000000000000";
 const uncommittedStaged = "0000000000000000000000000000000000000000:";
-const rootSha = "4b825dc642cb6eb9a060e54bf8d69288fbee4904";
 //#endregion
-export { deletedOrMissing, rootSha, uncommitted, uncommittedStaged };
+export { deletedOrMissing, uncommitted, uncommittedStaged };
 
 //# sourceMappingURL=revision.js.map

package/dist/git/models/revision.js.map

@@ -1 +1 @@
-{"version":3,"file":"revision.js","names":[],"sources":["../../../../git/src/models/revision.ts"],"sourcesContent":["export const deletedOrMissing = '0000000000000000000000000000000000000000-';\nexport const uncommitted = '0000000000000000000000000000000000000000';\nexport const uncommittedStaged = '0000000000000000000000000000000000000000:';\n// This is a root sha of all git repo's if using sha1\nexport const rootSha = '4b825dc642cb6eb9a060e54bf8d69288fbee4904';\n\nexport type GitRevisionRange =\n\t| `${GitRevisionRangeNotation}${string}`\n\t| `${string}${GitRevisionRangeNotation}`\n\t| `${string}${GitRevisionRangeNotation}${string}`;\n\nexport type GitRevisionRangeNotation = '..' | '...';\n"],"mappings":";AAAA,MAAa,mBAAmB;AAChC,MAAa,cAAc;AAC3B,MAAa,oBAAoB;AAEjC,MAAa,UAAU"}
+{"version":3,"file":"revision.js","names":[],"sources":["../../../../git/src/models/revision.ts"],"sourcesContent":["export const deletedOrMissing = '0000000000000000000000000000000000000000-';\nexport const uncommitted = '0000000000000000000000000000000000000000';\nexport const uncommittedStaged = '0000000000000000000000000000000000000000:';\n\nexport type GitRevisionRange =\n\t| `${GitRevisionRangeNotation}${string}`\n\t| `${string}${GitRevisionRangeNotation}`\n\t| `${string}${GitRevisionRangeNotation}${string}`;\n\nexport type GitRevisionRangeNotation = '..' | '...';\n"],"mappings":";AAAA,MAAa,mBAAmB;AAChC,MAAa,cAAc;AAC3B,MAAa,oBAAoB"}

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

@@ -45,6 +45,8 @@ export interface GitLogForPathOptions extends Omit<GitLogOptions, 'stashes'> {
 export interface GitLogShasOptions extends GitLogOptionsBase {
   all?: boolean;
   authors?: GitUser[];
+  /** Leaves out commits reachable from these refs, relative to `rev` (`HEAD` when omitted) — see {@link GitRefExclusions} */
+  excluding?: GitRefExclusions;
   merges?: boolean | 'first-parent';
   pathOrUri?: string | Uri;
   reverse?: boolean;
@@ -63,6 +65,20 @@ export interface IncomingActivityOptions extends GitLogOptionsBase {
   branch?: string;
   skip?: number;
 }
+/**
+ * Refs whose commits a history read (`getCommitCount`, `getLogShas`) leaves out, as `--not`.
+ * `branches`/`remotes`/`tags` exclude every ref in that namespace; `except` carves full ref names or globs (`refs/heads/feat`, `refs/remotes/origin/*`)
+ * back out of an enabled namespace and is ignored otherwise; `refs` are further revisions, passed verbatim.
+ * A read is cached until a branch, remote-tracking branch or tag changes, so a `refs` entry outside those namespaces
+ * (a tool's own `refs/<tool>/…`) can move without refreshing it: pass that ref's SHA instead, which keys a new read.
+ */
+export interface GitRefExclusions {
+  branches?: boolean;
+  remotes?: boolean;
+  tags?: boolean;
+  refs?: readonly string[];
+  except?: readonly string[];
+}
 export interface GitCommitReachability {
   readonly partial?: boolean;
   readonly refs: ({
@@ -78,7 +94,10 @@ export interface GitCommitReachability {
 }
 export interface GitCommitsSubProvider {
   getCommit(repoPath: string, rev: string, cancellation?: AbortSignal): Promise<GitCommit | undefined>;
-  getCommitCount(repoPath: string, rev: string, cancellation?: AbortSignal): Promise<number | undefined>;
+  /** Counts the commits reachable from `rev`, less any reachable from `excluding` — e.g. what only one branch has */
+  getCommitCount(repoPath: string, rev: string, options?: {
+    excluding?: GitRefExclusions;
+  }, cancellation?: AbortSignal): Promise<number | undefined>;
   /** Whether `rev` has any commits not reachable from any remote-tracking ref (i.e. unpushed/unpublished).
    *  Cheap early-exit probe (`rev-list --not --remotes <rev> -n 1`) — it does NOT count them. Returns
    *  `undefined` when it can't be determined. */
@@ -112,7 +131,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

@@ -47,6 +47,19 @@ export interface GitOperationsSubProvider {
     prune?: boolean | undefined;
     pull?: boolean | undefined;
     remote?: string | undefined;
+    refspecs?: undefined;
+    /** Leaves `FETCH_HEAD` for a user's own `git pull` to read (`--no-write-fetch-head`); ignored on git older than 2.29 */
+    preserveFetchHead?: boolean | undefined;
+  } | {
+    all?: undefined;
+    branch?: undefined;
+    prune?: boolean | undefined;
+    pull?: undefined;
+    remote: string;
+    /** Passed verbatim after `remote`; never adds `-u`, so git keeps refusing to write into a checked-out branch. */
+    refspecs: readonly string[];
+    /** Leaves `FETCH_HEAD` for a user's own `git pull` to read (`--no-write-fetch-head`); ignored on git older than 2.29 */
+    preserveFetchHead?: boolean | undefined;
   }, runOptions?: GitOperationRunOptions): Promise<void>;
   merge(repoPath: string, ref: string, options?: {
     fastForward?: boolean | 'only';
@@ -56,6 +69,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,17 +1,19 @@
 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 { GitOperationRunOptions, GitOperationsSubProvider } from "./operations.js";
 import { GitBlameSubProvider } from "./blame.js";
 import { GitConfigSubProvider } from "./config.js";
 import { GitStagingSubProvider } from "./staging.js";
 import { GitDiffSubProvider } from "./diff.js";
 import { GitGraphSubProvider } from "./graph.js";
-import { GitOperationsSubProvider } from "./operations.js";
 import { GitPatchSubProvider } from "./patch.js";
 import { GitPausedOperationsSubProvider } from "./pausedOperations.js";
 import { GitRefsSubProvider } from "./refs.js";
@@ -31,11 +33,36 @@ export interface GitProvider {
   readonly descriptor: GitProviderDescriptor;
   getAbsoluteUri(pathOrUri: string | Uri, base: string | Uri): Uri;
   getRelativePath(pathOrUri: string | Uri, base: string | Uri): string;
-  clone?(url: string, parentPath: string): Promise<string | undefined>;
+  clone?(url: string, parentPath: string, options?: {
+    /** Used exactly, with no collision probing or auto-numbering; git itself refuses a non-empty target. */
+    folderName?: string;
+  },
+  /** Spread into the run (`env`, `cancellation`, `timeout`) — the caller decides the timeout for a large clone. */
+  runOptions?: GitOperationRunOptions): Promise<string | undefined>;
   excludeIgnoredUris?(repoPath: string, uris: Uri[]): Promise<Uri[]>;
   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` and the repository's pending commands before the
+   * host's handlers run.
+   *
+   * What is reset: `options.cache` when given (`'all'` for everything, `[]` for nothing); otherwise the
+   * cache types `changes` map to, the same mapping a file watcher's changes get. An empty `changes`, or one
+   * naming `'unknown'` or `'closed'`, resets everything. Changes that map to no cache type (e.g.
+   * `'starred'`) reset nothing and fire no `onReset`; `onChanged` always fires.
+   */
+  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

@@ -3,6 +3,7 @@ import { GitRefTip, GitReference } from "../models/reference.js";
 import { GitBranch } from "../models/branch.js";
 import { GitTag } from "../models/tag.js";
 import { GitCommandPriority } from "../run.types.js";
+import { GitReflogEntry } from "../models/reflog.js";
 //#region ../git/src/providers/refs.d.ts
 export interface GitRefsSubProvider {
   checkIfCouldBeValidBranchOrTagName(repoPath: string, ref: string): Promise<boolean>;
@@ -10,7 +11,20 @@ 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>;
+  /**
+   * Reads `ref`'s reflog, newest first, optionally keeping only entries whose message matches `grep` (git's
+   * `--grep-reflog` pattern). Resolves `[]` when nothing matches or `ref` has no reflog, and rejects when the
+   * read fails (e.g. `ref` doesn't exist), so "no answer" is distinguishable from "never read".
+   */
+  getReflogEntries?(repoPath: string, ref: string, options?: {
+    grep?: string;
+    priority?: GitCommandPriority;
+  }, cancellation?: AbortSignal): Promise<GitReflogEntry[]>;
   /**
    * 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 +52,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

@@ -18,13 +18,19 @@ export interface GitRevisionSubProvider {
   exists?(repoPath: string, path: string, revOrOptions?: string | {
     untracked?: 'only' | 'include';
   }): Promise<boolean>;
+  /** The empty tree's id in this repository's object format (SHA-1 or SHA-256). */
+  getEmptyTreeSha(repoPath: string): Promise<string>;
   getRevisionContent(repoPath: string, path: string, rev: string): Promise<Uint8Array | undefined>;
   getSubmoduleHead?(repoPath: string, submodulePath: string): Promise<string | undefined>;
   /** Gets tracked file paths from the index (reflects working tree state, even during rebase) */
   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

@@ -1,5 +1,6 @@
 import { Uri } from "../../utils/uri.js";
 import { UnifiedAsyncDisposable } from "../../utils/disposable.js";
+import { GitOperationRunOptions } from "./operations.js";
 //#region ../git/src/providers/staging.d.ts
 export interface DisposableTemporaryGitIndex extends UnifiedAsyncDisposable {
   path: string;
@@ -37,6 +38,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;
+  }, runOptions?: GitOperationRunOptions): Promise<void>;
 }
 //#endregion
 //# sourceMappingURL=staging.d.ts.map

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

@@ -1,6 +1,7 @@
 import { Uri } from "../../utils/uri.js";
 import { GitFileChange } from "../models/fileChange.js";
 import { GitStash } from "../models/stash.js";
+import { GitOperationRunOptions } from "./operations.js";
 //#region ../git/src/providers/stash.d.ts
 export interface StashApplyResult {
   readonly conflicted: boolean;
@@ -15,7 +16,7 @@ export interface GitStashSubProvider {
   applyStash(repoPath: string, stashNameOrSha: string, options?: {
     deleteAfter?: boolean | undefined;
     index?: boolean | undefined;
-  }): Promise<StashApplyResult>;
+  }, runOptions?: GitOperationRunOptions): Promise<StashApplyResult>;
   /**
    * Creates a stash commit without adding it to the stash list (plumbing — equivalent to
    * `git stash create`). Returns the created commit SHA, or `undefined` if there was nothing to
@@ -36,7 +37,7 @@ export interface GitStashSubProvider {
     includeUntracked?: boolean;
     keepIndex?: boolean;
     onlyStaged?: boolean;
-  }): Promise<void>;
+  }, runOptions?: GitOperationRunOptions): Promise<void>;
   saveSnapshot(repoPath: string, message?: string): Promise<void>;
 }
 //#endregion

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

@@ -14,6 +14,10 @@ export interface GitStatusSubProvider {
   getStatus(repoPath: string | undefined, options?: {
     priority?: GitCommandPriority;
     force?: boolean;
+    /** `git status -u<value>`; defaults to `'all'` (today's `-u`, listing files in an untracked directory individually). */
+    untracked?: 'no' | 'normal' | 'all';
+    /** `false` omits `--branch`, computing no upstream ahead/behind; the result's `branch`, `sha`, `upstream` and `detached` are then not read and mean nothing */
+    branch?: false;
   }, cancellation?: AbortSignal): Promise<GitStatus | undefined>;
   getStatusForFile?(repoPath: string, pathOrUri: string | Uri, options?: {
     renames?: boolean;

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

@@ -1,5 +1,6 @@
 import { CacheController } from "../utils/promiseCache.js";
 import { GitWarningKey } from "./errors.js";
+import { RepositoryChange } from "./models/repository.js";
 import { GitHealthSlownessCategory } from "./gitHealth.js";
 //#region ../git/src/run.types.d.ts
 export type GitErrorHandling = 'throw' | 'ignore';
@@ -76,6 +77,7 @@ export interface GitResultCache {
     accessTTL?: number;
     cancellation?: AbortSignal;
   }): Promise<GitResult<unknown>>;
+  delete(repoPath: string, key: string): void;
 }
 /**
  * Priority levels for git commands.
@@ -119,7 +121,27 @@ 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;
   };
+  /**
+   * Opt-in: after the run settles (success, failure, or cancellation), announce a change to the provider
+   * for this run's repository, the same way a typed sub-provider mutator does. `'infer'` classifies the
+   * command's argv (a `-C <path>` re-scopes which repository); a read-only or object-store-only command
+   * then announces nothing. An explicit array announces exactly those {@link RepositoryChange} kinds,
+   * regardless of what the argv looks like. Left unset, nothing is classified or announced — zero cost
+   * for every existing caller. The change is announced for `cwd`, or the `-C` target, as given: run from the
+   * repository root, since that's the path core's caches are keyed by. A `-C`-scoped verb whose effect every
+   * worktree shares (`branch`, `fetch`, …) is announced for the caller's `cwd` too, resetting once per repository.
+   *
+   * The announcement resets only the caches the announced kinds can have made stale, the same ones a file
+   * watcher's change of those kinds clears, and drops the repository's pending git runs. A write `'infer'`
+   * can't classify announces `[]`, which resets everything, as does `['unknown']`.
+   */
+  notify?: 'infer' | readonly RepositoryChange[];
   cwd?: string;
   readonly env?: Record<string, string | undefined>;
   readonly encoding?: BufferEncoding | 'buffer' | string;