surshar / claude-code

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.

		@@ -30,12 +30,13 @@
30	30	fetchDiff: (mode: Git.BaseMode) => Promise<Git.FetchOutcome>
31	31
32	32	/**
33		- * One row's hunks against the base its fetch read (Git.fetchFileHunks).
	33	+ * The rows' hunks by path against the base their fetch read, null where
	34	+ * they could not be read (Git.fetchHunks).
34	35	*/
35		- fetchFileHunks: (
	36	+ fetchHunks: (
36	37	data: Git.DiffData,
37		- file: Git.FileStat,
38		- ) => Promise<Git.FileHunks \| null>
	38	+ files: readonly Git.FileStat[],
	39	+ ) => Promise<ReadonlyMap<string, Git.FileHunks \| null>>
39	40
40	41	/**
41	42	* A string that changes when the checked-out commit moves

		@@ -1,0 +1,17 @@
	1	+/**
	2	+ * What the hunks read adds to the shared diff argv: the listed names and
	3	+ * every file's patch from one child, each file as it reads when asked alone.
	4	+ *
	5	+ * `--raw -z` heads the answer with the names as git holds them, NUL-ended
	6	+ * and never quoted; no rename is paired among the paths asked together, as
	7	+ * none can be for one path; the header's `a/` and `b/` hold whatever a
	8	+ * person's `diff.noprefix`, `diff.mnemonicPrefix` or prefixes are set to.
	9	+ */
	10	+export const HUNKS_ARGS = [
	11	+ '--no-renames',
	12	+ '--src-prefix=a/',
	13	+ '--dst-prefix=b/',
	14	+ '--raw',
	15	+ '-z',
	16	+ '-p',
	17	+] as const

		@@ -1,0 +1,3 @@
	1	+export * from './hunks-args.js'
	2	+
	3	+export * as default from '.'

		@@ -1,5 +1,6 @@
1	1	export * from './diff-leading-args.js'
2	2	export * from './git-child-env'
	3	+export * from './hunks-args'
3	4	export * from './no-optional-locks.js'
4	5	export * from './pinned-lead-of'
5	6

		@@ -1,51 +1,0 @@
1		-import Argv from '../argv'
2		-import { EMPTY_FILE_HUNKS } from '../empty-file-hunks'
3		-import Parse from '../parse'
4		-import type Types from '../types'
5		-import { isLastOfDiff } from './is-last-of-diff'
6		-import { withClosingLine } from './with-closing-line'
7		-
8		-/**
9		- * One file's hunks against the base its row was read against, so body and
10		- * counts agree, by literal pathspec, as the built-in panel reads hunks.
11		- *
12		- * An untracked, binary or renamed row (the built-in shows a rename's
13		- * counts, never its body), or on an unborn HEAD a file edited after
14		- * staging, answers no hunks; each file but the last, a closing empty row.
15		- *
16		- * @param run runs git against the pinned repository
17		- * @param data the fetch the row belongs to
18		- * @param file the row
19		- * @returns the parsed body, or null when git failed
20		- */
21		-export async function fetchFileHunks(
22		- run: Types.GitRun,
23		- data: Types.DiffData,
24		- file: Types.FileStat,
25		-): Promise<Types.FileHunks \| null> {
26		- const hasNoBody =
27		- file.isUntracked \|\|
28		- file.isBinary \|\|
29		- file.renamedFrom !== null \|\|
30		- data.stalePaths.includes(file.path)
31		-
32		- if (hasNoBody) {
33		- return EMPTY_FILE_HUNKS
34		- }
35		-
36		- const { exitCode, stdout } = await run([
37		- '--literal-pathspecs',
38		- ...Argv.DIFF_LEADING_ARGS,
39		- data.baseRef,
40		- '--',
41		- file.path,
42		- ])
43		-
44		- if (exitCode !== 0) {
45		- return null
46		- }
47		-
48		- const body = Parse.parseFileDiff(stdout)
49		-
50		- return isLastOfDiff(data, file) ? body : withClosingLine(body)
51		-}

		@@ -1,5 +1,0 @@
1		-export * from './fetch-file-hunks.js'
2		-export * from './is-last-of-diff'
3		-export * from './with-closing-line'
4		-
5		-export * as default from '.'

		@@ -1,3 +1,0 @@
1		-export * from './is-last-of-diff.js'
2		-
3		-export * as default from '.'

		@@ -1,18 +1,0 @@
1		-import type Types from '../../types'
2		-
3		-/**
4		- * Whether a row is the last file of the whole diff git printed for its
5		- * fetch: the last tracked row, the untracked ones being listed apart.
6		- *
7		- * The built-in reads that diff in one piece and trims its end, so the last
8		- * file alone has no closing empty line to draw (withClosingLine).
9		- *
10		- * @param data the fetch the row belongs to
11		- * @param file the row
12		- * @returns whether git printed this file last
13		- */
14		-export const isLastOfDiff = (
15		- data: Types.DiffData,
16		- file: Types.FileStat,
17		-): boolean =>
18		- data.files.filter(row => !row.isUntracked).at(-1)?.path === file.path

		@@ -1,3 +1,0 @@
1		-export * from './with-closing-line.js'
2		-
3		-export * as default from '.'

		@@ -1,27 +1,0 @@
1		-import type Types from '../../types'
2		-
3		-/**
4		- * A parsed body with one empty context row after its last hunk's lines, as
5		- * the built-in panel draws the empty line that closes git's output.
6		- *
7		- * The built-in reads every file's diff in one piece: the newline before the
8		- * next file's header parses as a context line of the file before it. A
9		- * body with no hunk, or one already cut, gains nothing.
10		- *
11		- * @param body the parsed body
12		- * @returns the body, its last hunk one row longer
13		- */
14		-export function withClosingLine(body: Types.FileHunks): Types.FileHunks {
15		- const last = body.hunks.at(-1)
16		- const isClosed = last !== undefined && !body.isTruncated
17		-
18		- return isClosed
19		- ? {
20		- ...body,
21		- hunks: [
22		- ...body.hunks.slice(0, -1),
23		- { ...last, lines: [...last.lines, ' '] },
24		- ],
25		- }
26		- : body
27		-}

		@@ -3,7 +3,7 @@
3	3	import Argv from './argv'
4	4	import { FAILED_RUN } from './failed-run'
5	5	import { fetchDiff } from './fetch-diff'
6		-import { fetchFileHunks } from './fetch-file-hunks'
	6	+import { fetchHunks } from './fetch-hunks'
7	7	import { GIT_BASE_MODES } from './git-base-modes'
8	8	import { GIT_WORDS } from './git-words'
9	9	import Probes from './probes'
		@@ -69,7 +69,7 @@
69	69
70	70	return fetchDiff(depsOf(await baseline), mode)
71	71	},
72		- fetchFileHunks: (data, file) => fetchFileHunks(run, data, file),
	72	+ fetchHunks: (data, files) => fetchHunks(run, data, files),
73	73	headKeyOf: () =>
74	74	Probes.headKeyOf(
75	75	{ ...depsOf(null), readFile: host.readFile },

		@@ -1,0 +1,5 @@
	1	+/**
	2	+ * How the line that opens one file's patch starts. No line inside a patch
	3	+ * starts so: a hunk's lines start with a space, `+`, `-` or a backslash.
	4	+ */
	5	+export const FILE_HEADER_START = 'diff --git '

		@@ -1,0 +1,93 @@
	1	+import Limits from '../../../limits'
	2	+import { EMPTY_FILE_HUNKS } from '../../empty-file-hunks'
	3	+import type Types from '../../types'
	4	+import { FILE_HEADER_START } from '../file-header-start'
	5	+import { isWholeListing } from '../is-whole-listing'
	6	+import { parseFileDiff } from '../parse-file-diff.js'
	7	+import { QUOTED_HEADER_START } from '../quoted-header-start'
	8	+import { UNMERGED_STATUS } from '../unmerged-status'
	9	+
	10	+/**
	11	+ * The bodies one `git diff --raw -z -p` answer settles, by path: each file's
	12	+ * patch parsed as one file's, under the name git listed for it.
	13	+ *
	14	+ * The n-th patch is the n-th NUL-ended name's, unmerged names having none and
	15	+ * neighbours under one opening line being one file; an unquoted opening line
	16	+ * must equal its name's. Where the host cut, a file waits unless large.
	17	+ *
	18	+ * @param stdout the child's standard output
	19	+ * @param asked the paths the child was asked for
	20	+ * @returns the settled bodies; none where names and patches disagree
	21	+ */
	22	+export function parseFileDiffs(
	23	+ stdout: string,
	24	+ asked: readonly string[],
	25	+): ReadonlyMap<string, Types.FileHunks> {
	26	+ const fields = stdout.split('\0')
	27	+
	28	+ const patchAt = fields.findIndex(
	29	+ (field, at) => at % 2 === 0 && !field.startsWith(':'),
	30	+ )
	31	+
	32	+ const listed = fields
	33	+ .slice(0, patchAt)
	34	+ .filter(
	35	+ (_, at) => at % 2 === 1 && !fields[at - 1]?.endsWith(UNMERGED_STATUS),
	36	+ )
	37	+
	38	+ const isParted = fields[patchAt] === ''
	39	+

		@@ -1,0 +1,7 @@
	1	+import { FILE_HEADER_START } from '../file-header-start'
	2	+
	3	+/**
	4	+ * How a patch's opening line starts when git quoted the name in it: a name
	5	+ * holding a double quote, a backslash or a control character.
	6	+ */
	7	+export const QUOTED_HEADER_START = `${FILE_HEADER_START}"`

		@@ -1,0 +1,87 @@
	1	+import Limits from '../../limits'
	2	+import Argv from '../argv'
	3	+import { EMPTY_FILE_HUNKS } from '../empty-file-hunks'
	4	+import Parse from '../parse'
	5	+import type Types from '../types'
	6	+import { isLastOfDiff } from './is-last-of-diff'
	7	+import { withClosingLine } from './with-closing-line'
	8	+
	9	+/**
	10	+ * The rows' hunks against the base their counts were read against, from one
	11	+ * git child over their literal paths; each but the last, a closing empty row.
	12	+ *
	13	+ * A row with no body (untracked, binary, renamed, or staged then edited on
	14	+ * an unborn HEAD) is never named to git. Paths past MAX_PATHSPEC_CHARS and
	15	+ * files a cut answer left unread go to a further child.
	16	+ *
	17	+ * @param run runs git against the pinned repository
	18	+ * @param data the fetch the rows belong to
	19	+ * @param files the rows
	20	+ * @returns each row's parsed body by path, null where git failed
	21	+ */
	22	+export async function fetchHunks(
	23	+ run: Types.GitRun,
	24	+ data: Types.DiffData,
	25	+ files: readonly Types.FileStat[],
	26	+): Promise<ReadonlyMap<string, Types.FileHunks \| null>> {
	27	+ const bodied = files.filter(
	28	+ file =>
	29	+ !file.isUntracked &&
	30	+ !file.isBinary &&
	31	+ file.renamedFrom === null &&
	32	+ !data.stalePaths.includes(file.path),
	33	+ )
	34	+
	35	+ const bodiless = files
	36	+ .filter(file => !bodied.includes(file))
	37	+ .map(file => [file.path, EMPTY_FILE_HUNKS] as const)
	38	+
	39	+ if (bodied.length === 0) {
	40	+ return new Map(bodiless)
	41	+ }
	42	+
	43	+ let spent = 0
	44	+
	45	+ const asked = bodied
	46	+ .map(file => file.path)
	47	+ .filter((path, at) => {
	48	+ spent += path.length
	49	+
	50	+ return at === 0 \|\| spent <= Limits.MAX_PATHSPEC_CHARS
	51	+ })
	52	+
	53	+ const { exitCode, stdout } = await run([
	54	+ '--literal-pathspecs',
	55	+ ...Argv.DIFF_LEADING_ARGS,
	56	+ ...Argv.HUNKS_ARGS,
	57	+ data.baseRef,
	58	+ '--',
	59	+ ...asked,
	60	+ ])
	61	+
	62	+ const hasAnswered = exitCode === 0
	63	+
	64	+ const settled = hasAnswered
	65	+ ? Parse.parseFileDiffs(stdout, asked)
	66	+ : new Map<string, Types.FileHunks>()
	67	+
	68	+ const waiting = bodied.filter(file => !settled.has(file.path))
	69	+ const isStuck = settled.size === 0
	70	+
	71	+ const rest = isStuck
	72	+ ? waiting.map(file => [file.path, null] as const)
	73	+ : await fetchHunks(run, data, waiting)
	74	+
	75	+ return new Map<string, Types.FileHunks \| null>([
	76	+ ...bodiless,
	77	+ ...bodied.flatMap(file => {
	78	+ const body = settled.get(file.path)
	79	+ const isLast = isLastOfDiff(data, file)
	80	+
	81	+ return body
	82	+ ? [[file.path, isLast ? body : withClosingLine(body)] as const]
	83	+ : []
	84	+ }),
	85	+ ...rest,
	86	+ ])
	87	+}

		@@ -1,0 +1,5 @@
	1	+export * from './fetch-hunks.js'
	2	+export * from './is-last-of-diff'
	3	+export * from './with-closing-line'
	4	+
	5	+export * as default from '.'

		@@ -1,0 +1,3 @@
	1	+export * from './is-last-of-diff.js'
	2	+
	3	+export * as default from '.'

		@@ -1,0 +1,18 @@
	1	+import type Types from '../../types'
	2	+
	3	+/**
	4	+ * Whether a row is the last file of the whole diff git printed for its
	5	+ * fetch: the last tracked row, the untracked ones being listed apart.
	6	+ *
	7	+ * The built-in reads that diff in one piece and trims its end, so the last
	8	+ * file alone has no closing empty line to draw (withClosingLine).
	9	+ *
	10	+ * @param data the fetch the row belongs to
	11	+ * @param file the row
	12	+ * @returns whether git printed this file last
	13	+ */
	14	+export const isLastOfDiff = (
	15	+ data: Types.DiffData,
	16	+ file: Types.FileStat,
	17	+): boolean =>
	18	+ data.files.filter(row => !row.isUntracked).at(-1)?.path === file.path

		@@ -1,0 +1,3 @@
	1	+export * from './with-closing-line.js'
	2	+
	3	+export * as default from '.'

		@@ -1,0 +1,27 @@
	1	+import type Types from '../../types'
	2	+
	3	+/**
	4	+ * A parsed body with one empty context row after its last hunk's lines, as
	5	+ * the built-in panel draws the empty line that closes git's output.
	6	+ *
	7	+ * The built-in reads every file's diff in one piece: the newline before the
	8	+ * next file's header parses as a context line of the file before it. A
	9	+ * body with no hunk, or one already cut, gains nothing.
	10	+ *
	11	+ * @param body the parsed body
	12	+ * @returns the body, its last hunk one row longer
	13	+ */
	14	+export function withClosingLine(body: Types.FileHunks): Types.FileHunks {
	15	+ const last = body.hunks.at(-1)
	16	+ const isClosed = last !== undefined && !body.isTruncated
	17	+
	18	+ return isClosed
	19	+ ? {
	20	+ ...body,
	21	+ hunks: [
	22	+ ...body.hunks.slice(0, -1),
	23	+ { ...last, lines: [...last.lines, ' '] },
	24	+ ],
	25	+ }
	26	+ : body
	27	+}

		@@ -4,7 +4,7 @@
4	4	export * from './empty-file-hunks'
5	5	export * from './failed-run'
6	6	export * from './fetch-diff'
7		-export * from './fetch-file-hunks'
	7	+export * from './fetch-hunks'
8	8	export * from './git-backend-of.js'
9	9	export * from './git-base-modes'
10	10	export * from './git-words'

		@@ -1,0 +1,3 @@
	1	+export * from './file-header-start.js'
	2	+
	3	+export * as default from '.'

		@@ -1,11 +1,15 @@
	1	+export * from './file-header-start'
1	2	export * from './hunk-header'
2	3	export * from './is-body-line'
3	4	export * from './is-whole-answer'
4	5	export * from './is-whole-listing'
5	6	export * from './parse-file-diff.js'
	7	+export * from './parse-file-diffs'
6	8	export * from './parse-numstat.js'
7	9	export * from './parse-shortstat.js'
	10	+export * from './quoted-header-start'
8	11	export * from './rename-records'
9	12	export * from './shortstat-pattern'
	13	+export * from './unmerged-status'
10	14
11	15	export * as default from '.'

		@@ -1,0 +1,3 @@
	1	+export * from './parse-file-diffs.js'
	2	+
	3	+export * as default from '.'

		@@ -1,0 +1,3 @@
	1	+export * from './quoted-header-start.js'
	2	+
	3	+export * as default from '.'

		@@ -1,0 +1,3 @@
	1	+export * from './unmerged-status.js'
	2	+
	3	+export * as default from '.'

		@@ -1,0 +1,5 @@
	1	+/**
	2	+ * How the raw record of an unmerged path ends: its status, after the modes
	3	+ * and the object names. Git prints no patch for such a path.
	4	+ */
	5	+export const UNMERGED_STATUS = ' U'

		@@ -13,7 +13,6 @@
13	13	export * from './is-record'
14	14	export * from './kept-of'
15	15	export * from './limits'
16		-export * from './map-limited'
17	16	export * from './message-of'
18	17	export * from './mtime-of'
19	18	export * from './names'

		@@ -3,6 +3,7 @@
3	3	export * from './max-files-for-details.js'
4	4	export * from './max-lines-per-file.js'
5	5	export * from './max-listed-directories.js'
	6	+export * from './max-pathspec-chars'
6	7	export * from './max-untracked-probes.js'
7	8	export * from './max-visible-files.js'
8	9	export * from './pane'

		@@ -1,0 +1,3 @@
	1	+export * from './max-pathspec-chars.js'
	2	+
	3	+export * as default from '.'

		@@ -1,0 +1,9 @@
	1	+/**
	2	+ * How many characters of paths one git child is handed on its command
	3	+ * line; the rest are asked of a further child.
	4	+ *
	5	+ * Windows holds a whole command line to 32,767 characters and doubles a
	6	+ * quote or a backslash it has to escape: twice this, the quotes around each
	7	+ * path and the leading arguments stay under it.
	8	+ */
	9	+export const MAX_PATHSPEC_CHARS = 12_000

		@@ -1,5 +1,0 @@
1		-/**
2		- * How many files' hunks are read from the backend at once while the pane
3		- * loads its bodies.
4		- */
5		-export const BODY_FETCH_CONCURRENCY = 6

		@@ -1,4 +1,3 @@
1		-export * from './body-fetch-concurrency.js'
2	1	export * from './gutter-chrome.js'
3	2	export * from './max-summary-rows.js'
4	3	export * from './pane-top-pad-rows.js'

		@@ -1,3 +1,0 @@
1		-export * from './map-limited.js'
2		-
3		-export * as default from '.'