@gitkraken/core-gitlens 0.7.2 → 0.9.0

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

@@ -0,0 +1,391 @@
+import { isAbsolute, join } from "node:path";
+//#region ../git-cli/src/exec/commandClassifier.ts
+/**
+* Verbs that never move a ref, the index or the working tree, so a raw run needs no notification.
+* Anything not listed is treated as a mutation: a needless notification costs a full cache eviction, a
+* missed one serves stale state. Object-writing plumbing (`hash-object -w`, `mktree`, `commit-tree`,
+* `write-tree`) is listed too: it only adds loose objects nothing cached observes.
+*/
+const readOnlyVerbs = /* @__PURE__ */ new Set([
+	"annotate",
+	"archive",
+	"blame",
+	"cat-file",
+	"check-attr",
+	"check-ignore",
+	"check-mailmap",
+	"check-ref-format",
+	"cherry",
+	"commit-tree",
+	"count-objects",
+	"describe",
+	"diff",
+	"diff-files",
+	"diff-index",
+	"diff-tree",
+	"for-each-ref",
+	"fsck",
+	"grep",
+	"hash-object",
+	"help",
+	"log",
+	"ls-files",
+	"ls-remote",
+	"ls-tree",
+	"merge-base",
+	"merge-tree",
+	"mktree",
+	"name-rev",
+	"patch-id",
+	"range-diff",
+	"rev-list",
+	"rev-parse",
+	"shortlog",
+	"show",
+	"show-branch",
+	"show-ref",
+	"status",
+	"var",
+	"verify-commit",
+	"verify-pack",
+	"verify-tag",
+	"version",
+	"whatchanged",
+	"write-tree"
+]);
+const reflogWriteSubcommands = /* @__PURE__ */ new Set([
+	"expire",
+	"delete",
+	"drop"
+]);
+/**
+* Sub-commands of otherwise-mutating verbs that only list. `''` is the bare verb, which lists for `branch`,
+* `tag`, `remote` and `notes`; `branch -v` and every `tag` filter imply git's own list mode.
+*/
+const readOnlySubcommands = {
+	branch: /* @__PURE__ */ new Set([
+		"",
+		"-l",
+		"--list",
+		"--show-current",
+		"-a",
+		"-r",
+		"-v",
+		"-vv",
+		"--verbose",
+		"--contains",
+		"--no-contains",
+		"--merged",
+		"--no-merged",
+		"--points-at"
+	]),
+	config: /* @__PURE__ */ new Set(["get", "list"]),
+	notes: /* @__PURE__ */ new Set([
+		"",
+		"list",
+		"show",
+		"get-ref"
+	]),
+	stash: /* @__PURE__ */ new Set(["list", "show"]),
+	tag: /* @__PURE__ */ new Set([
+		"",
+		"-l",
+		"--list",
+		"-n",
+		"-v",
+		"--verify",
+		"--contains",
+		"--no-contains",
+		"--merged",
+		"--no-merged",
+		"--points-at"
+	]),
+	worktree: /* @__PURE__ */ new Set(["list"]),
+	remote: /* @__PURE__ */ new Set([
+		"",
+		"-v",
+		"get-url",
+		"show"
+	])
+};
+/**
+* Options that make an argv write whatever else it contains, checked across the whole argv rather than
+* only its first token: `branch -r -d origin/x` leads with a listing flag and still deletes.
+*/
+const writeOptions = {
+	branch: [
+		"-d",
+		"-D",
+		"--delete",
+		"-m",
+		"-M",
+		"--move",
+		"-c",
+		"-C",
+		"--copy",
+		"-f",
+		"--force",
+		"-t",
+		"--track",
+		"--no-track",
+		"-u",
+		"--set-upstream-to",
+		"--unset-upstream",
+		"--edit-description"
+	],
+	config: [
+		"--add",
+		"--replace-all",
+		"--unset",
+		"--unset-all",
+		"--rename-section",
+		"--remove-section",
+		"-e",
+		"--edit"
+	]
+};
+const configReadOptions = /* @__PURE__ */ new Set([
+	"--get",
+	"--get-all",
+	"--get-regexp",
+	"--get-urlmatch",
+	"--get-color",
+	"--get-colorbool",
+	"--list",
+	"-l"
+]);
+function hasWriteOption(verb, rest) {
+	const options = writeOptions[verb];
+	if (options == null) return false;
+	return rest.some((arg) => options.some((opt) => arg === opt || arg.startsWith(`${opt}=`)));
+}
+/**
+* `config <key>` with nothing after the key is git's own read form, as is any `--get*`/`--list`. `config edit`
+* (git 2.46's subcommand form of `--edit`) also has a single non-flag argument but writes.
+*/
+function isConfigRead(rest) {
+	if (rest[0] === "edit") return false;
+	if (rest.some((arg) => configReadOptions.has(arg))) return true;
+	return rest.filter((arg) => !arg.startsWith("-")).length === 1;
+}
+/** Global options whose value is the next argument, so the verb scan must skip both. */
+const globalOptionsWithValue = /* @__PURE__ */ new Set([
+	"-c",
+	"--config-env",
+	"--exec-path",
+	"--git-dir",
+	"--namespace",
+	"--super-prefix",
+	"--work-tree"
+]);
+/**
+* Skips the global options (`-c key=val`, `-C path`) git accepts before the verb to find it, and notes a
+* `-C` re-scope so notification targets that tree.
+*/
+function leadingCommand(args) {
+	let pathOverride;
+	let i = 0;
+	while (i < args.length) {
+		const arg = args[i];
+		if (arg === "-C") {
+			const path = args[i + 1];
+			if (path != null) pathOverride = pathOverride == null || isAbsolute(path) ? path : join(pathOverride, path);
+			i += 2;
+			continue;
+		}
+		if (globalOptionsWithValue.has(arg)) {
+			i += 2;
+			continue;
+		}
+		if (arg.startsWith("-")) {
+			i += 1;
+			continue;
+		}
+		break;
+	}
+	const verb = args[i] ?? "";
+	const rest = args.slice(i + 1);
+	return {
+		verb,
+		readOnly: !hasWriteOption(verb, rest) && (readOnlyVerbs.has(verb) || (readOnlySubcommands[verb]?.has(rest[0] ?? "") ?? false) || verb === "config" && isConfigRead(rest) || verb === "reflog" && !reflogWriteSubcommands.has(rest[0] ?? "") || verb === "symbolic-ref" && !rest.includes("-d") && !rest.includes("--delete") && rest.filter((a) => !a.startsWith("-")).length < 2),
+		subcommand: rest[0],
+		pathOverride
+	};
+}
+/**
+* The change kinds every worktree sharing a `.git` sees: its refs, stash, worktree list and config. The rest a
+* classified verb announces — HEAD, the index, a paused operation, FETCH_HEAD — belong to the one tree the
+* command ran in, so a `-C`-scoped write tells the caller's own `cwd` only this subset of what it changed.
+*/
+const worktreeSharedChanges = /* @__PURE__ */ new Set([
+	"heads",
+	"tags",
+	"stash",
+	"remotes",
+	"worktrees",
+	"config"
+]);
+/**
+* Verbs whose effect is confined to the object store that nothing cached observes — repacking or pruning
+* `.git/objects` changes no cached read (branches, refs, status, worktrees, …). `init` and `clone` create a
+* repository rather than mutate a registered one, so there is nothing yet registered to notify.
+*/
+const objectOnlyVerbs = /* @__PURE__ */ new Set([
+	"gc",
+	"repack",
+	"prune",
+	"maintenance",
+	"commit-graph",
+	"multi-pack-index",
+	"init",
+	"clone"
+]);
+/**
+* The {@link RepositoryChange} kinds each mutating verb announces. A worktree subcommand other than a
+* listing is handled separately (see {@link getChangesForCommand}), and any verb absent from both this
+* table and {@link objectOnlyVerbs} announces `[]` — the conservative default for an unclassified
+* mutation: the caller still learns something changed, just not what. An entry covers at least what the
+* verb's typed mutator announces; `update-ref` and `symbolic-ref` name every kind their target ref could be.
+* The kinds decide which caches the announcement resets, so a verb that can start or end a paused operation
+* names `pausedOp`: `commit` concludes a merge, cherry-pick or revert, `reset` aborts one, and `am` runs in
+* `rebase-apply`.
+*/
+const changesByVerb = {
+	commit: [
+		"head",
+		"heads",
+		"index",
+		"pausedOp"
+	],
+	am: [
+		"head",
+		"heads",
+		"index",
+		"pausedOp"
+	],
+	bisect: ["head", "index"],
+	checkout: [
+		"head",
+		"heads",
+		"index"
+	],
+	switch: [
+		"head",
+		"heads",
+		"index"
+	],
+	reset: [
+		"head",
+		"heads",
+		"index",
+		"pausedOp"
+	],
+	merge: [
+		"head",
+		"heads",
+		"index",
+		"pausedOp",
+		"merge"
+	],
+	rebase: [
+		"head",
+		"heads",
+		"index",
+		"pausedOp",
+		"rebase"
+	],
+	"cherry-pick": [
+		"head",
+		"heads",
+		"index",
+		"pausedOp",
+		"cherryPick"
+	],
+	revert: [
+		"head",
+		"heads",
+		"index",
+		"pausedOp",
+		"revert"
+	],
+	pull: [
+		"head",
+		"heads",
+		"index",
+		"remotes",
+		"tags",
+		"lastFetched",
+		"pausedOp",
+		"merge",
+		"rebase"
+	],
+	add: ["index"],
+	rm: ["index"],
+	mv: ["index"],
+	restore: ["index"],
+	apply: ["index"],
+	"read-tree": ["index"],
+	"update-index": ["index"],
+	clean: ["index"],
+	stash: ["stash", "index"],
+	"update-ref": [
+		"head",
+		"heads",
+		"remotes",
+		"tags",
+		"stash"
+	],
+	branch: [
+		"heads",
+		"remotes",
+		"tags"
+	],
+	"symbolic-ref": [
+		"head",
+		"heads",
+		"remotes",
+		"tags"
+	],
+	"pack-refs": [
+		"heads",
+		"remotes",
+		"tags"
+	],
+	tag: ["tags"],
+	fetch: [
+		"heads",
+		"remotes",
+		"tags",
+		"lastFetched"
+	],
+	push: ["remotes"],
+	remote: ["remotes", "config"],
+	config: [
+		"config",
+		"heads",
+		"remotes"
+	],
+	notes: ["heads"]
+};
+const worktreeChanges = ["worktrees", "heads"];
+const emptyChanges = [];
+/**
+* Classifies a raw git argv for the notification `git.run`'s `notify: 'infer'` applies after the run
+* settles. Returns `undefined` for a read-only or object-only command — nothing to announce — otherwise
+* the {@link RepositoryChange} kinds the verb announces, the `-C` re-scope target (if any), and which of
+* those kinds every worktree sees.
+*/
+function getChangesForCommand(args) {
+	const command = leadingCommand(args);
+	if (command.readOnly || objectOnlyVerbs.has(command.verb)) return void 0;
+	const changes = command.verb === "worktree" ? worktreeChanges : changesByVerb[command.verb] ?? emptyChanges;
+	return {
+		changes,
+		pathOverride: command.pathOverride,
+		sharedChanges: changes.filter((c) => worktreeSharedChanges.has(c))
+	};
+}
+//#endregion
+export { getChangesForCommand, leadingCommand };
+
+//# sourceMappingURL=commandClassifier.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commandClassifier.js","names":[],"sources":["../../../../git-cli/src/exec/commandClassifier.ts"],"sourcesContent":["import { isAbsolute, join } from 'node:path';\nimport type { RepositoryChange } from '@gitlens/git/models/repository.js';\n\n/**\n * Verbs that never move a ref, the index or the working tree, so a raw run needs no notification.\n * Anything not listed is treated as a mutation: a needless notification costs a full cache eviction, a\n * missed one serves stale state. Object-writing plumbing (`hash-object -w`, `mktree`, `commit-tree`,\n * `write-tree`) is listed too: it only adds loose objects nothing cached observes.\n */\nconst readOnlyVerbs = new Set([\n\t'annotate',\n\t'archive',\n\t'blame',\n\t'cat-file',\n\t'check-attr',\n\t'check-ignore',\n\t'check-mailmap',\n\t'check-ref-format',\n\t'cherry',\n\t'commit-tree',\n\t'count-objects',\n\t'describe',\n\t'diff',\n\t'diff-files',\n\t'diff-index',\n\t'diff-tree',\n\t'for-each-ref',\n\t'fsck',\n\t'grep',\n\t'hash-object',\n\t'help',\n\t'log',\n\t'ls-files',\n\t// Asks a remote what it has; nothing local moves.\n\t'ls-remote',\n\t'ls-tree',\n\t'merge-base',\n\t'merge-tree',\n\t'mktree',\n\t'name-rev',\n\t'patch-id',\n\t'range-diff',\n\t'rev-list',\n\t'rev-parse',\n\t'shortlog',\n\t'show',\n\t'show-branch',\n\t'show-ref',\n\t'status',\n\t'var',\n\t'verify-commit',\n\t'verify-pack',\n\t'verify-tag',\n\t'version',\n\t'whatchanged',\n\t'write-tree',\n]);\n\nconst reflogWriteSubcommands: ReadonlySet<string> = new Set(['expire', 'delete', 'drop']);\n\n/**\n * Sub-commands of otherwise-mutating verbs that only list. `''` is the bare verb, which lists for `branch`,\n * `tag`, `remote` and `notes`; `branch -v` and every `tag` filter imply git's own list mode.\n */\nconst readOnlySubcommands: Readonly<Record<string, ReadonlySet<string>>> = {\n\tbranch: new Set([\n\t\t'',\n\t\t'-l',\n\t\t'--list',\n\t\t'--show-current',\n\t\t'-a',\n\t\t'-r',\n\t\t'-v',\n\t\t'-vv',\n\t\t'--verbose',\n\t\t'--contains',\n\t\t'--no-contains',\n\t\t'--merged',\n\t\t'--no-merged',\n\t\t'--points-at',\n\t]),\n\tconfig: new Set(['get', 'list']),\n\tnotes: new Set(['', 'list', 'show', 'get-ref']),\n\tstash: new Set(['list', 'show']),\n\ttag: new Set([\n\t\t'',\n\t\t'-l',\n\t\t'--list',\n\t\t'-n',\n\t\t'-v',\n\t\t'--verify',\n\t\t'--contains',\n\t\t'--no-contains',\n\t\t'--merged',\n\t\t'--no-merged',\n\t\t'--points-at',\n\t]),\n\tworktree: new Set(['list']),\n\tremote: new Set(['', '-v', 'get-url', 'show']),\n};\n\n/**\n * Options that make an argv write whatever else it contains, checked across the whole argv rather than\n * only its first token: `branch -r -d origin/x` leads with a listing flag and still deletes.\n */\nconst writeOptions: Readonly<Record<string, readonly string[]>> = {\n\tbranch: [\n\t\t'-d',\n\t\t'-D',\n\t\t'--delete',\n\t\t'-m',\n\t\t'-M',\n\t\t'--move',\n\t\t'-c',\n\t\t'-C',\n\t\t'--copy',\n\t\t'-f',\n\t\t'--force',\n\t\t'-t',\n\t\t'--track',\n\t\t'--no-track',\n\t\t'-u',\n\t\t'--set-upstream-to',\n\t\t'--unset-upstream',\n\t\t'--edit-description',\n\t],\n\tconfig: [\n\t\t'--add',\n\t\t'--replace-all',\n\t\t'--unset',\n\t\t'--unset-all',\n\t\t'--rename-section',\n\t\t'--remove-section',\n\t\t'-e',\n\t\t'--edit',\n\t],\n};\n\nconst configReadOptions = new Set([\n\t'--get',\n\t'--get-all',\n\t'--get-regexp',\n\t'--get-urlmatch',\n\t'--get-color',\n\t'--get-colorbool',\n\t'--list',\n\t'-l',\n]);\n\nfunction hasWriteOption(verb: string, rest: readonly string[]): boolean {\n\tconst options = writeOptions[verb];\n\tif (options == null) return false;\n\treturn rest.some(arg => options.some(opt => arg === opt || arg.startsWith(`${opt}=`)));\n}\n\n/**\n * `config <key>` with nothing after the key is git's own read form, as is any `--get*`/`--list`. `config edit`\n * (git 2.46's subcommand form of `--edit`) also has a single non-flag argument but writes.\n */\nfunction isConfigRead(rest: readonly string[]): boolean {\n\tif (rest[0] === 'edit') return false;\n\tif (rest.some(arg => configReadOptions.has(arg))) return true;\n\n\treturn rest.filter(arg => !arg.startsWith('-')).length === 1;\n}\n\n/** Global options whose value is the next argument, so the verb scan must skip both. */\nconst globalOptionsWithValue = new Set([\n\t'-c',\n\t'--config-env',\n\t'--exec-path',\n\t'--git-dir',\n\t'--namespace',\n\t'--super-prefix',\n\t'--work-tree',\n]);\n\nexport interface LeadingCommand {\n\tverb: string;\n\treadOnly: boolean;\n\t/** The first token after the verb, unresolved — used for subcommand-shaped decisions (`worktree add`). */\n\tsubcommand?: string;\n\t/** The `-C <path>` target when the caller re-scopes the command to another working tree. */\n\tpathOverride?: string;\n}\n\n/**\n * Skips the global options (`-c key=val`, `-C path`) git accepts before the verb to find it, and notes a\n * `-C` re-scope so notification targets that tree.\n */\nexport function leadingCommand(args: readonly string[]): LeadingCommand {\n\tlet pathOverride: string | undefined;\n\tlet i = 0;\n\twhile (i < args.length) {\n\t\tconst arg = args[i];\n\t\tif (arg === '-C') {\n\t\t\t// git applies each `-C` relative to the one before it\n\t\t\tconst path = args[i + 1];\n\t\t\tif (path != null) {\n\t\t\t\tpathOverride = pathOverride == null || isAbsolute(path) ? path : join(pathOverride, path);\n\t\t\t}\n\t\t\ti += 2;\n\n\t\t\tcontinue;\n\t\t}\n\t\tif (globalOptionsWithValue.has(arg)) {\n\t\t\ti += 2;\n\n\t\t\tcontinue;\n\t\t}\n\t\tif (arg.startsWith('-')) {\n\t\t\ti += 1;\n\n\t\t\tcontinue;\n\t\t}\n\t\tbreak;\n\t}\n\tconst verb = args[i] ?? '';\n\tconst rest = args.slice(i + 1);\n\tconst readOnly =\n\t\t!hasWriteOption(verb, rest) &&\n\t\t(readOnlyVerbs.has(verb) ||\n\t\t\t(readOnlySubcommands[verb]?.has(rest[0] ?? '') ?? false) ||\n\t\t\t(verb === 'config' && isConfigRead(rest)) ||\n\t\t\t// Every `reflog` form reads (bare, `<ref>`, `show`, `list`, `exists`) except the three that rewrite\n\t\t\t// it. Base-branch detection answers \"none\" unless a branch's reflog has exactly one creation entry,\n\t\t\t// so a rewrite can make a cached \"none\" derivable; no change kind names a reflog, so it resets all.\n\t\t\t(verb === 'reflog' && !reflogWriteSubcommands.has(rest[0] ?? '')) ||\n\t\t\t// A bare `symbolic-ref <name>` reads; a second non-flag argument, or a delete, writes.\n\t\t\t(verb === 'symbolic-ref' &&\n\t\t\t\t!rest.includes('-d') &&\n\t\t\t\t!rest.includes('--delete') &&\n\t\t\t\trest.filter(a => !a.startsWith('-')).length < 2));\n\n\treturn { verb: verb, readOnly: readOnly, subcommand: rest[0], pathOverride: pathOverride };\n}\n\n/**\n * The change kinds every worktree sharing a `.git` sees: its refs, stash, worktree list and config. The rest a\n * classified verb announces — HEAD, the index, a paused operation, FETCH_HEAD — belong to the one tree the\n * command ran in, so a `-C`-scoped write tells the caller's own `cwd` only this subset of what it changed.\n */\nconst worktreeSharedChanges: ReadonlySet<RepositoryChange> = new Set([\n\t'heads',\n\t'tags',\n\t'stash',\n\t'remotes',\n\t'worktrees',\n\t'config',\n]);\n\n/**\n * Verbs whose effect is confined to the object store that nothing cached observes — repacking or pruning\n * `.git/objects` changes no cached read (branches, refs, status, worktrees, …). `init` and `clone` create a\n * repository rather than mutate a registered one, so there is nothing yet registered to notify.\n */\nconst objectOnlyVerbs = new Set([\n\t'gc',\n\t'repack',\n\t'prune',\n\t'maintenance',\n\t'commit-graph',\n\t'multi-pack-index',\n\t'init',\n\t'clone',\n]);\n\n/**\n * The {@link RepositoryChange} kinds each mutating verb announces. A worktree subcommand other than a\n * listing is handled separately (see {@link getChangesForCommand}), and any verb absent from both this\n * table and {@link objectOnlyVerbs} announces `[]` — the conservative default for an unclassified\n * mutation: the caller still learns something changed, just not what. An entry covers at least what the\n * verb's typed mutator announces; `update-ref` and `symbolic-ref` name every kind their target ref could be.\n * The kinds decide which caches the announcement resets, so a verb that can start or end a paused operation\n * names `pausedOp`: `commit` concludes a merge, cherry-pick or revert, `reset` aborts one, and `am` runs in\n * `rebase-apply`.\n */\nconst changesByVerb: Readonly<Record<string, readonly RepositoryChange[]>> = {\n\tcommit: ['head', 'heads', 'index', 'pausedOp'],\n\tam: ['head', 'heads', 'index', 'pausedOp'],\n\tbisect: ['head', 'index'],\n\tcheckout: ['head', 'heads', 'index'],\n\tswitch: ['head', 'heads', 'index'],\n\treset: ['head', 'heads', 'index', 'pausedOp'],\n\tmerge: ['head', 'heads', 'index', 'pausedOp', 'merge'],\n\trebase: ['head', 'heads', 'index', 'pausedOp', 'rebase'],\n\t'cherry-pick': ['head', 'heads', 'index', 'pausedOp', 'cherryPick'],\n\trevert: ['head', 'heads', 'index', 'pausedOp', 'revert'],\n\tpull: ['head', 'heads', 'index', 'remotes', 'tags', 'lastFetched', 'pausedOp', 'merge', 'rebase'],\n\tadd: ['index'],\n\trm: ['index'],\n\tmv: ['index'],\n\trestore: ['index'],\n\tapply: ['index'],\n\t'read-tree': ['index'],\n\t'update-index': ['index'],\n\tclean: ['index'],\n\tstash: ['stash', 'index'],\n\t'update-ref': ['head', 'heads', 'remotes', 'tags', 'stash'],\n\tbranch: ['heads', 'remotes', 'tags'],\n\t'symbolic-ref': ['head', 'heads', 'remotes', 'tags'],\n\t'pack-refs': ['heads', 'remotes', 'tags'],\n\ttag: ['tags'],\n\t// A refspec can write a local branch (`fetch origin main:main`), which only the typed fetch parses for\n\tfetch: ['heads', 'remotes', 'tags', 'lastFetched'],\n\tpush: ['remotes'],\n\tremote: ['remotes', 'config'],\n\tconfig: ['config', 'heads', 'remotes'],\n\tnotes: ['heads'],\n};\n\nconst worktreeChanges: readonly RepositoryChange[] = ['worktrees', 'heads'];\nconst emptyChanges: readonly RepositoryChange[] = [];\n\nexport interface CommandChanges {\n\tchanges: readonly RepositoryChange[];\n\t/** The `-C <path>` target when the caller re-scoped the command to another working tree. */\n\tpathOverride?: string;\n\t/** The subset of {@link changes} every worktree sharing the same `.git` sees, not just the tree the command ran in. */\n\tsharedChanges: readonly RepositoryChange[];\n}\n\n/**\n * Classifies a raw git argv for the notification `git.run`'s `notify: 'infer'` applies after the run\n * settles. Returns `undefined` for a read-only or object-only command — nothing to announce — otherwise\n * the {@link RepositoryChange} kinds the verb announces, the `-C` re-scope target (if any), and which of\n * those kinds every worktree sees.\n */\nexport function getChangesForCommand(args: readonly string[]): CommandChanges | undefined {\n\tconst command = leadingCommand(args);\n\tif (command.readOnly || objectOnlyVerbs.has(command.verb)) return undefined;\n\n\t// `worktree list` is read-only (filtered out above); every other subcommand adds, removes or\n\t// relocks a checkout, which is both a worktree-list change and, for `add`, a brand-new HEAD.\n\tconst changes = command.verb === 'worktree' ? worktreeChanges : (changesByVerb[command.verb] ?? emptyChanges);\n\treturn {\n\t\tchanges: changes,\n\t\tpathOverride: command.pathOverride,\n\t\tsharedChanges: changes.filter(c => worktreeSharedChanges.has(c)),\n\t};\n}\n"],"mappings":"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"}

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

@@ -1,4 +1,5 @@
-import { BranchErrorReason, CheckoutErrorReason, CherryPickErrorReason, CommitErrorReason, FetchErrorReason, GitCommandError, GitSearchErrorReason, GitWarningKey, GitWarnings, MergeErrorReason, PausedOperationAbortErrorReason, PausedOperationContinueErrorReason, PullErrorReason, PushErrorReason, RebaseErrorReason, ResetErrorReason, RevertErrorReason, ShowErrorReason, SigningErrorReason, StashApplyErrorReason, StashPushErrorReason, TagErrorReason, WorktreeCreateErrorReason, WorktreeDeleteErrorReason } from "../../git/errors.js";
+import { BranchErrorReason, CheckoutErrorReason, CherryPickErrorReason, CommitErrorReason, FetchErrorReason, GitCommandError, GitSearchErrorReason, GitWarningKey, GitWarnings, MergeErrorReason, PausedOperationAbortErrorReason, PausedOperationContinueErrorReason, PullErrorReason, PushErrorReason, RebaseErrorReason, ReferenceUpdateErrorReason, ResetErrorReason, RevertErrorReason, ShowErrorReason, SigningErrorReason, StashApplyErrorReason, StashPushErrorReason, TagErrorReason, WorktreeCreateErrorReason, WorktreeDeleteErrorReason } from "../../git/errors.js";
+import { RepositoryChange } from "../../git/models/repository.js";
 import { SigningFormat } from "../../git/models/signature.js";
 import { GitHealthSlownessCategory } from "../../git/gitHealth.js";
 import { GitCommandPriority, GitResult, GitRunOptions, GitSpawnOptions } from "../../git/run.types.js";
@@ -51,7 +52,9 @@ export declare const GitErrors: {
   readonly noRemoteReference: RegExp;
   readonly noRemoteRepositorySpecified: RegExp;
   readonly noUpstream: RegExp;
+  readonly noTrackingInformation: RegExp;
   readonly notAValidObjectName: RegExp;
+  readonly notPossibleToFastForward: RegExp;
   readonly notAWorkingTree: RegExp;
   readonly noUserNameConfigured: RegExp;
   readonly nothingToCommit: RegExp;
@@ -67,7 +70,13 @@ export declare const GitErrors: {
   readonly rebaseMultipleBranches: RegExp;
   readonly revertAborted: RegExp;
   readonly revertInProgress: RegExp;
+  readonly refAlreadyExists: RegExp;
+  readonly refBadName: RegExp;
   readonly refLocked: RegExp;
+  readonly refNonexistentObject: RegExp;
+  readonly refNotAValidSha: RegExp;
+  readonly refUnableToResolve: RegExp;
+  readonly refValueMismatch: RegExp;
   readonly remoteAhead: RegExp;
   readonly remoteConnectionFailed: RegExp;
   readonly remoteRejected: RegExp;
@@ -103,7 +112,7 @@ export type PushForceOptions = {
   withLease: false;
   ifIncludes?: never;
 };
-type GitCommand = 'branch' | 'checkout' | 'cherry-pick' | 'commit' | 'fetch' | 'merge' | 'paused-operation-abort' | 'paused-operation-continue' | 'pull' | 'push' | 'rebase' | 'reset' | 'revert' | 'show' | 'stash-apply' | 'stash-push' | 'tag' | 'worktree-create' | 'worktree-delete';
+type GitCommand = 'branch' | 'checkout' | 'cherry-pick' | 'commit' | 'fetch' | 'merge' | 'paused-operation-abort' | 'paused-operation-continue' | 'pull' | 'push' | 'rebase' | 'reset' | 'revert' | 'show' | 'stash-apply' | 'stash-push' | 'tag' | 'update-ref' | 'update-ref-delete' | 'worktree-create' | 'worktree-delete';
 type GitCommandToReasonMap = {
   branch: BranchErrorReason;
   checkout: CheckoutErrorReason;
@@ -122,6 +131,8 @@ type GitCommandToReasonMap = {
   'stash-apply': StashApplyErrorReason;
   'stash-push': StashPushErrorReason;
   tag: TagErrorReason;
+  'update-ref': ReferenceUpdateErrorReason;
+  'update-ref-delete': ReferenceUpdateErrorReason;
   'worktree-create': WorktreeCreateErrorReason;
   'worktree-delete': WorktreeDeleteErrorReason;
 };
@@ -221,13 +232,23 @@ export declare class Git {
   private readonly _eventLoopMonitor;
   /** Count of git commands currently in flight, across both the exec and streaming paths */
   private _activeCommandCount;
-  /** Cached base environment: process.env + static options.env + GCM/LC_ALL vars */
+  /** Cached base environment: process.env (minus {@link inheritedEnvKeysToDrop}) + static options.env + GCM/LC_ALL vars */
   private _baseEnv;
   /** Cached full environment: base + dynamic getEnvironment() result */
   private _fullEnv;
   /** Last dynamic env reference, used to detect when getEnvironment() returns a new object */
   private _lastDynamicEnv;
+  /** Bound via {@link bindChangeNotifier}; announces a `notify`-flagged run's changes. No-op until bound. */
+  private _changeNotifier;
   constructor(_locator: () => Promise<GitLocation>, options?: GitOptions);
+  /**
+   * Binds the callback a `notify`-flagged {@link run} calls once it settles. `CliGitProvider` wires this
+   * to its own `notifyChanged` from its constructor — including when it's handed a pre-built `Git` via
+   * `options.git`, so a host-supplied instance gets bound too. With nothing bound, `notify` is a no-op.
+   * `repoPaths` holds more than one path only for a `-C`-scoped shared-state verb: the `-C` target, then the
+   * caller's own `cwd`.
+   */
+  bindChangeNotifier(fn: (repoPaths: readonly string[], changes: readonly RepositoryChange[]) => void): void;
   /**
    * Returns the base environment for git commands. Cached to avoid spreading
    * process.env (30-100+ keys) on every call. Includes static options.env and
@@ -246,8 +267,12 @@ export declare class Git {
    */
   private buildEnv;
   dispose(): void;
-  /** Clear pending commands (e.g. on cache reset) */
-  clearPendingCommands(): void;
+  /**
+   * Drops in-flight commands so a later identical call spawns its own run instead of joining one that
+   * started before a change. With `repoPaths`, drops only runs whose `cwd` is one of them or inside one;
+   * without, drops every run.
+   */
+  clearPendingCommands(repoPaths?: readonly string[]): void;
   /** Marks one more git command as in flight; starts the event-loop monitor on the first. */
   private beginActiveCommand;
   /** Marks a git command as finished; stops the event-loop monitor once none remain. */
@@ -265,6 +290,12 @@ export declare class Git {
   ensureSupports(feature: GitFeatures, message: GitFeatureUnsupportedMessage): Promise<void>;
   run(options: ExitCodeOnlyGitCommandOptions, ...args: readonly (string | undefined)[]): Promise<GitResult<unknown>>;
   run<T extends string | Buffer = string>(options: GitRunOptions, ...args: readonly (string | undefined)[]): Promise<GitResult<T>>;
+  /**
+   * Applies `options.notify` once a {@link run} has settled — a no-op unless both `notify` and a
+   * {@link bindChangeNotifier bound} notifier are present, so an unflagged caller pays nothing.
+   */
+  private applyNotify;
+  private resolveNotifyPath;
   private runCore;
   stream(options: GitSpawnOptions, ...args: readonly (string | undefined)[]): AsyncGenerator<string>;
   rev_parse__git_dir(cwd: string): Promise<{