@gitkraken/core-gitlens 0.15.7 → 0.16.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +25 -1
- package/dist/git/cache.d.ts +13 -0
- package/dist/git/cache.js +45 -8
- package/dist/git/cache.js.map +1 -1
- package/dist/git/features.d.ts +1 -1
- package/dist/git/features.js +1 -0
- package/dist/git/features.js.map +1 -1
- package/dist/git/providers/branches.d.ts +29 -0
- package/dist/git/run.types.d.ts +3 -0
- package/dist/git/service.d.ts +4 -2
- package/dist/git/service.js +6 -4
- package/dist/git/service.js.map +1 -1
- package/dist/git/watching/classifyChange.js +3 -0
- package/dist/git/watching/classifyChange.js.map +1 -1
- package/dist/git/watching/watchSession.d.ts +2 -0
- package/dist/git/watching/watchSession.js +9 -1
- package/dist/git/watching/watchSession.js.map +1 -1
- package/dist/git/watching/worktreeSummary.d.ts +19 -4
- package/dist/git/watching/worktreeSummary.js +121 -36
- package/dist/git/watching/worktreeSummary.js.map +1 -1
- package/dist/git-cli/cliGitProvider.d.ts +1 -1
- package/dist/git-cli/cliGitProvider.js +8 -5
- package/dist/git-cli/cliGitProvider.js.map +1 -1
- package/dist/git-cli/exec/commandClassifier.d.ts +18 -3
- package/dist/git-cli/exec/commandClassifier.js +562 -16
- package/dist/git-cli/exec/commandClassifier.js.map +1 -1
- package/dist/git-cli/exec/exec.d.ts +2 -2
- package/dist/git-cli/exec/git.d.ts +31 -4
- package/dist/git-cli/exec/git.js +105 -43
- package/dist/git-cli/exec/git.js.map +1 -1
- package/dist/git-cli/exec/headState.d.ts +32 -0
- package/dist/git-cli/exec/headState.js +78 -0
- package/dist/git-cli/exec/headState.js.map +1 -0
- package/dist/git-cli/providers/branches.d.ts +50 -0
- package/dist/git-cli/providers/branches.js +294 -25
- package/dist/git-cli/providers/branches.js.map +1 -1
- package/dist/git-cli/providers/config.js +3 -2
- package/dist/git-cli/providers/config.js.map +1 -1
- package/dist/git-cli/providers/operations.d.ts +6 -7
- package/dist/git-cli/providers/operations.js +46 -64
- package/dist/git-cli/providers/operations.js.map +1 -1
- package/dist/git-cli/providers/refs.d.ts +4 -1
- package/dist/git-cli/providers/refs.js +13 -9
- package/dist/git-cli/providers/refs.js.map +1 -1
- package/dist/git-cli/providers/revision.js +1 -1
- package/dist/git-cli/providers/stash.js +1 -1
- package/dist/git-cli/providers/worktrees.js +23 -6
- package/dist/git-cli/providers/worktrees.js.map +1 -1
- package/dist/git-cli/service.d.ts +3 -0
- package/dist/git-cli/service.js +1 -0
- package/dist/git-cli/service.js.map +1 -1
- package/dist/utils/env/node/exec.d.ts +38 -1
- package/dist/utils/env/node/exec.js +14 -6
- package/dist/utils/env/node/exec.js.map +1 -1
- package/package.json +1 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"refs.js","names":[],"sources":["../../../../git-cli/src/providers/refs.ts"],"sourcesContent":["import type { Cache } from '@gitlens/git/cache.js';\nimport type { GitServiceContext } from '@gitlens/git/context.js';\nimport { ReferenceUpdateError } from '@gitlens/git/errors.js';\nimport type { GitBranch } from '@gitlens/git/models/branch.js';\nimport type { GitReference, GitRefTip, RefRecord } from '@gitlens/git/models/reference.js';\nimport type { GitReflogEntry } from '@gitlens/git/models/reflog.js';\nimport { deletedOrMissing } from '@gitlens/git/models/revision.js';\nimport type { GitTag } from '@gitlens/git/models/tag.js';\nimport type { GitRefsSubProvider } from '@gitlens/git/providers/refs.js';\nimport type { GitCommandPriority } from '@gitlens/git/run.types.js';\nimport { isRemoteHEAD } from '@gitlens/git/utils/branch.utils.js';\nimport { createReference } from '@gitlens/git/utils/reference.utils.js';\nimport { isSha, isShaWithOptionalRevisionSuffix, isUncommitted } from '@gitlens/git/utils/revision.utils.js';\nimport { compareRefTips } from '@gitlens/git/utils/sorting.js';\nimport { CancellationError, isCancellationError } from '@gitlens/utils/cancellation.js';\nimport { debug, trace } from '@gitlens/utils/decorators/log.js';\nimport { createDisposable } from '@gitlens/utils/disposable.js';\nimport { getScopedLogger } from '@gitlens/utils/logger.scoped.js';\nimport { maybeStopWatch } from '@gitlens/utils/stopwatch.js';\nimport { iterateAsyncByDelimiter } from '@gitlens/utils/string.js';\nimport type { Uri } from '@gitlens/utils/uri.js';\nimport { toFsPath } from '@gitlens/utils/uri.js';\nimport type { CliGitProviderInternal } from '../cliGitProvider.js';\nimport type { GitResult } from '../exec/exec.types.js';\nimport type { Git, GitError } from '../exec/git.js';\nimport { getGitCommandError, gitConfigsBranch, gitConfigsLog } from '../exec/git.js';\nimport { getReflogEntryParser } from '../parsers/reflogParser.js';\nimport { getRefParser } from '../parsers/refParser.js';\n\nexport class RefsGitSubProvider implements GitRefsSubProvider {\n\tconstructor(\n\t\tprivate readonly context: GitServiceContext,\n\t\tprivate readonly git: Git,\n\t\tprivate readonly cache: Cache,\n\t\tprivate readonly provider: CliGitProviderInternal,\n\t) {}\n\n\t@debug()\n\tasync checkIfCouldBeValidBranchOrTagName(repoPath: string, ref: string): Promise<boolean> {\n\t\ttry {\n\t\t\tconst result = await this.git.run({ cwd: repoPath, errors: 'throw' }, 'check-ref-format', '--branch', ref);\n\t\t\treturn Boolean(result.stdout.trim());\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t/**\n\t * Raw `git for-each-ref` records covering branches, remotes, tags, and replace-refs in a single\n\t * pass. CLI-internal — siblings call via `this.provider.refs.getRefs(...)`. The `RefRecord` shape\n\t * is `for-each-ref`-specific and intentionally absent from the public `GitRefsSubProvider`\n\t * interface.\n\t */\n\t@debug()\n\tasync getRefs(repoPath: string, cancellation?: AbortSignal, options?: { force?: boolean }): Promise<RefRecord[]> {\n\t\tif (!repoPath) return [];\n\n\t\tconst scope = getScopedLogger();\n\n\t\t// Forces a fresh enumeration: evicts the shared cache entry (and the derived `refTips` projection,\n\t\t// which would otherwise still answer from the old records) so the factory below re-runs and\n\t\t// repopulates both from one spawn. Deliberately `delete`, not `invalidate` — soft-invalidation\n\t\t// leaves an in-flight entry rideable, so a caller needing a point-in-time read (the graph's tip\n\t\t// gate) could join an enumeration that started before the change it's trying to detect. Evicting\n\t\t// is safe mid-flight: the in-flight factory's settle is ownership-guarded and won't evict the\n\t\t// successor installed here.\n\t\tif (options?.force) {\n\t\t\tconst commonPath = this.cache.getCommonPath(repoPath);\n\t\t\tthis.cache.refs.delete(commonPath);\n\t\t\tthis.cache.refTips.delete(commonPath);\n\t\t}\n\n\t\treturn this.cache.getRefs(\n\t\t\trepoPath,\n\t\t\tasync (commonPath, cacheable, signal) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst supported = await this.git.supported('git:for-each-ref');\n\t\t\t\t\tconst parser = getRefParser(supported);\n\t\t\t\t\tconst result = await this.git.run(\n\t\t\t\t\t\t{ cwd: commonPath, cancellation: signal, configs: gitConfigsBranch, errors: 'ignore' },\n\t\t\t\t\t\t'for-each-ref',\n\t\t\t\t\t\t...parser.arguments,\n\t\t\t\t\t\t'refs/heads/',\n\t\t\t\t\t\t'refs/remotes/',\n\t\t\t\t\t\t'refs/tags/',\n\t\t\t\t\t\t// `git replace`/grafts — not surfaced to branch/tag/refTip consumers (filtered by\n\t\t\t\t\t\t// refname prefix), but needed by the graph's replace-ref change gate (graph.ts).\n\t\t\t\t\t\t'refs/replace/',\n\t\t\t\t\t);\n\t\t\t\t\t// Under `errors: 'ignore'` a cancelled run RESOLVES empty rather than throwing, so the\n\t\t\t\t\t// catch below never sees it and an empty enumeration would be cached as a real answer —\n\t\t\t\t\t// permanently, since this map has no TTL. Same guard `git.run`'s own caching path uses.\n\t\t\t\t\t// The graph's tip gate calls this with `force: true` and supersedes itself freely, so it\n\t\t\t\t\t// is routinely the sole registrant on the aggregate whose abort kills the spawn.\n\t\t\t\t\t// Covers a FAILED enumeration too, not just a cancelled one: a transient `for-each-ref`\n\t\t\t\t\t// failure (a lingering `index.lock`, EMFILE, the git dir briefly unavailable) also\n\t\t\t\t\t// resolves empty, and caching that `[]` would blank every branch, tag and ref-tip\n\t\t\t\t\t// consumer for the rest of the session. A genuinely ref-less repo still exits cleanly\n\t\t\t\t\t// with empty stdout, so it caches as before.\n\t\t\t\t\tif (result.completion.status !== 'exited' || result.exitCode !== 0 || signal?.aborted) {\n\t\t\t\t\t\tcacheable?.invalidate();\n\t\t\t\t\t\treturn [];\n\t\t\t\t\t}\n\t\t\t\t\tif (!result?.stdout) return [];\n\n\t\t\t\t\tusing sw = maybeStopWatch(scope, { log: { onlyExit: true, level: 'debug' } });\n\n\t\t\t\t\tconst records = [...parser.parse(result.stdout)];\n\n\t\t\t\t\tsw?.stop({ suffix: ` parsed ${records.length} ref records` });\n\n\t\t\t\t\treturn records;\n\t\t\t\t} catch (ex) {\n\t\t\t\t\tcacheable?.invalidate();\n\t\t\t\t\tif (isCancellationError(ex)) throw ex;\n\n\t\t\t\t\tscope?.error(ex);\n\t\t\t\t\treturn [];\n\t\t\t\t}\n\t\t\t},\n\t\t\tcancellation,\n\t\t);\n\t}\n\n\t@debug()\n\tasync getRefTips(\n\t\trepoPath: string,\n\t\toptions?: { include?: ReadonlyArray<'heads' | 'remotes' | 'tags'> },\n\t\tcancellation?: AbortSignal,\n\t): Promise<GitRefTip[]> {\n\t\tif (!repoPath) return [];\n\n\t\tconst scope = getScopedLogger();\n\n\t\t// Cache always holds the full set; subset filtering is applied on read so callers asking\n\t\t// for different subsets share one cache entry.\n\t\tconst all = await this.cache.getRefTips(\n\t\t\trepoPath,\n\t\t\tasync (_commonPath, _cacheable, signal) => {\n\t\t\t\tconst records = await this.getRefs(repoPath, signal);\n\n\t\t\t\tusing sw = maybeStopWatch(scope, { log: { onlyExit: true, level: 'debug' } });\n\n\t\t\t\tconst tips: GitRefTip[] = [];\n\t\t\t\tfor (const record of records) {\n\t\t\t\t\tconst fullName = record.name;\n\t\t\t\t\tif (!fullName) continue;\n\t\t\t\t\t// Skip refs/remotes/<remote>/HEAD — symbolic, not a real tip.\n\t\t\t\t\tif (isRemoteHEAD(fullName)) continue;\n\n\t\t\t\t\tlet type: GitRefTip['type'];\n\t\t\t\t\tlet name: string;\n\t\t\t\t\tif (fullName.startsWith('refs/heads/')) {\n\t\t\t\t\t\ttype = 'branch';\n\t\t\t\t\t\tname = fullName.substring(11);\n\t\t\t\t\t} else if (fullName.startsWith('refs/remotes/')) {\n\t\t\t\t\t\ttype = 'remote';\n\t\t\t\t\t\tname = fullName.substring(13);\n\t\t\t\t\t} else if (fullName.startsWith('refs/tags/')) {\n\t\t\t\t\t\ttype = 'tag';\n\t\t\t\t\t\tname = fullName.substring(10);\n\t\t\t\t\t} else {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\t// Annotated tags: peeledObjectname is the commit SHA; objectname is the tag-object SHA.\n\t\t\t\t\t// Lightweight tags / branches: peeledObjectname is empty; objectname is already the commit SHA.\n\t\t\t\t\tconst sha = record.peeledObjectname || record.objectname;\n\n\t\t\t\t\ttips.push({ type: type, name: name, fullName: fullName, sha: sha });\n\t\t\t\t}\n\n\t\t\t\tsw?.stop({ suffix: ` projected ${tips.length} ref tips` });\n\n\t\t\t\treturn tips;\n\t\t\t},\n\t\t\tcancellation,\n\t\t);\n\n\t\tconst include = options?.include;\n\t\tif (include == null || (include.includes('heads') && include.includes('remotes') && include.includes('tags'))) {\n\t\t\treturn all;\n\t\t}\n\n\t\treturn all.filter(r => {\n\t\t\tswitch (r.type) {\n\t\t\t\tcase 'branch':\n\t\t\t\t\treturn include.includes('heads');\n\t\t\t\tcase 'remote':\n\t\t\t\t\treturn include.includes('remotes');\n\t\t\t\tcase 'tag':\n\t\t\t\t\treturn include.includes('tags');\n\t\t\t}\n\t\t});\n\t}\n\n\t@debug()\n\tasync getRefsContainingShas(\n\t\trepoPath: string,\n\t\tshas: ReadonlySet<string> | readonly string[],\n\t\toldestSha: string,\n\t\toptions?: { include?: ReadonlyArray<'heads' | 'remotes' | 'tags'> },\n\t\tcancellation?: AbortSignal,\n\t): Promise<Map<string, GitRefTip[]>> {\n\t\tconst targetShas = shas instanceof Set ? shas : new Set(shas);\n\t\tif (!targetShas.size || !oldestSha) return new Map();\n\n\t\tconst scope = getScopedLogger();\n\n\t\tconst tips = await this.getRefTips(repoPath, options, cancellation);\n\t\tif (cancellation?.aborted) throw new CancellationError();\n\t\tif (!tips.length) return new Map();\n\n\t\t// Index tips by full ref name (for projection back to GitRefTip later) and seed the\n\t\t// propagation map by tip SHA. Multiple refs sharing a tip (e.g. local + remote-tracking)\n\t\t// collapse into one Set entry whose union covers all of them.\n\t\tconst tipsByName = new Map<string, GitRefTip>();\n\t\tconst propMap = new Map<string, Set<string>>();\n\t\tfor (const tip of tips) {\n\t\t\ttipsByName.set(tip.fullName, tip);\n\t\t\tlet names = propMap.get(tip.sha);\n\t\t\tif (names == null) {\n\t\t\t\tnames = new Set();\n\t\t\t\tpropMap.set(tip.sha, names);\n\t\t\t}\n\t\t\tnames.add(tip.fullName);\n\t\t}\n\n\t\tusing sw = maybeStopWatch(scope, { log: { onlyExit: true, level: 'debug' } });\n\n\t\t// `^<oldestSha>^@` excludes the parents of <oldestSha> and everything older. When <oldestSha>\n\t\t// is a root commit, `^@` resolves to nothing and the walk is naturally unbounded — git\n\t\t// doesn't error in that case (no negative refs to apply).\n\t\tconst stream = this.git.stream(\n\t\t\t{ cwd: repoPath, cancellation: cancellation, configs: gitConfigsBranch },\n\t\t\t'rev-list',\n\t\t\t'--topo-order',\n\t\t\t'--parents',\n\t\t\t'--all',\n\t\t\t`^${oldestSha}^@`,\n\t\t);\n\t\tusing _streamDisposer = createDisposable(() => void stream.return?.(undefined));\n\n\t\t// Topological propagation: `--topo-order` emits all children of X before X's own line, so\n\t\t// by the time we process \"X P1 P2...\" every child has already merged its set into X. We\n\t\t// then forward X's accumulated set to each parent — one-pass and correct.\n\t\ttry {\n\t\t\tfor await (const line of iterateAsyncByDelimiter(stream, '\\n')) {\n\t\t\t\tif (cancellation?.aborted) throw new CancellationError();\n\t\t\t\tif (!line) continue;\n\n\t\t\t\tconst firstSpace = line.indexOf(' ');\n\t\t\t\tconst sha = firstSpace === -1 ? line : line.substring(0, firstSpace);\n\t\t\t\tif (!sha) continue;\n\n\t\t\t\tconst refs = propMap.get(sha);\n\t\t\t\tif (!refs?.size) continue;\n\n\t\t\t\tif (firstSpace === -1) continue; // No parents — nothing to propagate to\n\n\t\t\t\t// Walk parent SHAs by index without splitting the whole line.\n\t\t\t\tlet start = firstSpace + 1;\n\t\t\t\twhile (start < line.length) {\n\t\t\t\t\tconst next = line.indexOf(' ', start);\n\t\t\t\t\tconst parentSha = next === -1 ? line.substring(start) : line.substring(start, next);\n\t\t\t\t\tif (parentSha) {\n\t\t\t\t\t\tlet parentRefs = propMap.get(parentSha);\n\t\t\t\t\t\tif (parentRefs == null) {\n\t\t\t\t\t\t\tparentRefs = new Set(refs);\n\t\t\t\t\t\t\tpropMap.set(parentSha, parentRefs);\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tfor (const name of refs) {\n\t\t\t\t\t\t\t\tparentRefs.add(name);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tif (next === -1) break;\n\n\t\t\t\t\tstart = next + 1;\n\t\t\t\t}\n\t\t\t}\n\t\t} catch (ex) {\n\t\t\tif (isCancellationError(ex)) throw ex;\n\n\t\t\tscope?.error(ex);\n\t\t\treturn new Map();\n\t\t}\n\n\t\t// Project to targets, materialize GitRefTip[], sort.\n\t\tconst result = new Map<string, GitRefTip[]>();\n\t\tfor (const sha of targetShas) {\n\t\t\tconst names = propMap.get(sha);\n\t\t\tif (!names?.size) continue;\n\n\t\t\tconst refs: GitRefTip[] = [];\n\t\t\tfor (const name of names) {\n\t\t\t\tconst tip = tipsByName.get(name);\n\t\t\t\tif (tip != null) {\n\t\t\t\t\trefs.push(tip);\n\t\t\t\t}\n\t\t\t}\n\t\t\trefs.sort(compareRefTips);\n\t\t\tresult.set(sha, refs);\n\t\t}\n\n\t\tsw?.stop({ suffix: ` resolved ${result.size}/${targetShas.size} target shas` });\n\n\t\treturn result;\n\t}\n\n\t@debug()\n\tasync getMergeBase(\n\t\trepoPath: string,\n\t\tref1: string,\n\t\tref2: string,\n\t\toptions?: { forkPoint?: boolean; priority?: GitCommandPriority },\n\t\tcancellation?: AbortSignal,\n\t): Promise<string | undefined> {\n\t\tconst scope = getScopedLogger();\n\n\t\ttry {\n\t\t\tconst result = await this.git.run(\n\t\t\t\t{\n\t\t\t\t\tcwd: repoPath,\n\t\t\t\t\tcancellation: cancellation,\n\t\t\t\t\t// Why: ref1/ref2 are usually branch names; correctness relies on the gitResults cache being\n\t\t\t\t\t// cleared on 'heads'/'remotes' events when refs move. Web (no fs watcher) sees up to\n\t\t\t\t\t// `accessTTL` of staleness — acceptable trade-off for the perf win on graph/branch reads.\n\t\t\t\t\tcaching: { cache: this.cache.gitResults, options: { accessTTL: 5 * 60 * 1000 } },\n\t\t\t\t\t...(options?.priority != null ? { priority: options.priority } : undefined),\n\t\t\t\t},\n\t\t\t\t'merge-base',\n\t\t\t\toptions?.forkPoint ? '--fork-point' : undefined,\n\t\t\t\tref1,\n\t\t\t\tref2,\n\t\t\t);\n\t\t\tif (!result.stdout) return undefined;\n\n\t\t\treturn result.stdout.split('\\n')[0].trim() || undefined;\n\t\t} catch (ex) {\n\t\t\tscope?.error(ex);\n\t\t\tif (isCancellationError(ex)) throw ex;\n\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\t@debug()\n\tasync getReflogEntries(\n\t\trepoPath: string,\n\t\tref: string,\n\t\toptions?: { grep?: string; priority?: GitCommandPriority },\n\t\tcancellation?: AbortSignal,\n\t): Promise<GitReflogEntry[]> {\n\t\t// `show` so a branch named `delete`, `expire` or `exists` isn't read as that subcommand, and the trailing\n\t\t// `--` so one named like a tracked file isn't rejected as ambiguous\n\t\tconst parser = getReflogEntryParser();\n\t\tconst args = ['reflog', 'show', ...parser.arguments];\n\t\tif (options?.grep) {\n\t\t\targs.push(`--grep-reflog=${options.grep}`);\n\t\t}\n\t\targs.push(ref, '--');\n\n\t\tconst result = await this.git.run(\n\t\t\t{\n\t\t\t\tcwd: repoPath,\n\t\t\t\terrors: 'throw',\n\t\t\t\tcancellation: cancellation,\n\t\t\t\t// A user's `log.showSignature` would print gpg output into the records\n\t\t\t\tconfigs: gitConfigsLog,\n\t\t\t\t...(options?.priority != null ? { priority: options.priority } : undefined),\n\t\t\t},\n\t\t\t...args,\n\t\t);\n\n\t\tconst entries: GitReflogEntry[] = [];\n\t\tfor (const entry of parser.parse(result.stdout)) {\n\t\t\tentries.push({ sha: entry.sha, message: entry.subject });\n\t\t}\n\t\treturn entries;\n\t}\n\n\t@debug()\n\tasync getReference(\n\t\trepoPath: string,\n\t\tref: string,\n\t\toptions?: { force?: boolean },\n\t\tcancellation?: AbortSignal,\n\t): Promise<GitReference | undefined> {\n\t\tif (!ref || ref === deletedOrMissing) return undefined;\n\n\t\tconst valid = options?.force\n\t\t\t? await this.validateReference(repoPath, ref, { force: true }, cancellation)\n\t\t\t: await this.isValidReference(repoPath, ref, undefined, cancellation);\n\t\tif (!valid) return undefined;\n\n\t\tif (ref !== 'HEAD' && !isShaWithOptionalRevisionSuffix(ref)) {\n\t\t\tconst branch = await this.provider.branches.getBranch(\n\t\t\t\trepoPath,\n\t\t\t\tref,\n\t\t\t\toptions?.force ? { force: true } : undefined,\n\t\t\t\tcancellation,\n\t\t\t);\n\t\t\tif (branch != null) {\n\t\t\t\treturn createReference(branch.ref, repoPath, {\n\t\t\t\t\tid: branch.id,\n\t\t\t\t\trefType: 'branch',\n\t\t\t\t\tname: branch.name,\n\t\t\t\t\tremote: branch.remote,\n\t\t\t\t\tupstream: branch.upstream,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\t// Not forced: a tag that moves is rare enough that `force` is scoped to branches and validation.\n\t\t\tconst tag = await this.provider.tags.getTag(repoPath, ref, cancellation);\n\t\t\tif (tag != null) {\n\t\t\t\treturn createReference(tag.ref, repoPath, {\n\t\t\t\t\tid: tag.id,\n\t\t\t\t\trefType: 'tag',\n\t\t\t\t\tname: tag.name,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\treturn createReference(ref, repoPath, { refType: 'revision' });\n\t}\n\n\t@debug()\n\tasync getSymbolicReferenceName(\n\t\trepoPath: string,\n\t\tref: string,\n\t\toptions?: { priority?: GitCommandPriority },\n\t\tcancellation?: AbortSignal,\n\t): Promise<string | undefined> {\n\t\tconst result = await this.runSymbolicReferenceName(repoPath, ref, options, cancellation);\n\t\treturn result.stdout.trim() || undefined;\n\t}\n\n\t/**\n\t * Like {@link getSymbolicReferenceName}, but tells a ref git confirmed doesn't exist (`rev-parse --verify` exit 1)\n\t * apart from a read that didn't complete (timeout, error, cancellation), which never reports `missing`.\n\t * Shares the same cached `rev-parse`, though only a found ref is cached: a missing one re-runs on every call.\n\t */\n\t@debug()\n\tasync getSymbolicReferenceNameOrMissing(\n\t\trepoPath: string,\n\t\tref: string,\n\t\toptions?: { priority?: GitCommandPriority },\n\t\tcancellation?: AbortSignal,\n\t): Promise<{ name: string | undefined; missing: boolean }> {\n\t\tconst result = await this.runSymbolicReferenceName(repoPath, ref, options, cancellation);\n\t\treturn {\n\t\t\tname: result.stdout.trim() || undefined,\n\t\t\tmissing: result.completion.status === 'exited' && result.completion.code === 1,\n\t\t};\n\t}\n\n\tprivate async runSymbolicReferenceName(\n\t\trepoPath: string,\n\t\tref: string,\n\t\toptions?: { priority?: GitCommandPriority },\n\t\tcancellation?: AbortSignal,\n\t): Promise<GitResult> {\n\t\tconst supportsEndOfOptions = await this.git.supports('git:rev-parse:end-of-options');\n\n\t\treturn this.git.run(\n\t\t\t{\n\t\t\t\tcwd: repoPath,\n\t\t\t\tcancellation: cancellation,\n\t\t\t\terrors: 'ignore',\n\t\t\t\t// Why: a fixed ref name's symbolic name is itself stable; only HEAD's, or whether the ref exists\n\t\t\t\t// at all, changes — and the gitResults cache is cleared on those ref events. 60s TTL is the failsafe\n\t\t\t\t// for watcher latency / web — matches the other \"resolve symbolic state\" calls in commits.ts.\n\t\t\t\tcaching: { cache: this.cache.gitResults, options: { accessTTL: 60 * 1000 } },\n\t\t\t\t...(options?.priority != null ? { priority: options.priority } : undefined),\n\t\t\t},\n\t\t\t'rev-parse',\n\t\t\t'--verify',\n\t\t\t'--quiet',\n\t\t\t'--symbolic-full-name',\n\t\t\t'--abbrev-ref',\n\t\t\tsupportsEndOfOptions ? '--end-of-options' : undefined,\n\t\t\tref,\n\t\t);\n\t}\n\n\t@debug({ args: repoPath => ({ repoPath: repoPath }) })\n\tasync hasBranchOrTag(\n\t\trepoPath: string | undefined,\n\t\toptions?: {\n\t\t\tfilter?: { branches?: (b: GitBranch) => boolean; tags?: (t: GitTag) => boolean };\n\t\t},\n\t\tcancellation?: AbortSignal,\n\t): Promise<boolean> {\n\t\tif (repoPath == null) return false;\n\n\t\tconst [{ values: branches }, { values: tags }] = await Promise.all([\n\t\t\tthis.provider.branches.getBranches(\n\t\t\t\trepoPath,\n\t\t\t\t{ filter: options?.filter?.branches, sort: false },\n\t\t\t\tcancellation,\n\t\t\t),\n\t\t\tthis.provider.tags.getTags(repoPath, { filter: options?.filter?.tags, sort: false }, cancellation),\n\t\t]);\n\n\t\treturn branches.length !== 0 || tags.length !== 0;\n\t}\n\n\t@debug()\n\tasync isValidReference(\n\t\trepoPath: string,\n\t\tref: string,\n\t\tpathOrUri?: string | Uri,\n\t\tcancellation?: AbortSignal,\n\t): Promise<boolean> {\n\t\tconst path = pathOrUri != null ? toFsPath(pathOrUri) : undefined;\n\t\tconst relativePath = path ? this.provider.getRelativePath(path, repoPath) : undefined;\n\t\treturn Boolean(\n\t\t\t(await this.validateReference(repoPath, ref, { relativePath: relativePath }, cancellation))?.length,\n\t\t);\n\t}\n\n\t@trace()\n\tasync validateReference(\n\t\trepoPath: string,\n\t\tref: string,\n\t\toptions?: { relativePath?: string; force?: boolean },\n\t\tcancellation?: AbortSignal,\n\t): Promise<string | undefined> {\n\t\tif (!ref) return undefined;\n\t\tif (ref === deletedOrMissing || isUncommitted(ref)) return ref;\n\n\t\tconst relativePath = options?.relativePath;\n\t\tconst supportsEndOfOptions = await this.git.supports('git:rev-parse:end-of-options');\n\n\t\t// Why: a SHA-only validation (no path suffix) is effectively immutable — 5-min TTL is safe.\n\t\t// Otherwise the resolved SHA can shift on ref move (or working-tree change for path-scoped\n\t\t// validation); rely on gitResults being cleared on 'head'/'heads'/'remotes' events, with 60s\n\t\t// TTL as the failsafe for watcher latency / web.\n\t\tconst stable = relativePath == null && isSha(ref);\n\t\tconst result = await this.git.run(\n\t\t\t{\n\t\t\t\tcwd: repoPath,\n\t\t\t\tcancellation: cancellation,\n\t\t\t\terrors: 'ignore',\n\t\t\t\tcaching: {\n\t\t\t\t\tcache: this.cache.gitResults,\n\t\t\t\t\toptions: { accessTTL: stable ? 5 * 60 * 1000 : 60 * 1000 },\n\t\t\t\t\tforce: options?.force,\n\t\t\t\t},\n\t\t\t},\n\t\t\t'rev-parse',\n\t\t\t'--verify',\n\t\t\tsupportsEndOfOptions ? '--end-of-options' : undefined,\n\t\t\trelativePath ? `${ref}:./${relativePath}` : `${ref}^{commit}`,\n\t\t);\n\t\treturn result.stdout.trim() || undefined;\n\t}\n\n\t@debug()\n\tasync deleteReference(\n\t\trepoPath: string,\n\t\tref: string,\n\t\toptions?: { expected?: string },\n\t\tcancellation?: AbortSignal,\n\t): Promise<void> {\n\t\tconst scope = getScopedLogger();\n\n\t\t// `--no-deref`: without it git deletes what a symbolic ref points to rather than the ref itself, so\n\t\t// deleting `refs/remotes/origin/HEAD` would take `origin/main` with it\n\t\tconst args = ['update-ref', '-d', '--no-deref', ref];\n\t\tif (options?.expected != null) {\n\t\t\targs.push(options.expected);\n\t\t}\n\n\t\t// `HEAD` is either the checked-out branch or, detached, the repository's own HEAD file — neither\n\t\t// may be deleted\n\t\tif (ref === 'HEAD') {\n\t\t\tthrow new ReferenceUpdateError({\n\t\t\t\treason: 'checkedOut',\n\t\t\t\taction: 'delete',\n\t\t\t\tref: ref,\n\t\t\t\tgitCommand: { repoPath: repoPath, args: args },\n\t\t\t});\n\t\t}\n\n\t\t// `update-ref -d` has none of `git branch -d`'s guards or cleanup, so a local branch gets them here:\n\t\t// deleting one checked out in a worktree would leave that worktree on a branch that no longer exists.\n\t\tconst branch = ref.startsWith('refs/heads/') ? ref.substring('refs/heads/'.length) : undefined;\n\t\tif (branch != null) {\n\t\t\t// Read git's worktree list directly rather than the cached one: that names a worktree's branch\n\t\t\t// only when the separately cached branch list has it, so a worktree or branch made outside core\n\t\t\t// since the last read would slip past this guard.\n\t\t\tconst result = await this.git.run(\n\t\t\t\t{ cwd: repoPath, cancellation: cancellation, errors: 'throw' },\n\t\t\t\t'worktree',\n\t\t\t\t'list',\n\t\t\t\t'--porcelain',\n\t\t\t);\n\t\t\tif (result.stdout.split('\\n').some(l => l.trim() === `branch ${ref}`)) {\n\t\t\t\tthrow new ReferenceUpdateError({\n\t\t\t\t\treason: 'checkedOut',\n\t\t\t\t\taction: 'delete',\n\t\t\t\t\tref: ref,\n\t\t\t\t\tgitCommand: { repoPath: repoPath, args: args },\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\ttry {\n\t\t\t// `errors: 'throw'`: the default handler resolves a `GitWarnings` match (e.g. \"not a git\n\t\t\t// repository\"), which would report a write that never happened as done\n\t\t\tawait this.git.run({ cwd: repoPath, cancellation: cancellation, errors: 'throw' }, ...args);\n\t\t} catch (ex) {\n\t\t\tscope?.error(ex);\n\t\t\tif (isCancellationError(ex)) throw ex;\n\n\t\t\tthrow getGitCommandError(\n\t\t\t\t'update-ref-delete',\n\t\t\t\tex as GitError,\n\t\t\t\treason =>\n\t\t\t\t\tnew ReferenceUpdateError(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\treason: reason,\n\t\t\t\t\t\t\taction: 'delete',\n\t\t\t\t\t\t\tref: ref,\n\t\t\t\t\t\t\tgitCommand: { repoPath: repoPath, args: args },\n\t\t\t\t\t\t},\n\t\t\t\t\t\tex as GitError,\n\t\t\t\t\t),\n\t\t\t);\n\t\t}\n\n\t\tif (branch != null) {\n\t\t\ttry {\n\t\t\t\t// What `git branch -d` removes itself (the upstream and other per-branch settings), then GitLens's own\n\t\t\t\tawait this.git.run(\n\t\t\t\t\t{ cwd: repoPath, errors: 'ignore' },\n\t\t\t\t\t'config',\n\t\t\t\t\t'--remove-section',\n\t\t\t\t\t`branch.${branch}`,\n\t\t\t\t);\n\t\t\t\tawait this.provider.branches.forgetDeletedBranch(repoPath, branch);\n\t\t\t} finally {\n\t\t\t\t// The ref is already gone, so announce even if the cleanup above fails. A single combined\n\t\t\t\t// reset/announce rather than this plus `fireReferenceChanged`'s own `'branches'`/`['heads']` —\n\t\t\t\t// a branch delete only needs one of each.\n\t\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'branches', 'config');\n\t\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['config', 'heads']);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tthis.fireReferenceChanged(repoPath, ref);\n\t}\n\n\t@debug()\n\tasync updateReference(\n\t\trepoPath: string,\n\t\tref: string,\n\t\tsha: string,\n\t\toptions?: { expected?: string | 'absent' },\n\t\tcancellation?: AbortSignal,\n\t): Promise<void> {\n\t\tconst scope = getScopedLogger();\n\n\t\tconst args = ['update-ref', ref, sha];\n\t\tif (options?.expected != null) {\n\t\t\t// Git's own compare-and-swap old-value argument, which makes the update atomic against a\n\t\t\t// concurrent writer. An EMPTY old value is how git spells \"the ref must not exist yet\"; the\n\t\t\t// empty string has to reach argv intact, which it does because the executor drops only\n\t\t\t// null/undefined.\n\t\t\targs.push(options.expected === 'absent' ? '' : options.expected);\n\t\t}\n\n\t\ttry {\n\t\t\tawait this.git.run({ cwd: repoPath, cancellation: cancellation, errors: 'throw' }, ...args);\n\t\t} catch (ex) {\n\t\t\tscope?.error(ex);\n\t\t\tif (isCancellationError(ex)) throw ex;\n\n\t\t\tthrow getGitCommandError(\n\t\t\t\t'update-ref',\n\t\t\t\tex as GitError,\n\t\t\t\treason =>\n\t\t\t\t\tnew ReferenceUpdateError(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\treason: reason,\n\t\t\t\t\t\t\taction: 'update',\n\t\t\t\t\t\t\tref: ref,\n\t\t\t\t\t\t\tgitCommand: { repoPath: repoPath, args: args },\n\t\t\t\t\t\t},\n\t\t\t\t\t\tex as GitError,\n\t\t\t\t\t),\n\t\t\t);\n\t\t}\n\n\t\tthis.fireReferenceChanged(repoPath, ref);\n\t}\n\n\t/** Announces a ref mutation to the cache and repository hooks. */\n\tprivate fireReferenceChanged(repoPath: string, ref: string): void {\n\t\tif (ref === 'HEAD') {\n\t\t\t// `update-ref HEAD` moves whatever HEAD resolves to — the checked-out branch, or a detached HEAD\n\t\t\t// — which also changes what the index and working tree are compared against.\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'branches', 'status');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['head', 'heads']);\n\t\t} else if (ref.startsWith('refs/heads/')) {\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'branches');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['heads']);\n\t\t} else if (ref.startsWith('refs/tags/')) {\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'tags');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['tags']);\n\t\t} else if (ref.startsWith('refs/remotes/')) {\n\t\t\t// Remote-tracking branches are read through the branch and ref-tip caches, which `'branches'`\n\t\t\t// clears; `'remotes'` covers only the configured remotes, which a ref write cannot change.\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'branches');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['remotes']);\n\t\t} else if (ref === 'refs/stash') {\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'stashes');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['stash']);\n\t\t}\n\t\t// A ref outside those namespaces (a consumer's own bookkeeping under `refs/<tool>/`) is visible to\n\t\t// nothing core caches, and announcing it as an unknown change would make a host refresh everything\n\t\t// for a write it cannot observe.\n\t}\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"refs.js","names":[],"sources":["../../../../git-cli/src/providers/refs.ts"],"sourcesContent":["import type { Cache } from '@gitlens/git/cache.js';\nimport type { GitServiceContext } from '@gitlens/git/context.js';\nimport { ReferenceUpdateError } from '@gitlens/git/errors.js';\nimport type { GitBranch } from '@gitlens/git/models/branch.js';\nimport type { GitReference, GitRefTip, RefRecord } from '@gitlens/git/models/reference.js';\nimport type { GitReflogEntry } from '@gitlens/git/models/reflog.js';\nimport { deletedOrMissing } from '@gitlens/git/models/revision.js';\nimport type { GitTag } from '@gitlens/git/models/tag.js';\nimport type { GitRefsSubProvider } from '@gitlens/git/providers/refs.js';\nimport type { GitCommandPriority } from '@gitlens/git/run.types.js';\nimport { isRemoteHEAD } from '@gitlens/git/utils/branch.utils.js';\nimport { createReference } from '@gitlens/git/utils/reference.utils.js';\nimport { isSha, isShaWithOptionalRevisionSuffix, isUncommitted } from '@gitlens/git/utils/revision.utils.js';\nimport { compareRefTips } from '@gitlens/git/utils/sorting.js';\nimport { CancellationError, isCancellationError } from '@gitlens/utils/cancellation.js';\nimport { debug, trace } from '@gitlens/utils/decorators/log.js';\nimport { createDisposable } from '@gitlens/utils/disposable.js';\nimport { getScopedLogger } from '@gitlens/utils/logger.scoped.js';\nimport { maybeStopWatch } from '@gitlens/utils/stopwatch.js';\nimport { iterateAsyncByDelimiter } from '@gitlens/utils/string.js';\nimport type { Uri } from '@gitlens/utils/uri.js';\nimport { toFsPath } from '@gitlens/utils/uri.js';\nimport type { CliGitProviderInternal } from '../cliGitProvider.js';\nimport type { GitResult } from '../exec/exec.types.js';\nimport type { Git, GitError } from '../exec/git.js';\nimport { getGitCommandError, gitConfigsBranch, gitConfigsLog } from '../exec/git.js';\nimport { getReflogEntryParser } from '../parsers/reflogParser.js';\nimport { getRefParser } from '../parsers/refParser.js';\n\nexport class RefsGitSubProvider implements GitRefsSubProvider {\n\tconstructor(\n\t\tprivate readonly context: GitServiceContext,\n\t\tprivate readonly git: Git,\n\t\tprivate readonly cache: Cache,\n\t\tprivate readonly provider: CliGitProviderInternal,\n\t) {}\n\n\t@debug()\n\tasync checkIfCouldBeValidBranchOrTagName(repoPath: string, ref: string): Promise<boolean> {\n\t\ttry {\n\t\t\tconst result = await this.git.run({ cwd: repoPath, errors: 'throw' }, 'check-ref-format', '--branch', ref);\n\t\t\treturn Boolean(result.stdout.trim());\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t/**\n\t * Raw `git for-each-ref` records covering branches, remotes, tags, and replace-refs in a single\n\t * pass. CLI-internal — siblings call via `this.provider.refs.getRefs(...)`. The `RefRecord` shape\n\t * is `for-each-ref`-specific and intentionally absent from the public `GitRefsSubProvider`\n\t * interface.\n\t */\n\t@debug()\n\tasync getRefs(repoPath: string, cancellation?: AbortSignal, options?: { force?: boolean }): Promise<RefRecord[]> {\n\t\tif (!repoPath) return [];\n\n\t\tconst scope = getScopedLogger();\n\n\t\t// Forces a fresh enumeration: evicts the shared cache entry (and the derived `refTips` projection,\n\t\t// which would otherwise still answer from the old records) so the factory below re-runs and\n\t\t// repopulates both from one spawn. Deliberately `delete`, not `invalidate` — soft-invalidation\n\t\t// leaves an in-flight entry rideable, so a caller needing a point-in-time read (the graph's tip\n\t\t// gate) could join an enumeration that started before the change it's trying to detect. Evicting\n\t\t// is safe mid-flight: the in-flight factory's settle is ownership-guarded and won't evict the\n\t\t// successor installed here.\n\t\tif (options?.force) {\n\t\t\tconst commonPath = this.cache.getCommonPath(repoPath);\n\t\t\tthis.cache.refs.delete(commonPath);\n\t\t\tthis.cache.refTips.delete(commonPath);\n\t\t}\n\n\t\treturn this.cache.getRefs(\n\t\t\trepoPath,\n\t\t\tasync (commonPath, cacheable, signal) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst supported = await this.git.supported('git:for-each-ref');\n\t\t\t\t\tconst parser = getRefParser(supported);\n\t\t\t\t\tconst result = await this.git.run(\n\t\t\t\t\t\t{ cwd: commonPath, cancellation: signal, configs: gitConfigsBranch, errors: 'ignore' },\n\t\t\t\t\t\t'for-each-ref',\n\t\t\t\t\t\t...parser.arguments,\n\t\t\t\t\t\t'refs/heads/',\n\t\t\t\t\t\t'refs/remotes/',\n\t\t\t\t\t\t'refs/tags/',\n\t\t\t\t\t\t// `git replace`/grafts — not surfaced to branch/tag/refTip consumers (filtered by\n\t\t\t\t\t\t// refname prefix), but needed by the graph's replace-ref change gate (graph.ts).\n\t\t\t\t\t\t'refs/replace/',\n\t\t\t\t\t);\n\t\t\t\t\t// Under `errors: 'ignore'` a cancelled run RESOLVES empty rather than throwing, so the\n\t\t\t\t\t// catch below never sees it and an empty enumeration would be cached as a real answer —\n\t\t\t\t\t// permanently, since this map has no TTL. Same guard `git.run`'s own caching path uses.\n\t\t\t\t\t// The graph's tip gate calls this with `force: true` and supersedes itself freely, so it\n\t\t\t\t\t// is routinely the sole registrant on the aggregate whose abort kills the spawn.\n\t\t\t\t\t// Covers a FAILED enumeration too, not just a cancelled one: a transient `for-each-ref`\n\t\t\t\t\t// failure (a lingering `index.lock`, EMFILE, the git dir briefly unavailable) also\n\t\t\t\t\t// resolves empty, and caching that `[]` would blank every branch, tag and ref-tip\n\t\t\t\t\t// consumer for the rest of the session. A genuinely ref-less repo still exits cleanly\n\t\t\t\t\t// with empty stdout, so it caches as before.\n\t\t\t\t\tif (result.completion.status !== 'exited' || result.exitCode !== 0 || signal?.aborted) {\n\t\t\t\t\t\tcacheable?.invalidate();\n\t\t\t\t\t\treturn [];\n\t\t\t\t\t}\n\t\t\t\t\tif (!result?.stdout) return [];\n\n\t\t\t\t\tusing sw = maybeStopWatch(scope, { log: { onlyExit: true, level: 'debug' } });\n\n\t\t\t\t\tconst records = [...parser.parse(result.stdout)];\n\n\t\t\t\t\tsw?.stop({ suffix: ` parsed ${records.length} ref records` });\n\n\t\t\t\t\treturn records;\n\t\t\t\t} catch (ex) {\n\t\t\t\t\tcacheable?.invalidate();\n\t\t\t\t\tif (isCancellationError(ex)) throw ex;\n\n\t\t\t\t\tscope?.error(ex);\n\t\t\t\t\treturn [];\n\t\t\t\t}\n\t\t\t},\n\t\t\tcancellation,\n\t\t);\n\t}\n\n\t@debug()\n\tasync getRefTips(\n\t\trepoPath: string,\n\t\toptions?: { include?: ReadonlyArray<'heads' | 'remotes' | 'tags'> },\n\t\tcancellation?: AbortSignal,\n\t): Promise<GitRefTip[]> {\n\t\tif (!repoPath) return [];\n\n\t\tconst scope = getScopedLogger();\n\n\t\t// Cache always holds the full set; subset filtering is applied on read so callers asking\n\t\t// for different subsets share one cache entry.\n\t\tconst all = await this.cache.getRefTips(\n\t\t\trepoPath,\n\t\t\tasync (_commonPath, _cacheable, signal) => {\n\t\t\t\tconst records = await this.getRefs(repoPath, signal);\n\n\t\t\t\tusing sw = maybeStopWatch(scope, { log: { onlyExit: true, level: 'debug' } });\n\n\t\t\t\tconst tips: GitRefTip[] = [];\n\t\t\t\tfor (const record of records) {\n\t\t\t\t\tconst fullName = record.name;\n\t\t\t\t\tif (!fullName) continue;\n\t\t\t\t\t// Skip refs/remotes/<remote>/HEAD — symbolic, not a real tip.\n\t\t\t\t\tif (isRemoteHEAD(fullName)) continue;\n\n\t\t\t\t\tlet type: GitRefTip['type'];\n\t\t\t\t\tlet name: string;\n\t\t\t\t\tif (fullName.startsWith('refs/heads/')) {\n\t\t\t\t\t\ttype = 'branch';\n\t\t\t\t\t\tname = fullName.substring(11);\n\t\t\t\t\t} else if (fullName.startsWith('refs/remotes/')) {\n\t\t\t\t\t\ttype = 'remote';\n\t\t\t\t\t\tname = fullName.substring(13);\n\t\t\t\t\t} else if (fullName.startsWith('refs/tags/')) {\n\t\t\t\t\t\ttype = 'tag';\n\t\t\t\t\t\tname = fullName.substring(10);\n\t\t\t\t\t} else {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\t// Annotated tags: peeledObjectname is the commit SHA; objectname is the tag-object SHA.\n\t\t\t\t\t// Lightweight tags / branches: peeledObjectname is empty; objectname is already the commit SHA.\n\t\t\t\t\tconst sha = record.peeledObjectname || record.objectname;\n\n\t\t\t\t\ttips.push({ type: type, name: name, fullName: fullName, sha: sha });\n\t\t\t\t}\n\n\t\t\t\tsw?.stop({ suffix: ` projected ${tips.length} ref tips` });\n\n\t\t\t\treturn tips;\n\t\t\t},\n\t\t\tcancellation,\n\t\t);\n\n\t\tconst include = options?.include;\n\t\tif (include == null || (include.includes('heads') && include.includes('remotes') && include.includes('tags'))) {\n\t\t\treturn all;\n\t\t}\n\n\t\treturn all.filter(r => {\n\t\t\tswitch (r.type) {\n\t\t\t\tcase 'branch':\n\t\t\t\t\treturn include.includes('heads');\n\t\t\t\tcase 'remote':\n\t\t\t\t\treturn include.includes('remotes');\n\t\t\t\tcase 'tag':\n\t\t\t\t\treturn include.includes('tags');\n\t\t\t}\n\t\t});\n\t}\n\n\t@debug()\n\tasync getRefsContainingShas(\n\t\trepoPath: string,\n\t\tshas: ReadonlySet<string> | readonly string[],\n\t\toldestSha: string,\n\t\toptions?: { include?: ReadonlyArray<'heads' | 'remotes' | 'tags'> },\n\t\tcancellation?: AbortSignal,\n\t): Promise<Map<string, GitRefTip[]>> {\n\t\tconst targetShas = shas instanceof Set ? shas : new Set(shas);\n\t\tif (!targetShas.size || !oldestSha) return new Map();\n\n\t\tconst scope = getScopedLogger();\n\n\t\tconst tips = await this.getRefTips(repoPath, options, cancellation);\n\t\tif (cancellation?.aborted) throw new CancellationError();\n\t\tif (!tips.length) return new Map();\n\n\t\t// Index tips by full ref name (for projection back to GitRefTip later) and seed the\n\t\t// propagation map by tip SHA. Multiple refs sharing a tip (e.g. local + remote-tracking)\n\t\t// collapse into one Set entry whose union covers all of them.\n\t\tconst tipsByName = new Map<string, GitRefTip>();\n\t\tconst propMap = new Map<string, Set<string>>();\n\t\tfor (const tip of tips) {\n\t\t\ttipsByName.set(tip.fullName, tip);\n\t\t\tlet names = propMap.get(tip.sha);\n\t\t\tif (names == null) {\n\t\t\t\tnames = new Set();\n\t\t\t\tpropMap.set(tip.sha, names);\n\t\t\t}\n\t\t\tnames.add(tip.fullName);\n\t\t}\n\n\t\tusing sw = maybeStopWatch(scope, { log: { onlyExit: true, level: 'debug' } });\n\n\t\t// `^<oldestSha>^@` excludes the parents of <oldestSha> and everything older. When <oldestSha>\n\t\t// is a root commit, `^@` resolves to nothing and the walk is naturally unbounded — git\n\t\t// doesn't error in that case (no negative refs to apply).\n\t\tconst stream = this.git.stream(\n\t\t\t{ cwd: repoPath, cancellation: cancellation, configs: gitConfigsBranch },\n\t\t\t'rev-list',\n\t\t\t'--topo-order',\n\t\t\t'--parents',\n\t\t\t'--all',\n\t\t\t`^${oldestSha}^@`,\n\t\t);\n\t\tusing _streamDisposer = createDisposable(() => void stream.return?.(undefined));\n\n\t\t// Topological propagation: `--topo-order` emits all children of X before X's own line, so\n\t\t// by the time we process \"X P1 P2...\" every child has already merged its set into X. We\n\t\t// then forward X's accumulated set to each parent — one-pass and correct.\n\t\ttry {\n\t\t\tfor await (const line of iterateAsyncByDelimiter(stream, '\\n')) {\n\t\t\t\tif (cancellation?.aborted) throw new CancellationError();\n\t\t\t\tif (!line) continue;\n\n\t\t\t\tconst firstSpace = line.indexOf(' ');\n\t\t\t\tconst sha = firstSpace === -1 ? line : line.substring(0, firstSpace);\n\t\t\t\tif (!sha) continue;\n\n\t\t\t\tconst refs = propMap.get(sha);\n\t\t\t\tif (!refs?.size) continue;\n\n\t\t\t\tif (firstSpace === -1) continue; // No parents — nothing to propagate to\n\n\t\t\t\t// Walk parent SHAs by index without splitting the whole line.\n\t\t\t\tlet start = firstSpace + 1;\n\t\t\t\twhile (start < line.length) {\n\t\t\t\t\tconst next = line.indexOf(' ', start);\n\t\t\t\t\tconst parentSha = next === -1 ? line.substring(start) : line.substring(start, next);\n\t\t\t\t\tif (parentSha) {\n\t\t\t\t\t\tlet parentRefs = propMap.get(parentSha);\n\t\t\t\t\t\tif (parentRefs == null) {\n\t\t\t\t\t\t\tparentRefs = new Set(refs);\n\t\t\t\t\t\t\tpropMap.set(parentSha, parentRefs);\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tfor (const name of refs) {\n\t\t\t\t\t\t\t\tparentRefs.add(name);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tif (next === -1) break;\n\n\t\t\t\t\tstart = next + 1;\n\t\t\t\t}\n\t\t\t}\n\t\t} catch (ex) {\n\t\t\tif (isCancellationError(ex)) throw ex;\n\n\t\t\tscope?.error(ex);\n\t\t\treturn new Map();\n\t\t}\n\n\t\t// Project to targets, materialize GitRefTip[], sort.\n\t\tconst result = new Map<string, GitRefTip[]>();\n\t\tfor (const sha of targetShas) {\n\t\t\tconst names = propMap.get(sha);\n\t\t\tif (!names?.size) continue;\n\n\t\t\tconst refs: GitRefTip[] = [];\n\t\t\tfor (const name of names) {\n\t\t\t\tconst tip = tipsByName.get(name);\n\t\t\t\tif (tip != null) {\n\t\t\t\t\trefs.push(tip);\n\t\t\t\t}\n\t\t\t}\n\t\t\trefs.sort(compareRefTips);\n\t\t\tresult.set(sha, refs);\n\t\t}\n\n\t\tsw?.stop({ suffix: ` resolved ${result.size}/${targetShas.size} target shas` });\n\n\t\treturn result;\n\t}\n\n\t@debug()\n\tasync getMergeBase(\n\t\trepoPath: string,\n\t\tref1: string,\n\t\tref2: string,\n\t\toptions?: { forkPoint?: boolean; priority?: GitCommandPriority },\n\t\tcancellation?: AbortSignal,\n\t): Promise<string | undefined> {\n\t\tconst scope = getScopedLogger();\n\n\t\ttry {\n\t\t\tconst result = await this.git.run(\n\t\t\t\t{\n\t\t\t\t\tcwd: repoPath,\n\t\t\t\t\tcancellation: cancellation,\n\t\t\t\t\t// Why: ref1/ref2 are usually branch names; correctness relies on the gitResults cache being\n\t\t\t\t\t// cleared on 'heads'/'remotes' events when refs move. Web (no fs watcher) sees up to\n\t\t\t\t\t// `accessTTL` of staleness — acceptable trade-off for the perf win on graph/branch reads.\n\t\t\t\t\tcaching: { cache: this.cache.gitResults, options: { accessTTL: 5 * 60 * 1000 } },\n\t\t\t\t\t...(options?.priority != null ? { priority: options.priority } : undefined),\n\t\t\t\t},\n\t\t\t\t'merge-base',\n\t\t\t\toptions?.forkPoint ? '--fork-point' : undefined,\n\t\t\t\tref1,\n\t\t\t\tref2,\n\t\t\t);\n\t\t\tif (!result.stdout) return undefined;\n\n\t\t\treturn result.stdout.split('\\n')[0].trim() || undefined;\n\t\t} catch (ex) {\n\t\t\tscope?.error(ex);\n\t\t\tif (isCancellationError(ex)) throw ex;\n\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\t@debug()\n\tasync getReflogEntries(\n\t\trepoPath: string,\n\t\tref: string,\n\t\toptions?: { grep?: string; priority?: GitCommandPriority },\n\t\tcancellation?: AbortSignal,\n\t): Promise<GitReflogEntry[]> {\n\t\t// `show` so a branch named `delete`, `expire` or `exists` isn't read as that subcommand, and the trailing\n\t\t// `--` so one named like a tracked file isn't rejected as ambiguous\n\t\tconst parser = getReflogEntryParser();\n\t\tconst args = ['reflog', 'show', ...parser.arguments];\n\t\tif (options?.grep) {\n\t\t\targs.push(`--grep-reflog=${options.grep}`);\n\t\t}\n\t\targs.push(ref, '--');\n\n\t\tconst result = await this.git.run(\n\t\t\t{\n\t\t\t\tcwd: repoPath,\n\t\t\t\terrors: 'throw',\n\t\t\t\tcancellation: cancellation,\n\t\t\t\t// A user's `log.showSignature` would print gpg output into the records\n\t\t\t\tconfigs: gitConfigsLog,\n\t\t\t\t...(options?.priority != null ? { priority: options.priority } : undefined),\n\t\t\t},\n\t\t\t...args,\n\t\t);\n\n\t\tconst entries: GitReflogEntry[] = [];\n\t\tfor (const entry of parser.parse(result.stdout)) {\n\t\t\tentries.push({ sha: entry.sha, message: entry.subject });\n\t\t}\n\t\treturn entries;\n\t}\n\n\t@debug()\n\tasync getReference(\n\t\trepoPath: string,\n\t\tref: string,\n\t\toptions?: { force?: boolean },\n\t\tcancellation?: AbortSignal,\n\t): Promise<GitReference | undefined> {\n\t\tif (!ref || ref === deletedOrMissing) return undefined;\n\n\t\tconst valid = options?.force\n\t\t\t? await this.validateReference(repoPath, ref, { force: true }, cancellation)\n\t\t\t: await this.isValidReference(repoPath, ref, undefined, cancellation);\n\t\tif (!valid) return undefined;\n\n\t\tif (ref !== 'HEAD' && !isShaWithOptionalRevisionSuffix(ref)) {\n\t\t\tconst branch = await this.provider.branches.getBranch(\n\t\t\t\trepoPath,\n\t\t\t\tref,\n\t\t\t\toptions?.force ? { force: true } : undefined,\n\t\t\t\tcancellation,\n\t\t\t);\n\t\t\tif (branch != null) {\n\t\t\t\treturn createReference(branch.ref, repoPath, {\n\t\t\t\t\tid: branch.id,\n\t\t\t\t\trefType: 'branch',\n\t\t\t\t\tname: branch.name,\n\t\t\t\t\tremote: branch.remote,\n\t\t\t\t\tupstream: branch.upstream,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\t// Not forced: a tag that moves is rare enough that `force` is scoped to branches and validation.\n\t\t\tconst tag = await this.provider.tags.getTag(repoPath, ref, cancellation);\n\t\t\tif (tag != null) {\n\t\t\t\treturn createReference(tag.ref, repoPath, {\n\t\t\t\t\tid: tag.id,\n\t\t\t\t\trefType: 'tag',\n\t\t\t\t\tname: tag.name,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\treturn createReference(ref, repoPath, { refType: 'revision' });\n\t}\n\n\t@debug()\n\tasync getSymbolicReferenceName(\n\t\trepoPath: string,\n\t\tref: string,\n\t\toptions?: { priority?: GitCommandPriority },\n\t\tcancellation?: AbortSignal,\n\t): Promise<string | undefined> {\n\t\tconst result = await this.runSymbolicReferenceName(repoPath, ref, options, cancellation);\n\t\treturn result.stdout.trim() || undefined;\n\t}\n\n\t/**\n\t * Like {@link getSymbolicReferenceName}, but tells a ref git confirmed doesn't exist (`rev-parse --verify` exit 1)\n\t * apart from a read that didn't complete (timeout, error, cancellation), which never reports `missing`.\n\t * Shares the same cached `rev-parse`, though only a found ref is cached: a missing one re-runs on every call.\n\t */\n\t@debug()\n\tasync getSymbolicReferenceNameOrMissing(\n\t\trepoPath: string,\n\t\tref: string,\n\t\toptions?: { priority?: GitCommandPriority },\n\t\tcancellation?: AbortSignal,\n\t): Promise<{ name: string | undefined; missing: boolean }> {\n\t\tconst result = await this.runSymbolicReferenceName(repoPath, ref, options, cancellation);\n\t\treturn {\n\t\t\tname: result.stdout.trim() || undefined,\n\t\t\tmissing: result.completion.status === 'exited' && result.completion.code === 1,\n\t\t};\n\t}\n\n\tprivate async runSymbolicReferenceName(\n\t\trepoPath: string,\n\t\tref: string,\n\t\toptions?: { priority?: GitCommandPriority },\n\t\tcancellation?: AbortSignal,\n\t): Promise<GitResult> {\n\t\tconst supportsEndOfOptions = await this.git.supports('git:rev-parse:end-of-options');\n\n\t\treturn this.git.run(\n\t\t\t{\n\t\t\t\tcwd: repoPath,\n\t\t\t\tcancellation: cancellation,\n\t\t\t\terrors: 'ignore',\n\t\t\t\t// Why: a fixed ref name's symbolic name is itself stable; only HEAD's, or whether the ref exists\n\t\t\t\t// at all, changes — and the gitResults cache is cleared on those ref events. 60s TTL is the failsafe\n\t\t\t\t// for watcher latency / web — matches the other \"resolve symbolic state\" calls in commits.ts.\n\t\t\t\tcaching: { cache: this.cache.gitResults, options: { accessTTL: 60 * 1000 } },\n\t\t\t\t...(options?.priority != null ? { priority: options.priority } : undefined),\n\t\t\t},\n\t\t\t'rev-parse',\n\t\t\t'--verify',\n\t\t\t'--quiet',\n\t\t\t'--symbolic-full-name',\n\t\t\t'--abbrev-ref',\n\t\t\tsupportsEndOfOptions ? '--end-of-options' : undefined,\n\t\t\tref,\n\t\t);\n\t}\n\n\t@debug({ args: repoPath => ({ repoPath: repoPath }) })\n\tasync hasBranchOrTag(\n\t\trepoPath: string | undefined,\n\t\toptions?: {\n\t\t\tfilter?: { branches?: (b: GitBranch) => boolean; tags?: (t: GitTag) => boolean };\n\t\t},\n\t\tcancellation?: AbortSignal,\n\t): Promise<boolean> {\n\t\tif (repoPath == null) return false;\n\n\t\tconst [{ values: branches }, { values: tags }] = await Promise.all([\n\t\t\tthis.provider.branches.getBranches(\n\t\t\t\trepoPath,\n\t\t\t\t{ filter: options?.filter?.branches, sort: false },\n\t\t\t\tcancellation,\n\t\t\t),\n\t\t\tthis.provider.tags.getTags(repoPath, { filter: options?.filter?.tags, sort: false }, cancellation),\n\t\t]);\n\n\t\treturn branches.length !== 0 || tags.length !== 0;\n\t}\n\n\t@debug()\n\tasync isValidReference(\n\t\trepoPath: string,\n\t\tref: string,\n\t\tpathOrUri?: string | Uri,\n\t\tcancellation?: AbortSignal,\n\t): Promise<boolean> {\n\t\tconst path = pathOrUri != null ? toFsPath(pathOrUri) : undefined;\n\t\tconst relativePath = path ? this.provider.getRelativePath(path, repoPath) : undefined;\n\t\treturn Boolean(\n\t\t\t(await this.validateReference(repoPath, ref, { relativePath: relativePath }, cancellation))?.length,\n\t\t);\n\t}\n\n\t@trace()\n\tasync validateReference(\n\t\trepoPath: string,\n\t\tref: string,\n\t\toptions?: { relativePath?: string; force?: boolean },\n\t\tcancellation?: AbortSignal,\n\t): Promise<string | undefined> {\n\t\tif (!ref) return undefined;\n\t\tif (ref === deletedOrMissing || isUncommitted(ref)) return ref;\n\n\t\tconst relativePath = options?.relativePath;\n\t\tconst supportsEndOfOptions = await this.git.supports('git:rev-parse:end-of-options');\n\n\t\t// Why: a SHA-only validation (no path suffix) is effectively immutable — 5-min TTL is safe.\n\t\t// Otherwise the resolved SHA can shift on ref move (or working-tree change for path-scoped\n\t\t// validation); rely on gitResults being cleared on 'head'/'heads'/'remotes' events, with 60s\n\t\t// TTL as the failsafe for watcher latency / web.\n\t\tconst stable = relativePath == null && isSha(ref);\n\t\tconst result = await this.git.run(\n\t\t\t{\n\t\t\t\tcwd: repoPath,\n\t\t\t\tcancellation: cancellation,\n\t\t\t\terrors: 'ignore',\n\t\t\t\tcaching: {\n\t\t\t\t\tcache: this.cache.gitResults,\n\t\t\t\t\toptions: { accessTTL: stable ? 5 * 60 * 1000 : 60 * 1000 },\n\t\t\t\t\tforce: options?.force,\n\t\t\t\t},\n\t\t\t},\n\t\t\t'rev-parse',\n\t\t\t'--verify',\n\t\t\tsupportsEndOfOptions ? '--end-of-options' : undefined,\n\t\t\trelativePath ? `${ref}:./${relativePath}` : `${ref}^{commit}`,\n\t\t);\n\t\treturn result.stdout.trim() || undefined;\n\t}\n\n\t@debug()\n\tasync deleteReference(\n\t\trepoPath: string,\n\t\tref: string,\n\t\toptions?: { expected?: string },\n\t\tcancellation?: AbortSignal,\n\t): Promise<void> {\n\t\tconst scope = getScopedLogger();\n\n\t\t// `--no-deref`: without it git deletes what a symbolic ref points to rather than the ref itself, so\n\t\t// deleting `refs/remotes/origin/HEAD` would take `origin/main` with it\n\t\tconst args = ['update-ref', '-d', '--no-deref', ref];\n\t\tif (options?.expected != null) {\n\t\t\targs.push(options.expected);\n\t\t}\n\n\t\t// `HEAD` is either the checked-out branch or, detached, the repository's own HEAD file — neither\n\t\t// may be deleted\n\t\tif (ref === 'HEAD') {\n\t\t\tthrow new ReferenceUpdateError({\n\t\t\t\treason: 'checkedOut',\n\t\t\t\taction: 'delete',\n\t\t\t\tref: ref,\n\t\t\t\tgitCommand: { repoPath: repoPath, args: args },\n\t\t\t});\n\t\t}\n\n\t\t// `update-ref -d` has none of `git branch -d`'s guards or cleanup, so a local branch gets them here:\n\t\t// deleting one checked out in a worktree would leave that worktree on a branch that no longer exists.\n\t\tconst branch = ref.startsWith('refs/heads/') ? ref.substring('refs/heads/'.length) : undefined;\n\t\tif (branch != null) {\n\t\t\t// Read git's worktree list directly rather than the cached one: that names a worktree's branch\n\t\t\t// only when the separately cached branch list has it, so a worktree or branch made outside core\n\t\t\t// since the last read would slip past this guard.\n\t\t\tconst result = await this.git.run(\n\t\t\t\t{ cwd: repoPath, cancellation: cancellation, errors: 'throw' },\n\t\t\t\t'worktree',\n\t\t\t\t'list',\n\t\t\t\t'--porcelain',\n\t\t\t);\n\t\t\tif (result.stdout.split('\\n').some(l => l.trim() === `branch ${ref}`)) {\n\t\t\t\tthrow new ReferenceUpdateError({\n\t\t\t\t\treason: 'checkedOut',\n\t\t\t\t\taction: 'delete',\n\t\t\t\t\tref: ref,\n\t\t\t\t\tgitCommand: { repoPath: repoPath, args: args },\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\ttry {\n\t\t\t// `errors: 'throw'`: the default handler resolves a `GitWarnings` match (e.g. \"not a git\n\t\t\t// repository\"), which would report a write that never happened as done\n\t\t\tawait this.git.run({ cwd: repoPath, cancellation: cancellation, errors: 'throw' }, ...args);\n\t\t} catch (ex) {\n\t\t\tscope?.error(ex);\n\t\t\tif (isCancellationError(ex)) throw ex;\n\n\t\t\tthrow getGitCommandError(\n\t\t\t\t'update-ref-delete',\n\t\t\t\tex as GitError,\n\t\t\t\treason =>\n\t\t\t\t\tnew ReferenceUpdateError(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\treason: reason,\n\t\t\t\t\t\t\taction: 'delete',\n\t\t\t\t\t\t\tref: ref,\n\t\t\t\t\t\t\tgitCommand: { repoPath: repoPath, args: args },\n\t\t\t\t\t\t},\n\t\t\t\t\t\tex as GitError,\n\t\t\t\t\t),\n\t\t\t);\n\t\t}\n\n\t\tif (branch != null) {\n\t\t\ttry {\n\t\t\t\t// What `git branch -d` removes itself (the upstream and other per-branch settings), then GitLens's own\n\t\t\t\tawait this.git.run(\n\t\t\t\t\t{ cwd: repoPath, errors: 'ignore' },\n\t\t\t\t\t'config',\n\t\t\t\t\t'--remove-section',\n\t\t\t\t\t`branch.${branch}`,\n\t\t\t\t);\n\t\t\t\tawait this.provider.branches.forgetDeletedBranch(repoPath, branch);\n\t\t\t} finally {\n\t\t\t\t// The ref is already gone, so announce even if the cleanup above fails. A single combined\n\t\t\t\t// reset/announce rather than this plus `fireReferenceChanged`'s own `'branches'`/`['heads']` —\n\t\t\t\t// a branch delete only needs one of each. The config change is the branch's own section.\n\t\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'branches', 'config');\n\t\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['config', 'heads'], [ref], {\n\t\t\t\t\tconfigConfinedToRefs: true,\n\t\t\t\t});\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tthis.fireReferenceChanged(repoPath, ref, false);\n\t}\n\n\t@debug()\n\tasync updateReference(\n\t\trepoPath: string,\n\t\tref: string,\n\t\tsha: string,\n\t\toptions?: { expected?: string | 'absent' },\n\t\tcancellation?: AbortSignal,\n\t): Promise<void> {\n\t\tconst scope = getScopedLogger();\n\n\t\tconst args = ['update-ref', ref, sha];\n\t\tif (options?.expected != null) {\n\t\t\t// Git's own compare-and-swap old-value argument, which makes the update atomic against a\n\t\t\t// concurrent writer. An EMPTY old value is how git spells \"the ref must not exist yet\"; the\n\t\t\t// empty string has to reach argv intact, which it does because the executor drops only\n\t\t\t// null/undefined.\n\t\t\targs.push(options.expected === 'absent' ? '' : options.expected);\n\t\t}\n\n\t\ttry {\n\t\t\tawait this.git.run({ cwd: repoPath, cancellation: cancellation, errors: 'throw' }, ...args);\n\t\t} catch (ex) {\n\t\t\tscope?.error(ex);\n\t\t\tif (isCancellationError(ex)) throw ex;\n\n\t\t\tthrow getGitCommandError(\n\t\t\t\t'update-ref',\n\t\t\t\tex as GitError,\n\t\t\t\treason =>\n\t\t\t\t\tnew ReferenceUpdateError(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\treason: reason,\n\t\t\t\t\t\t\taction: 'update',\n\t\t\t\t\t\t\tref: ref,\n\t\t\t\t\t\t\tgitCommand: { repoPath: repoPath, args: args },\n\t\t\t\t\t\t},\n\t\t\t\t\t\tex as GitError,\n\t\t\t\t\t),\n\t\t\t);\n\t\t}\n\n\t\tthis.fireReferenceChanged(repoPath, ref, true);\n\t}\n\n\t/**\n\t * Announces a ref mutation to the cache and repository hooks. `deref` says git followed a symbolic `ref` (no\n\t * `--no-deref`), so a remote's `HEAD` moved the branch it points to and stays unnamed.\n\t */\n\tprivate fireReferenceChanged(repoPath: string, ref: string, deref: boolean): void {\n\t\tconst refs = deref && ref.endsWith('/HEAD') ? undefined : [ref];\n\t\tif (ref === 'HEAD') {\n\t\t\t// `update-ref HEAD` moves whatever HEAD resolves to — the checked-out branch, or a detached HEAD\n\t\t\t// — which also changes what the index and working tree are compared against.\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'branches', 'status');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['head', 'heads']);\n\t\t} else if (ref.startsWith('refs/heads/')) {\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'branches');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['heads'], refs);\n\t\t} else if (ref.startsWith('refs/tags/')) {\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'tags');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['tags'], refs);\n\t\t} else if (ref.startsWith('refs/remotes/')) {\n\t\t\t// Remote-tracking branches are read through the branch and ref-tip caches, which `'branches'`\n\t\t\t// clears; `'remotes'` covers only the configured remotes, which a ref write cannot change.\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'branches');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['remotes'], refs);\n\t\t} else if (ref === 'refs/stash') {\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'stashes');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['stash'], refs);\n\t\t}\n\t\t// A ref outside those namespaces (a consumer's own bookkeeping under `refs/<tool>/`) is in no cached ref\n\t\t// list, and announcing it as an unknown change would make a host refresh everything for it. Only a\n\t\t// `git log --all` walk (graph, search, contributors) sees one, when it points at a commit, so a row it\n\t\t// adds or drops can stay stale until the next heads change.\n\t}\n}\n"],"mappings":"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"}
|
|
@@ -9,8 +9,8 @@ import { isRevisionWithSuffix, isSha, isUncommitted, isUncommittedStaged, isUnco
|
|
|
9
9
|
import __decorate from "../../_virtual/@oxc-project+runtime/helpers/esm/decorate.js";
|
|
10
10
|
import { ShowError } from "../../git/errors.js";
|
|
11
11
|
import { GitErrors, batchLiteralPathspecs, defaultExceptionHandler, getGitCommandError, gitConfigsLog } from "../exec/git.js";
|
|
12
|
-
import { getShaAndFileSummaryLogParser } from "../parsers/logParser.js";
|
|
13
12
|
import { gate } from "../../utils/decorators/gate.js";
|
|
13
|
+
import { getShaAndFileSummaryLogParser } from "../parsers/logParser.js";
|
|
14
14
|
import { parseGitLsFilesStaged } from "../parsers/indexParser.js";
|
|
15
15
|
import { parseGitTree } from "../parsers/treeParser.js";
|
|
16
16
|
//#region ../git-cli/src/providers/revision.ts
|
|
@@ -12,9 +12,9 @@ import { GitError, GitErrors, getGitCommandError, isRunHookFailure } from "../ex
|
|
|
12
12
|
import { GitFileWorkingTreeStatus } from "../../git/models/fileStatus.js";
|
|
13
13
|
import { GitFileChange } from "../../git/models/fileChange.js";
|
|
14
14
|
import { GitCommit, GitCommitIdentity } from "../../git/models/commit.js";
|
|
15
|
+
import { gate } from "../../utils/decorators/gate.js";
|
|
15
16
|
import { getStashFilesOnlyLogParser, getStashLogParser } from "../parsers/logParser.js";
|
|
16
17
|
import { createCommitFileset } from "./commitFilesetUtils.js";
|
|
17
|
-
import { gate } from "../../utils/decorators/gate.js";
|
|
18
18
|
import * as l10n from "@vscode/l10n";
|
|
19
19
|
//#region ../git-cli/src/providers/stash.ts
|
|
20
20
|
/** The one ref a stash write moves: a push, pop, drop or store changes `refs/stash` or its reflog, never another ref */
|
|
@@ -20,6 +20,13 @@ import { promises } from "fs";
|
|
|
20
20
|
function getLockReason(ex) {
|
|
21
21
|
return GitErrors.worktreeLockedReason.exec(ex.stderr || ex.stdout || ex.message || "")?.[1].trim() || void 0;
|
|
22
22
|
}
|
|
23
|
+
/**
|
|
24
|
+
* The branch `git worktree add` says it created, from the `Preparing worktree (new branch '<name>')` line it writes to
|
|
25
|
+
* stderr (git 2.17+, in English since every run sets `LC_ALL=C`)
|
|
26
|
+
*/
|
|
27
|
+
function getNewWorktreeBranch(stderr) {
|
|
28
|
+
return stderr ? /^Preparing worktree \(new branch '(.+)'\)$/m.exec(stderr)?.[1] : void 0;
|
|
29
|
+
}
|
|
23
30
|
var WorktreesGitSubProvider = class {
|
|
24
31
|
context;
|
|
25
32
|
git;
|
|
@@ -44,15 +51,21 @@ var WorktreesGitSubProvider = class {
|
|
|
44
51
|
if (options?.detach) args.push("--detach");
|
|
45
52
|
args.push(path);
|
|
46
53
|
if (options?.commitish) args.push(options.commitish);
|
|
54
|
+
let createdBranch = options?.createBranch;
|
|
55
|
+
let mayHaveCreatedBranch = false;
|
|
47
56
|
try {
|
|
48
|
-
await this.git.run({
|
|
57
|
+
const result = await this.git.run({
|
|
49
58
|
cwd: repoPath,
|
|
50
59
|
...runOptions
|
|
51
60
|
}, ...args);
|
|
52
|
-
|
|
61
|
+
createdBranch ??= getNewWorktreeBranch(result.stderr);
|
|
53
62
|
} catch (ex) {
|
|
54
63
|
scope?.error(ex);
|
|
55
|
-
|
|
64
|
+
createdBranch ??= getNewWorktreeBranch(ex?.stderr);
|
|
65
|
+
if (isCancellationError(ex) || isRunHookFailure(ex)) {
|
|
66
|
+
mayHaveCreatedBranch = createdBranch == null && !options?.detach;
|
|
67
|
+
throw ex;
|
|
68
|
+
}
|
|
56
69
|
throw getGitCommandError("worktree-create", ex, (reason) => new WorktreeCreateError({
|
|
57
70
|
reason,
|
|
58
71
|
gitCommand: {
|
|
@@ -61,13 +74,17 @@ var WorktreesGitSubProvider = class {
|
|
|
61
74
|
}
|
|
62
75
|
}, ex));
|
|
63
76
|
} finally {
|
|
64
|
-
if (
|
|
65
|
-
this.
|
|
77
|
+
if (createdBranch) {
|
|
78
|
+
this.cache.deleteBaseBranchName(repoPath, createdBranch);
|
|
79
|
+
this.context.hooks?.cache?.onReset?.(repoPath, ...!options?.createBranch || mayWriteTracking(options.commitish, options.noTracking) ? [
|
|
66
80
|
"branches",
|
|
67
81
|
"config",
|
|
68
82
|
"worktrees"
|
|
69
83
|
] : ["branches", "worktrees"]);
|
|
70
|
-
this.context.hooks?.repository?.onChanged?.(repoPath, ["worktrees", "heads"], [`refs/heads/${
|
|
84
|
+
this.context.hooks?.repository?.onChanged?.(repoPath, ["worktrees", "heads"], [`refs/heads/${createdBranch}`]);
|
|
85
|
+
} else if (mayHaveCreatedBranch) {
|
|
86
|
+
this.context.hooks?.cache?.onReset?.(repoPath, "branches", "config", "worktrees");
|
|
87
|
+
this.context.hooks?.repository?.onChanged?.(repoPath, ["worktrees", "heads"]);
|
|
71
88
|
} else {
|
|
72
89
|
this.context.hooks?.cache?.onReset?.(repoPath, "worktrees");
|
|
73
90
|
this.context.hooks?.repository?.onChanged?.(repoPath, ["worktrees"]);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"worktrees.js","names":["basename","fs"],"sources":["../../../../git-cli/src/providers/worktrees.ts"],"sourcesContent":["import { exec } from 'child_process';\nimport { promises as fs } from 'fs';\nimport { join, resolve } from 'path';\nimport * as l10n from '@vscode/l10n';\nimport type { Cache } from '@gitlens/git/cache.js';\nimport type { GitServiceContext } from '@gitlens/git/context.js';\nimport { WorktreeCreateError, WorktreeDeleteError } from '@gitlens/git/errors.js';\nimport type { WorkspaceFolderResolver } from '@gitlens/git/models/worktree.js';\nimport { GitWorktree } from '@gitlens/git/models/worktree.js';\nimport type { GitOperationRunOptions } from '@gitlens/git/providers/operations.js';\nimport type { GitWorktreesSubProvider } from '@gitlens/git/providers/worktrees.js';\nimport { isCancellationError } from '@gitlens/utils/cancellation.js';\nimport { debug } from '@gitlens/utils/decorators/log.js';\nimport { isWindows } from '@gitlens/utils/env/node/platform.js';\nimport { getScopedLogger } from '@gitlens/utils/logger.scoped.js';\nimport { basename, normalizePath } from '@gitlens/utils/path.js';\nimport { getSettledValue } from '@gitlens/utils/promise.js';\nimport type { Uri } from '@gitlens/utils/uri.js';\nimport { fileUri, toFsPath } from '@gitlens/utils/uri.js';\nimport type { CliGitProviderInternal } from '../cliGitProvider.js';\nimport { mayWriteTracking } from '../exec/commandClassifier.js';\nimport type { Git, GitError } from '../exec/git.js';\nimport { getGitCommandError, GitErrors, isRunHookFailure } from '../exec/git.js';\nimport { parseGitWorktrees } from '../parsers/worktreeParser.js';\n\n/** Extracts the lock reason from Git's `cannot remove a locked working tree` output, when it provides one */\nfunction getLockReason(ex: GitError): string | undefined {\n\treturn GitErrors.worktreeLockedReason.exec(ex.stderr || ex.stdout || ex.message || '')?.[1].trim() || undefined;\n}\n\nexport class WorktreesGitSubProvider implements GitWorktreesSubProvider {\n\tconstructor(\n\t\tprivate readonly context: GitServiceContext,\n\t\tprivate readonly git: Git,\n\t\tprivate readonly cache: Cache,\n\t\tprivate readonly provider: CliGitProviderInternal,\n\t) {}\n\n\t/**\n\t * Creates a worktree (`git worktree add`). `runOptions` are spread into the underlying `git.run` call, so a\n\t * large checkout can run without the default command timeout (`{ timeout: 0 }`) and still be cancelled.\n\t */\n\t@debug()\n\tasync createWorktree(\n\t\trepoPath: string,\n\t\tpath: string,\n\t\toptions?: {\n\t\t\tcommitish?: string;\n\t\t\tcreateBranch?: string;\n\t\t\tdetach?: boolean;\n\t\t\tforce?: boolean;\n\t\t\tnoTracking?: boolean;\n\t\t},\n\t\trunOptions?: GitOperationRunOptions,\n\t): Promise<void> {\n\t\tconst scope = getScopedLogger();\n\n\t\tconst args = ['worktree', 'add'];\n\t\tif (options?.force) {\n\t\t\targs.push('--force');\n\t\t}\n\t\tif (options?.createBranch) {\n\t\t\targs.push('-b', options.createBranch);\n\t\t}\n\t\tif (options?.createBranch && options.noTracking) {\n\t\t\targs.push('--no-track');\n\t\t}\n\t\tif (options?.detach) {\n\t\t\targs.push('--detach');\n\t\t}\n\t\targs.push(path);\n\t\tif (options?.commitish) {\n\t\t\targs.push(options.commitish);\n\t\t}\n\n\t\ttry {\n\t\t\tawait this.git.run({ cwd: repoPath, ...runOptions }, ...args);\n\n\t\t\tif (options?.createBranch) {\n\t\t\t\t// Evict the cached base only — see `checkout -b` for why the persisted keys are left alone.\n\t\t\t\tthis.cache.deleteBaseBranchName(repoPath, options.createBranch);\n\t\t\t}\n\t\t} catch (ex) {\n\t\t\tscope?.error(ex);\n\t\t\t// A cancelled or timed-out checkout, or a host-rejected index-lock retry, is not git refusing the worktree\n\t\t\tif (isCancellationError(ex) || isRunHookFailure(ex)) throw ex;\n\n\t\t\tthrow getGitCommandError(\n\t\t\t\t'worktree-create',\n\t\t\t\tex as GitError,\n\t\t\t\treason =>\n\t\t\t\t\tnew WorktreeCreateError(\n\t\t\t\t\t\t{ reason: reason, gitCommand: { repoPath: repoPath, args: args } },\n\t\t\t\t\t\tex as GitError,\n\t\t\t\t\t),\n\t\t\t);\n\t\t} finally {\n\t\t\t// A failed or cancelled add may already have created the branch (and its tracking in `.git/config`) or\n\t\t\t// the worktree directory.\n\t\t\t//\n\t\t\t// The tracking isn't announced as a `config` change, only evicted: git may also write repository-wide\n\t\t\t// keys (`extensions.relativeWorktrees` under `worktree.useRelativePaths`), so the write can't claim its\n\t\t\t// config change is confined to the new branch, and an unconfined one would refresh every worktree on each\n\t\t\t// add. The watcher's report of the file says what changed in it instead.\n\t\t\tif (options?.createBranch) {\n\t\t\t\tthis.context.hooks?.cache?.onReset?.(\n\t\t\t\t\trepoPath,\n\t\t\t\t\t...(mayWriteTracking(options.commitish, options.noTracking)\n\t\t\t\t\t\t? (['branches', 'config', 'worktrees'] as const)\n\t\t\t\t\t\t: (['branches', 'worktrees'] as const)),\n\t\t\t\t);\n\t\t\t\tthis.context.hooks?.repository?.onChanged?.(\n\t\t\t\t\trepoPath,\n\t\t\t\t\t['worktrees', 'heads'],\n\t\t\t\t\t[`refs/heads/${options.createBranch}`],\n\t\t\t\t);\n\t\t\t} else {\n\t\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'worktrees');\n\t\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['worktrees']);\n\t\t\t}\n\t\t}\n\t}\n\n\tasync createWorktreeWithResult(\n\t\trepoPath: string,\n\t\tpath: string,\n\t\toptions?: {\n\t\t\tcommitish?: string;\n\t\t\tcreateBranch?: string;\n\t\t\tdetach?: boolean;\n\t\t\tforce?: boolean;\n\t\t\tnoTracking?: boolean;\n\t\t},\n\t\trunOptions?: GitOperationRunOptions,\n\t): Promise<GitWorktree | undefined> {\n\t\tawait this.createWorktree(repoPath, path, options, runOptions);\n\t\tconst normalized = normalizePath(path);\n\t\treturn this.getWorktree(repoPath, w => normalizePath(w.path) === normalized, runOptions?.cancellation);\n\t}\n\n\t@debug()\n\tasync getWorktree(\n\t\trepoPath: string,\n\t\tpredicate: (w: GitWorktree) => boolean,\n\t\tcancellation?: AbortSignal,\n\t): Promise<GitWorktree | undefined> {\n\t\treturn (await this.getWorktrees(repoPath, cancellation)).find(predicate);\n\t}\n\n\t@debug()\n\tasync getWorktrees(repoPath: string, cancellation?: AbortSignal): Promise<GitWorktree[]> {\n\t\tawait this.git.ensureSupports('git:worktrees', (requiredVersion, installedVersion) =>\n\t\t\tl10n.t(\n\t\t\t\t'Displaying worktrees requires a newer version of Git (>= {0}) than is currently installed ({1}). Please install a more recent version of Git and try again.',\n\t\t\t\trequiredVersion,\n\t\t\t\tinstalledVersion,\n\t\t\t),\n\t\t);\n\n\t\treturn this.cache.getWorktrees(\n\t\t\trepoPath,\n\t\t\tasync (commonPath, cacheable, signal) => {\n\t\t\t\t// Prefer the aggregate signal from the cache; fall back to the caller's cancellation.\n\t\t\t\tsignal ??= cancellation;\n\t\t\t\tconst [dataResult, branchesResult] = await Promise.allSettled([\n\t\t\t\t\tthis.git.run({ cwd: commonPath, cancellation: signal }, 'worktree', 'list', '--porcelain'),\n\t\t\t\t\tthis.provider.branches.getBranches(commonPath, undefined, signal),\n\t\t\t\t]);\n\n\t\t\t\tif (dataResult.status === 'rejected') {\n\t\t\t\t\t// Don't cache a bogus empty result for a transient command failure — retry on next access.\n\t\t\t\t\tcacheable.invalidate();\n\t\t\t\t}\n\n\t\t\t\tconst getWorkspaceFolder: WorkspaceFolderResolver | undefined = this.context.workspace\n\t\t\t\t\t? uri => {\n\t\t\t\t\t\t\tconst folder = this.context.workspace!.getFolder(uri.fsPath);\n\t\t\t\t\t\t\tif (folder == null) return undefined;\n\t\t\t\t\t\t\treturn { uri: fileUri(folder.path), name: basename(folder.path) };\n\t\t\t\t\t\t}\n\t\t\t\t\t: undefined;\n\n\t\t\t\tconst worktrees = parseGitWorktrees(\n\t\t\t\t\tgetSettledValue(dataResult)?.stdout,\n\t\t\t\t\tcommonPath,\n\t\t\t\t\tgetSettledValue(branchesResult)?.values ?? [],\n\t\t\t\t\tgetWorkspaceFolder,\n\t\t\t\t);\n\n\t\t\t\t// Older git prints a bare `locked` even when a reason exists; recover it from the admin dir\n\t\t\t\tif (await this.git.supports('git:worktree:list:lock-reason')) return worktrees;\n\n\t\t\t\treturn Promise.all(worktrees.map(w => this.withLockReason(w)));\n\t\t\t},\n\t\t\tcancellation,\n\t\t);\n\t}\n\n\tprivate async withLockReason(worktree: GitWorktree): Promise<GitWorktree> {\n\t\tif (worktree.locked !== true || worktree.isDefault || worktree.type === 'bare') return worktree;\n\n\t\ttry {\n\t\t\t// A linked worktree's `.git` is a file: `gitdir: <admin dir>`, relative to the worktree when not absolute\n\t\t\tconst dotGit = join(worktree.uri.fsPath, '.git');\n\t\t\tconst match = /^gitdir:\\s*(.+?)\\s*$/m.exec(await fs.readFile(dotGit, 'utf8'));\n\t\t\tif (match == null) return worktree;\n\n\t\t\tconst reason = (await fs.readFile(join(resolve(worktree.uri.fsPath, match[1]), 'locked'), 'utf8')).trim();\n\t\t\tif (!reason) return worktree;\n\n\t\t\treturn new GitWorktree(\n\t\t\t\tworktree.isDefault,\n\t\t\t\tworktree.type,\n\t\t\t\tworktree.repoPath,\n\t\t\t\tworktree.uri,\n\t\t\t\treason,\n\t\t\t\tworktree.prunable,\n\t\t\t\tworktree.sha,\n\t\t\t\tworktree.branch,\n\t\t\t\tworktree.workspaceFolder,\n\t\t\t);\n\t\t} catch {\n\t\t\treturn worktree;\n\t\t}\n\t}\n\n\t@debug()\n\tgetWorktreesDefaultUri(repoPath: string): Uri | undefined {\n\t\treturn this.context.workspace?.getWorktreeDefaultUri?.(repoPath);\n\t}\n\n\t/**\n\t * Deletes a worktree (`git worktree remove`). Pass `force: 'locked'` to also override a locked worktree.\n\t *\n\t * `runOptions` are spread into the underlying `git.run` call (e.g. `{ timeout: 0 }` for a large worktree\n\t * whose removal may exceed the default command timeout).\n\t *\n\t * On failure, the thrown {@link WorktreeDeleteError}'s `original` property carries the raw\n\t * {@link GitError} (stderr/stdout/exit code) untouched — a caller that needs to classify a\n\t * platform-specific failure (e.g. a Windows file-lock retry) can read it directly rather than parsing\n\t * the typed error's message.\n\t */\n\t@debug()\n\tasync deleteWorktree(\n\t\trepoPath: string,\n\t\tpath: string | Uri,\n\t\toptions?: { force?: boolean | 'locked' },\n\t\trunOptions?: GitOperationRunOptions,\n\t): Promise<void> {\n\t\tconst scope = getScopedLogger();\n\n\t\tawait this.git.ensureSupports('git:worktrees', (requiredVersion, installedVersion) =>\n\t\t\tl10n.t(\n\t\t\t\t'Deleting worktrees requires a newer version of Git (>= {0}) than is currently installed ({1}). Please install a more recent version of Git and try again.',\n\t\t\t\trequiredVersion,\n\t\t\t\tinstalledVersion,\n\t\t\t),\n\t\t);\n\n\t\tconst args = ['worktree', 'remove'];\n\t\tif (options?.force) {\n\t\t\targs.push('--force');\n\t\t\t// Git requires a second `--force` to remove a locked worktree\n\t\t\tif (options.force === 'locked') {\n\t\t\t\targs.push('--force');\n\t\t\t}\n\t\t}\n\n\t\tconst pathStr = normalizePath(toFsPath(path));\n\t\targs.push(pathStr);\n\n\t\tlet deleted = false;\n\t\ttry {\n\t\t\tawait this.git.run({ cwd: repoPath, errors: 'throw', ...runOptions }, ...args);\n\t\t\tdeleted = true;\n\t\t} catch (ex) {\n\t\t\tscope?.error(ex);\n\t\t\t// A cancelled or timed-out removal (`runOptions.cancellation`/`timeout`), or a host-rejected index-lock\n\t\t\t// retry, is not git refusing it, and wrapping it would hand the caller a `WorktreeDeleteError` whose\n\t\t\t// `original` is no `GitError` at all\n\t\t\tif (isCancellationError(ex) || isRunHookFailure(ex)) throw ex;\n\n\t\t\tconst gitError = getGitCommandError(\n\t\t\t\t'worktree-delete',\n\t\t\t\tex as GitError,\n\t\t\t\treason =>\n\t\t\t\t\tnew WorktreeDeleteError(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\treason: reason,\n\t\t\t\t\t\t\tlockReason: reason === 'locked' ? getLockReason(ex as GitError) : undefined,\n\t\t\t\t\t\t\tgitCommand: { repoPath: repoPath, args: args },\n\t\t\t\t\t\t},\n\t\t\t\t\t\tex as GitError,\n\t\t\t\t\t),\n\t\t\t);\n\n\t\t\tif (gitError.details.reason === 'directoryNotEmpty') {\n\t\t\t\tscope?.warn(\n\t\t\t\t\t`Failed to fully delete worktree '${pathStr}' because it is not empty. Attempting to delete it manually.`,\n\t\t\t\t);\n\t\t\t\ttry {\n\t\t\t\t\tawait fs.rm(pathStr, { force: true, recursive: true });\n\t\t\t\t\tdeleted = true;\n\t\t\t\t\treturn;\n\t\t\t\t} catch (ex) {\n\t\t\t\t\tif (isWindows) {\n\t\t\t\t\t\tconst match = /EPERM: operation not permitted, unlink '(.*?)'/i.exec((ex as GitError).message);\n\t\t\t\t\t\tif (match != null) {\n\t\t\t\t\t\t\tscope?.warn(\n\t\t\t\t\t\t\t\t`Failed to manually delete '${pathStr}' because it is in use. Attempting to forcefully delete it.`,\n\t\t\t\t\t\t\t);\n\n\t\t\t\t\t\t\t// Windows-specific: `del` via cmd.exe to force-remove a locked symlink.\n\t\t\t\t\t\t\t// Node's fs.rm/unlink fails with EPERM when the symlink target is in use.\n\t\t\t\t\t\t\tfunction deleteInUseSymlink(symlink: string) {\n\t\t\t\t\t\t\t\treturn new Promise((resolve, reject) => {\n\t\t\t\t\t\t\t\t\texec(`del \"${symlink}\"`, (ex, stdout, stderr) => {\n\t\t\t\t\t\t\t\t\t\tif (ex) {\n\t\t\t\t\t\t\t\t\t\t\treject(ex instanceof Error ? ex : new Error(String(ex)));\n\t\t\t\t\t\t\t\t\t\t} else if (stderr) {\n\t\t\t\t\t\t\t\t\t\t\treject(new Error(stderr));\n\t\t\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\t\t\tresolve(stdout);\n\t\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tconst [, file] = match;\n\t\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\t\tawait deleteInUseSymlink(file);\n\t\t\t\t\t\t\t\tawait fs.rm(pathStr, { force: true, recursive: true, maxRetries: 1, retryDelay: 1 });\n\t\t\t\t\t\t\t\tdeleted = true;\n\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t} catch (ex) {\n\t\t\t\t\t\t\t\tscope?.error(ex, `Failed to forcefully delete '${pathStr}' because it is in use.`);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tthrow gitError;\n\t\t} finally {\n\t\t\tif (deleted) {\n\t\t\t\t// Clean up Cache registry + per-worktree cache entries for the deleted worktree.\n\t\t\t\t// Order matters: unregister before emitting the repo-level change so any listener\n\t\t\t\t// that re-queries worktree-aware state sees the registry already updated.\n\t\t\t\tthis.cache.unregisterRepoPath(pathStr);\n\t\t\t}\n\t\t\t// A failed or cancelled removal may already have taken the worktree's files or admin entry\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'worktrees');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['worktrees']);\n\t\t}\n\t}\n\n\t@debug()\n\tasync pruneWorktrees(repoPath: string, options?: { expire?: string }): Promise<void> {\n\t\tawait this.git.ensureSupports('git:worktrees', (requiredVersion, installedVersion) =>\n\t\t\tl10n.t(\n\t\t\t\t'Pruning worktrees requires a newer version of Git (>= {0}) than is currently installed ({1}). Please install a more recent version of Git and try again.',\n\t\t\t\trequiredVersion,\n\t\t\t\tinstalledVersion,\n\t\t\t),\n\t\t);\n\n\t\tconst before = await this.listWorktreePaths(repoPath);\n\n\t\tconst args = ['worktree', 'prune'];\n\t\tif (options?.expire) {\n\t\t\targs.push('--expire', options.expire);\n\t\t}\n\n\t\ttry {\n\t\t\tawait this.git.run({ cwd: repoPath, errors: 'throw' }, ...args);\n\n\t\t\tconst after = await this.listWorktreePaths(repoPath);\n\n\t\t\t// Order matters (see `deleteWorktree`): unregister before emitting the repo-level change so any\n\t\t\t// listener that re-queries worktree-aware state sees the registry already updated.\n\t\t\tif (before != null && after != null) {\n\t\t\t\tfor (const path of before) {\n\t\t\t\t\tif (!after.has(path)) {\n\t\t\t\t\t\tthis.cache.unregisterRepoPath(path);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t} finally {\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'worktrees');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['worktrees']);\n\t\t}\n\t}\n\n\t/**\n\t * Raw worktree paths currently known to git (`worktree <path>` lines from `--porcelain`), normalized the\n\t * same way {@link deleteWorktree} does. A failed listing (`errors: 'ignore'`) yields an empty set rather\n\t * than throwing — used by `pruneWorktrees` to diff before/after, where a transient read failure must not\n\t * be mistaken for every worktree having vanished.\n\t */\n\tprivate async listWorktreePaths(repoPath: string): Promise<Set<string> | undefined> {\n\t\tconst result = await this.git.run({ cwd: repoPath, errors: 'ignore' }, 'worktree', 'list', '--porcelain');\n\t\t// A failed listing is not an empty one: read as empty, the after-prune one would unregister everything\n\t\tif (result.completion.status !== 'exited' || result.exitCode !== 0) return undefined;\n\n\t\tconst paths = new Set<string>();\n\t\tfor (const line of result.stdout.split('\\n')) {\n\t\t\tif (line.startsWith('worktree ')) {\n\t\t\t\tpaths.add(normalizePath(toFsPath(line.slice('worktree '.length).trim())));\n\t\t\t}\n\t\t}\n\t\treturn paths;\n\t}\n\n\t@debug()\n\tasync lockWorktree(repoPath: string, path: string | Uri, options?: { reason?: string }): Promise<void> {\n\t\tawait this.git.ensureSupports('git:worktrees', (requiredVersion, installedVersion) =>\n\t\t\tl10n.t(\n\t\t\t\t'Locking worktrees requires a newer version of Git (>= {0}) than is currently installed ({1}). Please install a more recent version of Git and try again.',\n\t\t\t\trequiredVersion,\n\t\t\t\tinstalledVersion,\n\t\t\t),\n\t\t);\n\n\t\tconst args = ['worktree', 'lock'];\n\t\tif (options?.reason) {\n\t\t\targs.push('--reason', options.reason);\n\t\t}\n\t\targs.push(normalizePath(toFsPath(path)));\n\n\t\ttry {\n\t\t\tawait this.git.run({ cwd: repoPath, errors: 'throw' }, ...args);\n\t\t} finally {\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'worktrees');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['worktrees']);\n\t\t}\n\t}\n\n\t@debug()\n\tasync unlockWorktree(repoPath: string, path: string | Uri): Promise<void> {\n\t\tawait this.git.ensureSupports('git:worktrees', (requiredVersion, installedVersion) =>\n\t\t\tl10n.t(\n\t\t\t\t'Unlocking worktrees requires a newer version of Git (>= {0}) than is currently installed ({1}). Please install a more recent version of Git and try again.',\n\t\t\t\trequiredVersion,\n\t\t\t\tinstalledVersion,\n\t\t\t),\n\t\t);\n\n\t\tconst pathStr = normalizePath(toFsPath(path));\n\t\ttry {\n\t\t\tawait this.git.run({ cwd: repoPath, errors: 'throw' }, 'worktree', 'unlock', pathStr);\n\t\t} finally {\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'worktrees');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['worktrees']);\n\t\t}\n\t}\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"worktrees.js","names":["basename","fs"],"sources":["../../../../git-cli/src/providers/worktrees.ts"],"sourcesContent":["import { exec } from 'child_process';\nimport { promises as fs } from 'fs';\nimport { join, resolve } from 'path';\nimport * as l10n from '@vscode/l10n';\nimport type { Cache } from '@gitlens/git/cache.js';\nimport type { GitServiceContext } from '@gitlens/git/context.js';\nimport { WorktreeCreateError, WorktreeDeleteError } from '@gitlens/git/errors.js';\nimport type { WorkspaceFolderResolver } from '@gitlens/git/models/worktree.js';\nimport { GitWorktree } from '@gitlens/git/models/worktree.js';\nimport type { GitOperationRunOptions } from '@gitlens/git/providers/operations.js';\nimport type { GitWorktreesSubProvider } from '@gitlens/git/providers/worktrees.js';\nimport { isCancellationError } from '@gitlens/utils/cancellation.js';\nimport { debug } from '@gitlens/utils/decorators/log.js';\nimport { isWindows } from '@gitlens/utils/env/node/platform.js';\nimport { getScopedLogger } from '@gitlens/utils/logger.scoped.js';\nimport { basename, normalizePath } from '@gitlens/utils/path.js';\nimport { getSettledValue } from '@gitlens/utils/promise.js';\nimport type { Uri } from '@gitlens/utils/uri.js';\nimport { fileUri, toFsPath } from '@gitlens/utils/uri.js';\nimport type { CliGitProviderInternal } from '../cliGitProvider.js';\nimport { mayWriteTracking } from '../exec/commandClassifier.js';\nimport type { Git, GitError } from '../exec/git.js';\nimport { getGitCommandError, GitErrors, isRunHookFailure } from '../exec/git.js';\nimport { parseGitWorktrees } from '../parsers/worktreeParser.js';\n\n/** Extracts the lock reason from Git's `cannot remove a locked working tree` output, when it provides one */\nfunction getLockReason(ex: GitError): string | undefined {\n\treturn GitErrors.worktreeLockedReason.exec(ex.stderr || ex.stdout || ex.message || '')?.[1].trim() || undefined;\n}\n\n/**\n * The branch `git worktree add` says it created, from the `Preparing worktree (new branch '<name>')` line it writes to\n * stderr (git 2.17+, in English since every run sets `LC_ALL=C`)\n */\nfunction getNewWorktreeBranch(stderr: string | undefined): string | undefined {\n\treturn stderr ? /^Preparing worktree \\(new branch '(.+)'\\)$/m.exec(stderr)?.[1] : undefined;\n}\n\nexport class WorktreesGitSubProvider implements GitWorktreesSubProvider {\n\tconstructor(\n\t\tprivate readonly context: GitServiceContext,\n\t\tprivate readonly git: Git,\n\t\tprivate readonly cache: Cache,\n\t\tprivate readonly provider: CliGitProviderInternal,\n\t) {}\n\n\t/**\n\t * Creates a worktree (`git worktree add`). `runOptions` are spread into the underlying `git.run` call, so a\n\t * large checkout can run without the default command timeout (`{ timeout: 0 }`) and still be cancelled.\n\t */\n\t@debug()\n\tasync createWorktree(\n\t\trepoPath: string,\n\t\tpath: string,\n\t\toptions?: {\n\t\t\tcommitish?: string;\n\t\t\tcreateBranch?: string;\n\t\t\tdetach?: boolean;\n\t\t\tforce?: boolean;\n\t\t\tnoTracking?: boolean;\n\t\t},\n\t\trunOptions?: GitOperationRunOptions,\n\t): Promise<void> {\n\t\tconst scope = getScopedLogger();\n\n\t\tconst args = ['worktree', 'add'];\n\t\tif (options?.force) {\n\t\t\targs.push('--force');\n\t\t}\n\t\tif (options?.createBranch) {\n\t\t\targs.push('-b', options.createBranch);\n\t\t}\n\t\tif (options?.createBranch && options.noTracking) {\n\t\t\targs.push('--no-track');\n\t\t}\n\t\tif (options?.detach) {\n\t\t\targs.push('--detach');\n\t\t}\n\t\targs.push(path);\n\t\tif (options?.commitish) {\n\t\t\targs.push(options.commitish);\n\t\t}\n\n\t\t// Without `-b`, git may still create a branch: from a remote branch of the commitish's name, or named after the\n\t\t// path when no commitish is given\n\t\tlet createdBranch = options?.createBranch;\n\t\t// A cancelled or timed-out run, or a host-rejected retry, leaves no output to name the branch git may have created\n\t\tlet mayHaveCreatedBranch = false;\n\t\ttry {\n\t\t\tconst result = await this.git.run({ cwd: repoPath, ...runOptions }, ...args);\n\t\t\tcreatedBranch ??= getNewWorktreeBranch(result.stderr);\n\t\t} catch (ex) {\n\t\t\tscope?.error(ex);\n\t\t\t// `?.`: a host's index-lock retry hook may reject with anything, `undefined` included\n\t\t\tcreatedBranch ??= getNewWorktreeBranch((ex as GitError | undefined)?.stderr);\n\n\t\t\t// A cancelled or timed-out checkout, or a host-rejected index-lock retry, is not git refusing the worktree\n\t\t\tif (isCancellationError(ex) || isRunHookFailure(ex)) {\n\t\t\t\tmayHaveCreatedBranch = createdBranch == null && !options?.detach;\n\t\t\t\tthrow ex;\n\t\t\t}\n\n\t\t\tthrow getGitCommandError(\n\t\t\t\t'worktree-create',\n\t\t\t\tex as GitError,\n\t\t\t\treason =>\n\t\t\t\t\tnew WorktreeCreateError(\n\t\t\t\t\t\t{ reason: reason, gitCommand: { repoPath: repoPath, args: args } },\n\t\t\t\t\t\tex as GitError,\n\t\t\t\t\t),\n\t\t\t);\n\t\t} finally {\n\t\t\t// A failed or cancelled add may already have created the branch (and its tracking in `.git/config`) or\n\t\t\t// the worktree directory.\n\t\t\t//\n\t\t\t// The tracking isn't announced as a `config` change, only evicted: git may also write repository-wide\n\t\t\t// keys (`extensions.relativeWorktrees` under `worktree.useRelativePaths`), so the write can't claim its\n\t\t\t// config change is confined to the new branch, and an unconfined one would refresh every worktree on each\n\t\t\t// add. The watcher's report of the file says what changed in it instead.\n\t\t\tif (createdBranch) {\n\t\t\t\t// Evict the cached base only — see `checkout -b` for why the persisted keys are left alone.\n\t\t\t\tthis.cache.deleteBaseBranchName(repoPath, createdBranch);\n\t\t\t\t// A branch git created on its own may track a remote branch, whatever the commitish looks like\n\t\t\t\tthis.context.hooks?.cache?.onReset?.(\n\t\t\t\t\trepoPath,\n\t\t\t\t\t...(!options?.createBranch || mayWriteTracking(options.commitish, options.noTracking)\n\t\t\t\t\t\t? (['branches', 'config', 'worktrees'] as const)\n\t\t\t\t\t\t: (['branches', 'worktrees'] as const)),\n\t\t\t\t);\n\t\t\t\tthis.context.hooks?.repository?.onChanged?.(\n\t\t\t\t\trepoPath,\n\t\t\t\t\t['worktrees', 'heads'],\n\t\t\t\t\t[`refs/heads/${createdBranch}`],\n\t\t\t\t);\n\t\t\t} else if (mayHaveCreatedBranch) {\n\t\t\t\t// Git creates the branch before checking it out, so a run cut short may have left one it never named\n\t\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'branches', 'config', 'worktrees');\n\t\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['worktrees', 'heads']);\n\t\t\t} else {\n\t\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'worktrees');\n\t\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['worktrees']);\n\t\t\t}\n\t\t}\n\t}\n\n\tasync createWorktreeWithResult(\n\t\trepoPath: string,\n\t\tpath: string,\n\t\toptions?: {\n\t\t\tcommitish?: string;\n\t\t\tcreateBranch?: string;\n\t\t\tdetach?: boolean;\n\t\t\tforce?: boolean;\n\t\t\tnoTracking?: boolean;\n\t\t},\n\t\trunOptions?: GitOperationRunOptions,\n\t): Promise<GitWorktree | undefined> {\n\t\tawait this.createWorktree(repoPath, path, options, runOptions);\n\t\tconst normalized = normalizePath(path);\n\t\treturn this.getWorktree(repoPath, w => normalizePath(w.path) === normalized, runOptions?.cancellation);\n\t}\n\n\t@debug()\n\tasync getWorktree(\n\t\trepoPath: string,\n\t\tpredicate: (w: GitWorktree) => boolean,\n\t\tcancellation?: AbortSignal,\n\t): Promise<GitWorktree | undefined> {\n\t\treturn (await this.getWorktrees(repoPath, cancellation)).find(predicate);\n\t}\n\n\t@debug()\n\tasync getWorktrees(repoPath: string, cancellation?: AbortSignal): Promise<GitWorktree[]> {\n\t\tawait this.git.ensureSupports('git:worktrees', (requiredVersion, installedVersion) =>\n\t\t\tl10n.t(\n\t\t\t\t'Displaying worktrees requires a newer version of Git (>= {0}) than is currently installed ({1}). Please install a more recent version of Git and try again.',\n\t\t\t\trequiredVersion,\n\t\t\t\tinstalledVersion,\n\t\t\t),\n\t\t);\n\n\t\treturn this.cache.getWorktrees(\n\t\t\trepoPath,\n\t\t\tasync (commonPath, cacheable, signal) => {\n\t\t\t\t// Prefer the aggregate signal from the cache; fall back to the caller's cancellation.\n\t\t\t\tsignal ??= cancellation;\n\t\t\t\tconst [dataResult, branchesResult] = await Promise.allSettled([\n\t\t\t\t\tthis.git.run({ cwd: commonPath, cancellation: signal }, 'worktree', 'list', '--porcelain'),\n\t\t\t\t\tthis.provider.branches.getBranches(commonPath, undefined, signal),\n\t\t\t\t]);\n\n\t\t\t\tif (dataResult.status === 'rejected') {\n\t\t\t\t\t// Don't cache a bogus empty result for a transient command failure — retry on next access.\n\t\t\t\t\tcacheable.invalidate();\n\t\t\t\t}\n\n\t\t\t\tconst getWorkspaceFolder: WorkspaceFolderResolver | undefined = this.context.workspace\n\t\t\t\t\t? uri => {\n\t\t\t\t\t\t\tconst folder = this.context.workspace!.getFolder(uri.fsPath);\n\t\t\t\t\t\t\tif (folder == null) return undefined;\n\t\t\t\t\t\t\treturn { uri: fileUri(folder.path), name: basename(folder.path) };\n\t\t\t\t\t\t}\n\t\t\t\t\t: undefined;\n\n\t\t\t\tconst worktrees = parseGitWorktrees(\n\t\t\t\t\tgetSettledValue(dataResult)?.stdout,\n\t\t\t\t\tcommonPath,\n\t\t\t\t\tgetSettledValue(branchesResult)?.values ?? [],\n\t\t\t\t\tgetWorkspaceFolder,\n\t\t\t\t);\n\n\t\t\t\t// Older git prints a bare `locked` even when a reason exists; recover it from the admin dir\n\t\t\t\tif (await this.git.supports('git:worktree:list:lock-reason')) return worktrees;\n\n\t\t\t\treturn Promise.all(worktrees.map(w => this.withLockReason(w)));\n\t\t\t},\n\t\t\tcancellation,\n\t\t);\n\t}\n\n\tprivate async withLockReason(worktree: GitWorktree): Promise<GitWorktree> {\n\t\tif (worktree.locked !== true || worktree.isDefault || worktree.type === 'bare') return worktree;\n\n\t\ttry {\n\t\t\t// A linked worktree's `.git` is a file: `gitdir: <admin dir>`, relative to the worktree when not absolute\n\t\t\tconst dotGit = join(worktree.uri.fsPath, '.git');\n\t\t\tconst match = /^gitdir:\\s*(.+?)\\s*$/m.exec(await fs.readFile(dotGit, 'utf8'));\n\t\t\tif (match == null) return worktree;\n\n\t\t\tconst reason = (await fs.readFile(join(resolve(worktree.uri.fsPath, match[1]), 'locked'), 'utf8')).trim();\n\t\t\tif (!reason) return worktree;\n\n\t\t\treturn new GitWorktree(\n\t\t\t\tworktree.isDefault,\n\t\t\t\tworktree.type,\n\t\t\t\tworktree.repoPath,\n\t\t\t\tworktree.uri,\n\t\t\t\treason,\n\t\t\t\tworktree.prunable,\n\t\t\t\tworktree.sha,\n\t\t\t\tworktree.branch,\n\t\t\t\tworktree.workspaceFolder,\n\t\t\t);\n\t\t} catch {\n\t\t\treturn worktree;\n\t\t}\n\t}\n\n\t@debug()\n\tgetWorktreesDefaultUri(repoPath: string): Uri | undefined {\n\t\treturn this.context.workspace?.getWorktreeDefaultUri?.(repoPath);\n\t}\n\n\t/**\n\t * Deletes a worktree (`git worktree remove`). Pass `force: 'locked'` to also override a locked worktree.\n\t *\n\t * `runOptions` are spread into the underlying `git.run` call (e.g. `{ timeout: 0 }` for a large worktree\n\t * whose removal may exceed the default command timeout).\n\t *\n\t * On failure, the thrown {@link WorktreeDeleteError}'s `original` property carries the raw\n\t * {@link GitError} (stderr/stdout/exit code) untouched — a caller that needs to classify a\n\t * platform-specific failure (e.g. a Windows file-lock retry) can read it directly rather than parsing\n\t * the typed error's message.\n\t */\n\t@debug()\n\tasync deleteWorktree(\n\t\trepoPath: string,\n\t\tpath: string | Uri,\n\t\toptions?: { force?: boolean | 'locked' },\n\t\trunOptions?: GitOperationRunOptions,\n\t): Promise<void> {\n\t\tconst scope = getScopedLogger();\n\n\t\tawait this.git.ensureSupports('git:worktrees', (requiredVersion, installedVersion) =>\n\t\t\tl10n.t(\n\t\t\t\t'Deleting worktrees requires a newer version of Git (>= {0}) than is currently installed ({1}). Please install a more recent version of Git and try again.',\n\t\t\t\trequiredVersion,\n\t\t\t\tinstalledVersion,\n\t\t\t),\n\t\t);\n\n\t\tconst args = ['worktree', 'remove'];\n\t\tif (options?.force) {\n\t\t\targs.push('--force');\n\t\t\t// Git requires a second `--force` to remove a locked worktree\n\t\t\tif (options.force === 'locked') {\n\t\t\t\targs.push('--force');\n\t\t\t}\n\t\t}\n\n\t\tconst pathStr = normalizePath(toFsPath(path));\n\t\targs.push(pathStr);\n\n\t\tlet deleted = false;\n\t\ttry {\n\t\t\tawait this.git.run({ cwd: repoPath, errors: 'throw', ...runOptions }, ...args);\n\t\t\tdeleted = true;\n\t\t} catch (ex) {\n\t\t\tscope?.error(ex);\n\t\t\t// A cancelled or timed-out removal (`runOptions.cancellation`/`timeout`), or a host-rejected index-lock\n\t\t\t// retry, is not git refusing it, and wrapping it would hand the caller a `WorktreeDeleteError` whose\n\t\t\t// `original` is no `GitError` at all\n\t\t\tif (isCancellationError(ex) || isRunHookFailure(ex)) throw ex;\n\n\t\t\tconst gitError = getGitCommandError(\n\t\t\t\t'worktree-delete',\n\t\t\t\tex as GitError,\n\t\t\t\treason =>\n\t\t\t\t\tnew WorktreeDeleteError(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\treason: reason,\n\t\t\t\t\t\t\tlockReason: reason === 'locked' ? getLockReason(ex as GitError) : undefined,\n\t\t\t\t\t\t\tgitCommand: { repoPath: repoPath, args: args },\n\t\t\t\t\t\t},\n\t\t\t\t\t\tex as GitError,\n\t\t\t\t\t),\n\t\t\t);\n\n\t\t\tif (gitError.details.reason === 'directoryNotEmpty') {\n\t\t\t\tscope?.warn(\n\t\t\t\t\t`Failed to fully delete worktree '${pathStr}' because it is not empty. Attempting to delete it manually.`,\n\t\t\t\t);\n\t\t\t\ttry {\n\t\t\t\t\tawait fs.rm(pathStr, { force: true, recursive: true });\n\t\t\t\t\tdeleted = true;\n\t\t\t\t\treturn;\n\t\t\t\t} catch (ex) {\n\t\t\t\t\tif (isWindows) {\n\t\t\t\t\t\tconst match = /EPERM: operation not permitted, unlink '(.*?)'/i.exec((ex as GitError).message);\n\t\t\t\t\t\tif (match != null) {\n\t\t\t\t\t\t\tscope?.warn(\n\t\t\t\t\t\t\t\t`Failed to manually delete '${pathStr}' because it is in use. Attempting to forcefully delete it.`,\n\t\t\t\t\t\t\t);\n\n\t\t\t\t\t\t\t// Windows-specific: `del` via cmd.exe to force-remove a locked symlink.\n\t\t\t\t\t\t\t// Node's fs.rm/unlink fails with EPERM when the symlink target is in use.\n\t\t\t\t\t\t\tfunction deleteInUseSymlink(symlink: string) {\n\t\t\t\t\t\t\t\treturn new Promise((resolve, reject) => {\n\t\t\t\t\t\t\t\t\texec(`del \"${symlink}\"`, (ex, stdout, stderr) => {\n\t\t\t\t\t\t\t\t\t\tif (ex) {\n\t\t\t\t\t\t\t\t\t\t\treject(ex instanceof Error ? ex : new Error(String(ex)));\n\t\t\t\t\t\t\t\t\t\t} else if (stderr) {\n\t\t\t\t\t\t\t\t\t\t\treject(new Error(stderr));\n\t\t\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\t\t\tresolve(stdout);\n\t\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tconst [, file] = match;\n\t\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\t\tawait deleteInUseSymlink(file);\n\t\t\t\t\t\t\t\tawait fs.rm(pathStr, { force: true, recursive: true, maxRetries: 1, retryDelay: 1 });\n\t\t\t\t\t\t\t\tdeleted = true;\n\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t} catch (ex) {\n\t\t\t\t\t\t\t\tscope?.error(ex, `Failed to forcefully delete '${pathStr}' because it is in use.`);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tthrow gitError;\n\t\t} finally {\n\t\t\tif (deleted) {\n\t\t\t\t// Clean up Cache registry + per-worktree cache entries for the deleted worktree.\n\t\t\t\t// Order matters: unregister before emitting the repo-level change so any listener\n\t\t\t\t// that re-queries worktree-aware state sees the registry already updated.\n\t\t\t\tthis.cache.unregisterRepoPath(pathStr);\n\t\t\t}\n\t\t\t// A failed or cancelled removal may already have taken the worktree's files or admin entry\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'worktrees');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['worktrees']);\n\t\t}\n\t}\n\n\t@debug()\n\tasync pruneWorktrees(repoPath: string, options?: { expire?: string }): Promise<void> {\n\t\tawait this.git.ensureSupports('git:worktrees', (requiredVersion, installedVersion) =>\n\t\t\tl10n.t(\n\t\t\t\t'Pruning worktrees requires a newer version of Git (>= {0}) than is currently installed ({1}). Please install a more recent version of Git and try again.',\n\t\t\t\trequiredVersion,\n\t\t\t\tinstalledVersion,\n\t\t\t),\n\t\t);\n\n\t\tconst before = await this.listWorktreePaths(repoPath);\n\n\t\tconst args = ['worktree', 'prune'];\n\t\tif (options?.expire) {\n\t\t\targs.push('--expire', options.expire);\n\t\t}\n\n\t\ttry {\n\t\t\tawait this.git.run({ cwd: repoPath, errors: 'throw' }, ...args);\n\n\t\t\tconst after = await this.listWorktreePaths(repoPath);\n\n\t\t\t// Order matters (see `deleteWorktree`): unregister before emitting the repo-level change so any\n\t\t\t// listener that re-queries worktree-aware state sees the registry already updated.\n\t\t\tif (before != null && after != null) {\n\t\t\t\tfor (const path of before) {\n\t\t\t\t\tif (!after.has(path)) {\n\t\t\t\t\t\tthis.cache.unregisterRepoPath(path);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t} finally {\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'worktrees');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['worktrees']);\n\t\t}\n\t}\n\n\t/**\n\t * Raw worktree paths currently known to git (`worktree <path>` lines from `--porcelain`), normalized the\n\t * same way {@link deleteWorktree} does. A failed listing (`errors: 'ignore'`) yields an empty set rather\n\t * than throwing — used by `pruneWorktrees` to diff before/after, where a transient read failure must not\n\t * be mistaken for every worktree having vanished.\n\t */\n\tprivate async listWorktreePaths(repoPath: string): Promise<Set<string> | undefined> {\n\t\tconst result = await this.git.run({ cwd: repoPath, errors: 'ignore' }, 'worktree', 'list', '--porcelain');\n\t\t// A failed listing is not an empty one: read as empty, the after-prune one would unregister everything\n\t\tif (result.completion.status !== 'exited' || result.exitCode !== 0) return undefined;\n\n\t\tconst paths = new Set<string>();\n\t\tfor (const line of result.stdout.split('\\n')) {\n\t\t\tif (line.startsWith('worktree ')) {\n\t\t\t\tpaths.add(normalizePath(toFsPath(line.slice('worktree '.length).trim())));\n\t\t\t}\n\t\t}\n\t\treturn paths;\n\t}\n\n\t@debug()\n\tasync lockWorktree(repoPath: string, path: string | Uri, options?: { reason?: string }): Promise<void> {\n\t\tawait this.git.ensureSupports('git:worktrees', (requiredVersion, installedVersion) =>\n\t\t\tl10n.t(\n\t\t\t\t'Locking worktrees requires a newer version of Git (>= {0}) than is currently installed ({1}). Please install a more recent version of Git and try again.',\n\t\t\t\trequiredVersion,\n\t\t\t\tinstalledVersion,\n\t\t\t),\n\t\t);\n\n\t\tconst args = ['worktree', 'lock'];\n\t\tif (options?.reason) {\n\t\t\targs.push('--reason', options.reason);\n\t\t}\n\t\targs.push(normalizePath(toFsPath(path)));\n\n\t\ttry {\n\t\t\tawait this.git.run({ cwd: repoPath, errors: 'throw' }, ...args);\n\t\t} finally {\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'worktrees');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['worktrees']);\n\t\t}\n\t}\n\n\t@debug()\n\tasync unlockWorktree(repoPath: string, path: string | Uri): Promise<void> {\n\t\tawait this.git.ensureSupports('git:worktrees', (requiredVersion, installedVersion) =>\n\t\t\tl10n.t(\n\t\t\t\t'Unlocking worktrees requires a newer version of Git (>= {0}) than is currently installed ({1}). Please install a more recent version of Git and try again.',\n\t\t\t\trequiredVersion,\n\t\t\t\tinstalledVersion,\n\t\t\t),\n\t\t);\n\n\t\tconst pathStr = normalizePath(toFsPath(path));\n\t\ttry {\n\t\t\tawait this.git.run({ cwd: repoPath, errors: 'throw' }, 'worktree', 'unlock', pathStr);\n\t\t} finally {\n\t\t\tthis.context.hooks?.cache?.onReset?.(repoPath, 'worktrees');\n\t\t\tthis.context.hooks?.repository?.onChanged?.(repoPath, ['worktrees']);\n\t\t}\n\t}\n}\n"],"mappings":"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"}
|
|
@@ -2,6 +2,7 @@ import { FileWatchingProvider } from "../git/watching/provider.js";
|
|
|
2
2
|
import { WatchPollingOptions } from "../git/watching/watchService.js";
|
|
3
3
|
import { GitLocation } from "./exec/locator.js";
|
|
4
4
|
import { CliGitProviderOptions } from "./cliGitProvider.js";
|
|
5
|
+
import { WorktreeSummaryServiceOptions } from "../git/watching/worktreeSummary.js";
|
|
5
6
|
import { GitService } from "../git/service.js";
|
|
6
7
|
//#region ../git-cli/src/service.d.ts
|
|
7
8
|
/**
|
|
@@ -35,6 +36,8 @@ export interface CliGitServiceOptions {
|
|
|
35
36
|
* watcher is asked.
|
|
36
37
|
*/
|
|
37
38
|
watchPolling?: WatchPollingOptions;
|
|
39
|
+
/** For tests only; production never passes it (see `WorktreeSummaryServiceOptions.verifyBaseRemeasure`) */
|
|
40
|
+
verifyBaseRemeasure?: WorktreeSummaryServiceOptions['verifyBaseRemeasure'];
|
|
38
41
|
}
|
|
39
42
|
/**
|
|
40
43
|
* Creates a ready-to-use {@link GitService} backed by the CLI git provider.
|
package/dist/git-cli/service.js
CHANGED
|
@@ -25,6 +25,7 @@ import { findGitPath } from "./exec/locator.js";
|
|
|
25
25
|
function createCliGitService(options) {
|
|
26
26
|
const service = GitService.createSingleton(options.watchingProvider, {
|
|
27
27
|
watchPolling: options.watchPolling,
|
|
28
|
+
verifyBaseRemeasure: options.verifyBaseRemeasure,
|
|
28
29
|
readFile: (path) => options.context.fs.readFile(fileUri(path))
|
|
29
30
|
});
|
|
30
31
|
const locator = options.locator ?? (() => findGitPath(options.gitPath ?? null));
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"service.js","names":[],"sources":["../../../git-cli/src/service.ts"],"sourcesContent":["import { GitService } from '@gitlens/git/service.js';\nimport type { FileWatchingProvider } from '@gitlens/git/watching/provider.js';\nimport type { WatchPollingOptions } from '@gitlens/git/watching/watchService.js';\nimport { fileUri } from '@gitlens/utils/uri.js';\nimport type { CliGitProviderOptions } from './cliGitProvider.js';\nimport { CliGitProvider } from './cliGitProvider.js';\nimport type { GitLocation } from './exec/locator.js';\nimport { findGitPath } from './exec/locator.js';\n\n/**\n * Options for {@link createCliGitService}.\n */\nexport interface CliGitServiceOptions {\n\t/**\n\t * Path(s) to the git binary.\n\t * Auto-detected if omitted (searches PATH, platform-specific locations).\n\t * Ignored when {@link locator} is provided.\n\t */\n\tgitPath?: string | string[];\n\n\t/**\n\t * Custom git binary resolver. When provided, used instead of the\n\t * default `findGitPath(gitPath)` lookup.\n\t */\n\tlocator?: () => Promise<GitLocation>;\n\n\t/** Host-provided context hooks (cache events, workspace, integrations, telemetry, fs) */\n\tcontext: CliGitProviderOptions['context'];\n\n\t/** Git execution options passed through to the underlying Git executor */\n\tgitOptions?: CliGitProviderOptions['gitOptions'];\n\n\t/** Use an existing Cache instance, or one will be created */\n\tcache?: CliGitProviderOptions['cache'];\n\n\t/**\n\t * Filesystem watching provider. When provided, the {@link GitService}\n\t * will watch repositories for changes (file creates, edits, deletes).\n\t */\n\twatchingProvider?: FileWatchingProvider;\n\n\t/**\n\t * Polls in place of (or beside) the watchers {@link watchingProvider} reports it can't trust. When omitted, no\n\t * watcher is asked.\n\t */\n\twatchPolling?: WatchPollingOptions;\n}\n\n/**\n * Creates a ready-to-use {@link GitService} backed by the CLI git provider.\n *\n * This is the primary entry point for standalone (non-VS Code) consumers\n * of the `@gitlens/git-cli` library. It creates a singleton {@link GitService},\n * wires up a {@link CliGitProvider}, and registers it for all repository paths.\n *\n * @example\n * ```typescript\n * const git = createCliGitService({ context: {} });\n *\n * const repo = git.forRepo('/path/to/repo')!;\n * const branches = await repo.branches.getBranches();\n * const status = await repo.status.getStatus();\n * await repo.ops!.fetch({ remote: 'origin' });\n *\n * git.dispose(); // cleans up provider, cache, and module-level state\n * ```\n */\nexport function createCliGitService(options: CliGitServiceOptions): GitService {\n\tconst service = GitService.createSingleton(options.watchingProvider, {\n\t\twatchPolling: options.watchPolling,\n\t\t// The host's file system reads the shared `.git/config` the watch service compares reports of\n\t\treadFile: path => options.context.fs.readFile(fileUri(path)),\n\t});\n\n\tconst locator = options.locator ?? (() => findGitPath(options.gitPath ?? null));\n\tconst provider = new CliGitProvider({\n\t\tcontext: options.context,\n\t\tlocator: locator,\n\t\tgitOptions: options.gitOptions,\n\t\tcache: options.cache,\n\t});\n\n\tservice.register(provider, () => true);\n\n\t// Advance the provider cache's status generation clock from the watch session's global events — the standalone\n\t// analogue of what the VS Code host wires in `GitProviderService`. Without this, a consumer that passes a\n\t// `watchingProvider` and drives watch sessions gets FS events but a FROZEN clock, so `dedupeByStatusGeneration`\n\t// degrades to the pre-change/post-change stale-join this branch exists to fix. Standalone has no `Repository`\n\t// models, so there are no force-fired `closed`/`lastFetched` bypassing the session for the global repo event to\n\t// miss. Subscriptions are torn down with the service (its `watchService`'s emitters are disposed on dispose).\n\tservice.watchService?.onDidChangeWorkingTree(repoPath => provider.cache.onWorkingTreeChanged(repoPath));\n\t// Announced kinds were evicted when core announced its write; evicting them again would discard what the host\n\t// re-read since\n\tservice.watchService?.onDidChangeRepository(e => {\n\t\tconst changes = e.getUnannouncedChanges();\n\t\tif (changes.length) {\n\t\t\tprovider.cache.onRepositoryChanged(e.repoPath, changes);\n\t\t}\n\t});\n\t// FETCH_HEAD maps to no session change, and there's no `Repository` model here to force-fire `lastFetched` (as\n\t// the VS Code host does), so bridge it straight to the cache or the last-fetched time is never re-read.\n\tservice.watchService?.onDidChangeFetchHead(repoPath =>\n\t\tprovider.cache.onRepositoryChanged(repoPath, ['lastFetched']),\n\t);\n\treturn service;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"service.js","names":[],"sources":["../../../git-cli/src/service.ts"],"sourcesContent":["import { GitService } from '@gitlens/git/service.js';\nimport type { FileWatchingProvider } from '@gitlens/git/watching/provider.js';\nimport type { WatchPollingOptions } from '@gitlens/git/watching/watchService.js';\nimport type { WorktreeSummaryServiceOptions } from '@gitlens/git/watching/worktreeSummary.js';\nimport { fileUri } from '@gitlens/utils/uri.js';\nimport type { CliGitProviderOptions } from './cliGitProvider.js';\nimport { CliGitProvider } from './cliGitProvider.js';\nimport type { GitLocation } from './exec/locator.js';\nimport { findGitPath } from './exec/locator.js';\n\n/**\n * Options for {@link createCliGitService}.\n */\nexport interface CliGitServiceOptions {\n\t/**\n\t * Path(s) to the git binary.\n\t * Auto-detected if omitted (searches PATH, platform-specific locations).\n\t * Ignored when {@link locator} is provided.\n\t */\n\tgitPath?: string | string[];\n\n\t/**\n\t * Custom git binary resolver. When provided, used instead of the\n\t * default `findGitPath(gitPath)` lookup.\n\t */\n\tlocator?: () => Promise<GitLocation>;\n\n\t/** Host-provided context hooks (cache events, workspace, integrations, telemetry, fs) */\n\tcontext: CliGitProviderOptions['context'];\n\n\t/** Git execution options passed through to the underlying Git executor */\n\tgitOptions?: CliGitProviderOptions['gitOptions'];\n\n\t/** Use an existing Cache instance, or one will be created */\n\tcache?: CliGitProviderOptions['cache'];\n\n\t/**\n\t * Filesystem watching provider. When provided, the {@link GitService}\n\t * will watch repositories for changes (file creates, edits, deletes).\n\t */\n\twatchingProvider?: FileWatchingProvider;\n\n\t/**\n\t * Polls in place of (or beside) the watchers {@link watchingProvider} reports it can't trust. When omitted, no\n\t * watcher is asked.\n\t */\n\twatchPolling?: WatchPollingOptions;\n\n\t/** For tests only; production never passes it (see `WorktreeSummaryServiceOptions.verifyBaseRemeasure`) */\n\tverifyBaseRemeasure?: WorktreeSummaryServiceOptions['verifyBaseRemeasure'];\n}\n\n/**\n * Creates a ready-to-use {@link GitService} backed by the CLI git provider.\n *\n * This is the primary entry point for standalone (non-VS Code) consumers\n * of the `@gitlens/git-cli` library. It creates a singleton {@link GitService},\n * wires up a {@link CliGitProvider}, and registers it for all repository paths.\n *\n * @example\n * ```typescript\n * const git = createCliGitService({ context: {} });\n *\n * const repo = git.forRepo('/path/to/repo')!;\n * const branches = await repo.branches.getBranches();\n * const status = await repo.status.getStatus();\n * await repo.ops!.fetch({ remote: 'origin' });\n *\n * git.dispose(); // cleans up provider, cache, and module-level state\n * ```\n */\nexport function createCliGitService(options: CliGitServiceOptions): GitService {\n\tconst service = GitService.createSingleton(options.watchingProvider, {\n\t\twatchPolling: options.watchPolling,\n\t\tverifyBaseRemeasure: options.verifyBaseRemeasure,\n\t\t// The host's file system reads the shared `.git/config` the watch service compares reports of\n\t\treadFile: path => options.context.fs.readFile(fileUri(path)),\n\t});\n\n\tconst locator = options.locator ?? (() => findGitPath(options.gitPath ?? null));\n\tconst provider = new CliGitProvider({\n\t\tcontext: options.context,\n\t\tlocator: locator,\n\t\tgitOptions: options.gitOptions,\n\t\tcache: options.cache,\n\t});\n\n\tservice.register(provider, () => true);\n\n\t// Advance the provider cache's status generation clock from the watch session's global events — the standalone\n\t// analogue of what the VS Code host wires in `GitProviderService`. Without this, a consumer that passes a\n\t// `watchingProvider` and drives watch sessions gets FS events but a FROZEN clock, so `dedupeByStatusGeneration`\n\t// degrades to the pre-change/post-change stale-join this branch exists to fix. Standalone has no `Repository`\n\t// models, so there are no force-fired `closed`/`lastFetched` bypassing the session for the global repo event to\n\t// miss. Subscriptions are torn down with the service (its `watchService`'s emitters are disposed on dispose).\n\tservice.watchService?.onDidChangeWorkingTree(repoPath => provider.cache.onWorkingTreeChanged(repoPath));\n\t// Announced kinds were evicted when core announced its write; evicting them again would discard what the host\n\t// re-read since\n\tservice.watchService?.onDidChangeRepository(e => {\n\t\tconst changes = e.getUnannouncedChanges();\n\t\tif (changes.length) {\n\t\t\tprovider.cache.onRepositoryChanged(e.repoPath, changes);\n\t\t}\n\t});\n\t// FETCH_HEAD maps to no session change, and there's no `Repository` model here to force-fire `lastFetched` (as\n\t// the VS Code host does), so bridge it straight to the cache or the last-fetched time is never re-read.\n\tservice.watchService?.onDidChangeFetchHead(repoPath =>\n\t\tprovider.cache.onRepositoryChanged(repoPath, ['lastFetched']),\n\t);\n\treturn service;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAuEA,SAAgB,oBAAoB,SAA2C;CAC9E,MAAM,UAAU,WAAW,gBAAgB,QAAQ,kBAAkB;EACpE,cAAc,QAAQ;EACtB,qBAAqB,QAAQ;EAE7B,WAAU,SAAQ,QAAQ,QAAQ,GAAG,SAAS,QAAQ,IAAI,CAAC;CAC5D,CAAC;CAED,MAAM,UAAU,QAAQ,kBAAkB,YAAY,QAAQ,WAAW,IAAI;CAC7E,MAAM,WAAW,IAAI,eAAe;EACnC,SAAS,QAAQ;EACR;EACT,YAAY,QAAQ;EACpB,OAAO,QAAQ;CAChB,CAAC;CAED,QAAQ,SAAS,gBAAgB,IAAI;CAQrC,QAAQ,cAAc,wBAAuB,aAAY,SAAS,MAAM,qBAAqB,QAAQ,CAAC;CAGtG,QAAQ,cAAc,uBAAsB,MAAK;EAChD,MAAM,UAAU,EAAE,sBAAsB;EACxC,IAAI,QAAQ,QACX,SAAS,MAAM,oBAAoB,EAAE,UAAU,OAAO;CAExD,CAAC;CAGD,QAAQ,cAAc,sBAAqB,aAC1C,SAAS,MAAM,oBAAoB,UAAU,CAAC,aAAa,CAAC,CAC7D;CACA,OAAO;AACR"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { CancellationReason } from "../../cancellation.js";
|
|
2
|
-
import { Writable } from "stream";
|
|
2
|
+
import { Readable, Writable } from "stream";
|
|
3
3
|
//#region ../utils/src/env/node/exec.d.ts
|
|
4
4
|
interface RunErrorContext {
|
|
5
5
|
message: string;
|
|
@@ -35,6 +35,41 @@ export declare function findExecutable(exe: string, args: string[]): Promise<{
|
|
|
35
35
|
args: string[];
|
|
36
36
|
}>;
|
|
37
37
|
export declare function getWindowsShortPath(path: string): Promise<string>;
|
|
38
|
+
/** What core uses of a spawned process; Node's `ChildProcess` satisfies it */
|
|
39
|
+
export interface SpawnedProcess {
|
|
40
|
+
readonly stdin: Writable | null;
|
|
41
|
+
readonly stdout: Readable | null;
|
|
42
|
+
readonly stderr: Readable | null;
|
|
43
|
+
readonly killed: boolean;
|
|
44
|
+
readonly exitCode: number | null;
|
|
45
|
+
readonly spawnargs: string[];
|
|
46
|
+
once(event: 'error', listener: (error: Error) => void): this;
|
|
47
|
+
once(event: 'close', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
|
|
48
|
+
removeAllListeners(): this;
|
|
49
|
+
}
|
|
50
|
+
export interface ProcessSpawnOptions {
|
|
51
|
+
readonly cwd?: string;
|
|
52
|
+
/** The child's whole environment, not additions to the spawner's own; an `undefined` value leaves the key out */
|
|
53
|
+
readonly env?: Record<string, string | undefined>;
|
|
54
|
+
/** Milliseconds; absent means none */
|
|
55
|
+
readonly timeout?: number;
|
|
56
|
+
readonly signal?: AbortSignal;
|
|
57
|
+
/** A `null` entry means `'pipe'` */
|
|
58
|
+
readonly stdio?: ['pipe' | 'ignore', null, null];
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* Launches a process in place of Node's `spawn`, and must behave as it does:
|
|
62
|
+
* - pipe stdout and stderr, and stdin unless `stdio[0]` is `'ignore'`, which leaves `stdin` null
|
|
63
|
+
* - honour `signal`, including one already aborted: kill with SIGTERM, then emit `'error'` with `name` `AbortError`,
|
|
64
|
+
* unless the process has already exited
|
|
65
|
+
* - honour `timeout`: kill with SIGTERM and set `killed`, without emitting `'error'`
|
|
66
|
+
* - report a killed process's `'close'` with a null code and its signal, not an exit code such as 143
|
|
67
|
+
* - emit no event before returning, `'error'` at most once, and `'close'` exactly once and last: also after `'error'`
|
|
68
|
+
* (a failed launch, an abort), and only after `stdout` and `stderr` have ended or been destroyed, with `exitCode`
|
|
69
|
+
* and `killed` already set
|
|
70
|
+
* - close the child's stdout when `stdout` is destroyed, which is how a reader that stops early ends the process
|
|
71
|
+
*/
|
|
72
|
+
export type ProcessSpawner = (command: string, args: readonly string[], options: ProcessSpawnOptions) => SpawnedProcess;
|
|
38
73
|
export interface RunOptions<TEncoding = BufferEncoding | 'buffer'> {
|
|
39
74
|
cwd?: string;
|
|
40
75
|
readonly env?: Record<string, string | undefined>;
|
|
@@ -73,6 +108,8 @@ export interface RunOptions<TEncoding = BufferEncoding | 'buffer'> {
|
|
|
73
108
|
* Use for commands whose failure is expected (e.g. paired with `errors: 'ignore'`).
|
|
74
109
|
*/
|
|
75
110
|
readonly quiet?: boolean;
|
|
111
|
+
/** Launches the process; defaults to Node's `spawn`. Only used by `runSpawn` */
|
|
112
|
+
readonly spawn?: ProcessSpawner;
|
|
76
113
|
}
|
|
77
114
|
type ExitCodeOnlyRunOptions<TEncoding = BufferEncoding | 'buffer'> = RunOptions<TEncoding> & {
|
|
78
115
|
exitCodeOnly: true;
|
|
@@ -201,17 +201,24 @@ function endStdin(stream, stdin, stdinEncoding) {
|
|
|
201
201
|
}
|
|
202
202
|
function runSpawn(command, args, encoding, options) {
|
|
203
203
|
const scope = getScopedLogger() ?? maybeStartScopedLogger("Exec.runSpawn");
|
|
204
|
-
const { stdin, stdinEncoding, cancellation, decode, ...opts } = options;
|
|
204
|
+
const { stdin, stdinEncoding, cancellation, decode, spawn: spawner, ...opts } = options;
|
|
205
205
|
return new Promise((resolve, reject) => {
|
|
206
|
-
const proc = spawn(command, args, {
|
|
207
|
-
|
|
208
|
-
|
|
206
|
+
const proc = (spawner ?? spawn)(command, args, {
|
|
207
|
+
cwd: opts.cwd,
|
|
208
|
+
env: opts.env,
|
|
209
|
+
timeout: opts.timeout === 0 ? void 0 : opts.timeout,
|
|
210
|
+
signal: cancellation,
|
|
211
|
+
stdio: [
|
|
212
|
+
"pipe",
|
|
213
|
+
null,
|
|
214
|
+
null
|
|
215
|
+
]
|
|
209
216
|
});
|
|
210
217
|
const errorEncoding = encoding === "buffer" ? "utf8" : encoding;
|
|
211
218
|
const stdoutBuffers = [];
|
|
212
|
-
proc.stdout
|
|
219
|
+
proc.stdout?.on("data", (data) => stdoutBuffers.push(data));
|
|
213
220
|
const stderrBuffers = [];
|
|
214
|
-
proc.stderr
|
|
221
|
+
proc.stderr?.on("data", (data) => stderrBuffers.push(data));
|
|
215
222
|
function getStdio(encoding) {
|
|
216
223
|
const stdout = Buffer.concat(stdoutBuffers);
|
|
217
224
|
const stderr = Buffer.concat(stderrBuffers);
|
|
@@ -272,6 +279,7 @@ function runSpawn(command, args, encoding, options) {
|
|
|
272
279
|
stderr
|
|
273
280
|
});
|
|
274
281
|
});
|
|
282
|
+
if (proc.stdout == null || proc.stderr == null) reject(/* @__PURE__ */ new Error(`'${command}' was spawned without stdout and stderr pipes`));
|
|
275
283
|
if (stdin != null) endStdin(proc.stdin, stdin, stdinEncoding);
|
|
276
284
|
}).finally(() => scope?.[Symbol.dispose]());
|
|
277
285
|
}
|