@gitkraken/core-gitlens 0.8.0 → 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/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. */

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';

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

@@ -8,12 +8,12 @@ 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";
@@ -33,7 +33,12 @@ 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>;
@@ -47,8 +52,13 @@ export interface GitProvider {
    * 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.
+   * 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';

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>;
@@ -15,6 +16,15 @@ export interface GitRefsSubProvider {
   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.

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

@@ -18,6 +18,8 @@ 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) */

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;
@@ -48,7 +49,7 @@ export interface GitStagingSubProvider {
     directories?: boolean;
     force?: boolean;
     ignored?: boolean;
-  }): Promise<void>;
+  }, 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/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';
@@ -126,6 +127,21 @@ export interface GitRunOptions {
      */
     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;

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

@@ -4,6 +4,7 @@ import { GitIgnoreFilter } from "../git/watching/gitIgnoreFilter.js";
 import { RepositoryChange } from "../git/models/repository.js";
 import { GitServiceContext } from "../git/context.js";
 import { Cache, CachedGitTypes } from "../git/cache.js";
+import { GitOperationRunOptions } from "../git/providers/operations.js";
 import { GitProvider } from "../git/providers/provider.js";
 import { FilteredGitFeatures, GitFeatureOrPrefix, GitFeatures } from "../git/features.js";
 import { GitLocation } from "./exec/locator.js";
@@ -79,6 +80,8 @@ export declare class CliGitProvider implements GitProvider {
   private readonly _cacheOwned;
   private readonly _git;
   readonly context: GitServiceContext;
+  /** The host's own hooks, before the provider wraps `cache.onReset` with its own clearing */
+  private readonly _hostHooks;
   private readonly _localRepositories;
   constructor(options: CliGitProviderOptions);
   /** The underlying cache instance (for repo path registration, etc.) */
@@ -96,7 +99,9 @@ export declare class CliGitProvider implements GitProvider {
   version(): Promise<string>;
   /** Returns the resolved git binary path. */
   path(): Promise<string>;
-  clone(url: string, parentPath: string): Promise<string | undefined>;
+  clone(url: string, parentPath: string, options?: {
+    folderName?: string;
+  }, runOptions?: GitOperationRunOptions): 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;
@@ -106,12 +111,28 @@ export declare class CliGitProvider implements GitProvider {
    * 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.
+   * the provider hard-evicts its own caches for `repoPath` and drops its pending commands for the repository
+   * (its sibling worktrees included) 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, status clock included.
+   * An empty `changes`, or one naming `'unknown'` or `'closed'`, resets everything. Changes that map to
+   * no cache type (e.g. `'starred'`) reset nothing, and `onReset` doesn't fire; `onChanged` always fires.
    */
   notifyChanged(repoPath: string, changes: readonly RepositoryChange[], options?: {
     cache?: readonly CachedGitTypes[] | 'all';
   }): void;
+  /**
+   * {@link notifyChanged} for one change seen from several paths, e.g. a `-C` shared-state verb announced
+   * for both its target and the caller's `cwd`. Each path's caches are reset and the host's `onReset` fires
+   * for each, since a host may keep per-worktree state, but a repository's pending commands are dropped once
+   * however many of its worktrees are named.
+   */
+  private notifyChangedCore;
+  /** Evicts what a notified change reset for `repoPath`: the types reset (`[]` = all), or `undefined` for none. */
+  private resetForChanges;
+  /** `repoPath` and every worktree registered as sharing its repository, since a shared-ref write moves them all. */
+  private getRepositoryPaths;
   private _blame;
   get blame(): BlameGitSubProvider;
   private _branches;

package/dist/git-cli/cliGitProvider.js

@@ -57,9 +57,12 @@ var CliGitProvider = class {
 	_cacheOwned;
 	_git;
 	context;
+	/** The host's own hooks, before the provider wraps `cache.onReset` with its own clearing */
+	_hostHooks;
 	_localRepositories;
 	constructor(options) {
 		const hostHooks = options.context.hooks;
+		this._hostHooks = hostHooks;
 		this.context = {
 			...options.context,
 			hooks: {
@@ -68,7 +71,7 @@ var CliGitProvider = class {
 					...hostHooks?.cache,
 					onReset: (repoPath, ...types) => {
 						this._cache.evictCaches(repoPath, ...types);
-						this._git.clearPendingCommands();
+						this._git.clearPendingCommands(this.getRepositoryPaths(repoPath));
 						hostHooks?.cache?.onReset?.(repoPath, ...types);
 					}
 				}
@@ -81,6 +84,7 @@ var CliGitProvider = class {
 		});
 		this._cacheOwned = !(options.cache instanceof Cache);
 		this._cache = options.cache instanceof Cache ? options.cache : new Cache();
+		this._git.bindChangeNotifier((repoPaths, changes) => this.notifyChangedCore(repoPaths, changes));
 	}
 	/** The underlying cache instance (for repo path registration, etc.) */
 	get cache() {
@@ -109,17 +113,25 @@ var CliGitProvider = class {
 	async path() {
 		return this._git.path();
 	}
-	async clone(url, parentPath) {
-		let count = 0;
-		const [, , remotePath] = parseGitRemoteUrl(url);
-		const remoteName = remotePath.split("/").pop();
-		if (!remoteName) return void 0;
-		let folderPath = joinPaths(parentPath, remoteName);
-		while (await fsExists(folderPath) && count < 20) {
-			count++;
-			folderPath = joinPaths(parentPath, `${remoteName}-${count}`);
+	async clone(url, parentPath, options, runOptions) {
+		let folderPath;
+		if (options?.folderName) folderPath = joinPaths(parentPath, options.folderName);
+		else {
+			const [, , remotePath] = parseGitRemoteUrl(url);
+			const remoteName = remotePath.split("/").pop();
+			if (!remoteName) return void 0;
+			let count = 0;
+			folderPath = joinPaths(parentPath, remoteName);
+			while (await fsExists(folderPath) && count < 20) {
+				count++;
+				folderPath = joinPaths(parentPath, `${remoteName}-${count}`);
+			}
 		}
-		await this._git.run({ cwd: parentPath }, "clone", url, folderPath);
+		await this._git.run({
+			cwd: parentPath,
+			errors: "throw",
+			...runOptions
+		}, "clone", url, folderPath);
 		return folderPath;
 	}
 	/** Creates a new repository at `targetPath` (`git init`), creating it first if it doesn't yet exist. */
@@ -134,14 +146,64 @@ var CliGitProvider = class {
 	* 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.
+	* the provider hard-evicts its own caches for `repoPath` and drops its pending commands for the repository
+	* (its sibling worktrees included) 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, status clock included.
+	* An empty `changes`, or one naming `'unknown'` or `'closed'`, resets everything. Changes that map to
+	* no cache type (e.g. `'starred'`) reset nothing, and `onReset` doesn't fire; `onChanged` always fires.
 	*/
 	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]);
+		this.notifyChangedCore([repoPath], changes, options);
+	}
+	/**
+	* {@link notifyChanged} for one change seen from several paths, e.g. a `-C` shared-state verb announced
+	* for both its target and the caller's `cwd`. Each path's caches are reset and the host's `onReset` fires
+	* for each, since a host may keep per-worktree state, but a repository's pending commands are dropped once
+	* however many of its worktrees are named.
+	*/
+	notifyChangedCore(repoPaths, changes, options) {
+		const resets = [];
+		const pendingPaths = /* @__PURE__ */ new Set();
+		for (const repoPath of repoPaths) {
+			const types = this.resetForChanges(repoPath, changes, options?.cache);
+			if (types == null) {
+				if (options?.cache == null && changes.includes("gkConfig")) for (const path of this.getRepositoryPaths(repoPath)) pendingPaths.add(path);
+				continue;
+			}
+			resets.push({
+				repoPath,
+				types
+			});
+			for (const path of this.getRepositoryPaths(repoPath)) pendingPaths.add(path);
+		}
+		if (pendingPaths.size) this._git.clearPendingCommands([...pendingPaths]);
+		for (const { repoPath, types } of resets) this._hostHooks?.cache?.onReset?.(repoPath, ...types);
+		for (const repoPath of repoPaths) this.context.hooks?.repository?.onChanged?.(repoPath, [...changes]);
+	}
+	/** Evicts what a notified change reset for `repoPath`: the types reset (`[]` = all), or `undefined` for none. */
+	resetForChanges(repoPath, changes, cache) {
+		if (cache != null && cache !== "all") {
+			if (!cache.length) return void 0;
+			this._cache.evictCaches(repoPath, ...cache);
+			return [...cache];
+		}
+		if (cache === "all" || !changes.length || changes.some((c) => c === "unknown" || c === "closed")) {
+			this._cache.evictCaches(repoPath);
+			return [];
+		}
+		const types = this._cache.applyRepositoryChanges(repoPath, changes, "evict");
+		return types.length ? types : void 0;
+	}
+	/** `repoPath` and every worktree registered as sharing its repository, since a shared-ref write moves them all. */
+	getRepositoryPaths(repoPath) {
+		const commonPath = this._cache.getCommonPath(repoPath);
+		return [.../* @__PURE__ */ new Set([
+			repoPath,
+			commonPath,
+			...this._cache.getWorktreePaths(commonPath)
+		])];
 	}
 	_blame;
 	get blame() {