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.

		@@ -1,0 +1,40 @@
	1	+name: "Mod tests"
	2	+
	3	+on:
	4	+ pull_request:
	5	+ paths:
	6	+ - "mods/**"
	7	+ - ".github/workflows/mod-tests.yml"
	8	+
	9	+permissions:
	10	+ contents: read
	11	+
	12	+jobs:
	13	+ test:
	14	+ runs-on: ubuntu-latest
	15	+ steps:
	16	+ - name: Checkout repository
	17	+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
	18	+ with:
	19	+ persist-credentials: false
	20	+
	21	+ - name: Install Claude Code and TypeScript
	22	+ run: npm install -g @anthropic-ai/claude-code typescript@5.9.3
	23	+
	24	+ - name: Typecheck each mod's hooks and tests
	25	+ run: tsc -p mods/tsconfig.json
	26	+
	27	+ - name: Run each mod's tests
	28	+ run: \|
	29	+ if ! claude plugin test --help 2>/dev/null \| grep -q '^Usage: claude plugin test'; then
	30	+ echo "claude $(claude --version) has no 'plugin test' yet; skipping the test step"
	31	+ exit 0
	32	+ fi
	33	+ status=0
	34	+ for mod in mods/*/; do
	35	+ [ -d "$mod/tests" ] \|\| continue
	36	+ claude plugin test "$mod" \|\| status=1
	37	+ done
	38	+ exit $status
	39	+ env:
	40	+ CLAUDE_CODE_ENABLE_FUNCTION_HOOKS: "1"

		@@ -14,10 +14,102 @@
14	14	Each folder is a complete plugin: `.claude-plugin/plugin.json`, a
15	15	`hooks/hooks.json` naming the module, and TypeScript under `hooks/` typed
16	16	against the declarations `/plugin-types` writes (`import type … from
17		-'claude-code'`). To read one running from source:
	17	+'claude-code'`), kept here in `types/`. To read one running from source:
18	18
19	19	claude --plugin-dir mods/diff
20	20
	21	+## Testing
	22	+
	23	+A mod's tests are in its `tests/` folder, and run with
	24	+
	25	+ claude plugin test mods/diff
	26	+
	27	+A test gets the engine's own `$` and a plugin's `on`. Each call on `$` is one
	28	+the engine makes, through every hook of the mod loaded as it ships. The hooks
	29	+the test registers with `on` sit beneath the mod, where the rest of the world
	30	+would be, and nothing is beneath them: a call they leave unanswered throws,
	31	+naming its event.
	32	+
	33	+A test file is named for what it covers under `hooks/` (`register.test.ts`
	34	+beside `hooks/register.ts`, `git.test.ts` beside `hooks/git/`), and holds its
	35	+imports, the tier the mod loads in, and one `describe` titled with that name;
	36	+what several tests share sits under `tests/fixtures/`, one export a file.
	37	+
	38	+```ts
	39	+import { describe, expect, mock, test, tier } from 'claude-code/testing'
	40	+
	41	+tier('builtin')
	42	+
	43	+describe('register', () => {
	44	+ test('outside a git repository /diff says so, opens nothing', async ($, on) => {
	45	+ const opened: string[] = []
	46	+ mock.clock(on)
	47	+ on('session.start', ($, e) => ({ cwd: e.cwd }))
	48	+ on('command.register', ($, e) => ({ value: { command: e.name } }))
	49	+ on('process.run', () => ({
	50	+ value: { exitCode: 128, stdout: '', stderr: 'fatal: not a git repository' },
	51	+ }))
	52	+ on('ui.open', ($, e, next) => {
	53	+ opened.push(e.id)
	54	+ return next(e)
	55	+ })
	56	+
	57	+ await $.session.start({ surface: 'terminal', isInteractive: true, cwd: '/work' })
	58	+ const { text } = await $.command.run({
	59	+ command: 'diff',
	60	+ args: '',
	61	+ origin: { kind: 'composer' },
	62	+ })
	63	+
	64	+ expect(text).toContain("isn't in a git repository")
	65	+ expect(opened).toEqual([])
	66	+ })
	67	+})
	68	+```
	69	+
	70	+The kit's `mock` answers the world beneath the mod from memory, noun by noun,
	71	+each member a plain function over `on` registering hooks where the test calls
	72	+it: `mock.env(on, variables)` for `$.env`, `mock.store(on, entries)` for
	73	+`$.store`, and `mock.clock(on)` for `$.clock`, whose `advance(ms)` resolves
	74	+every wait the mod asked for (`$.clock.sleep`, `after`, `every`) as the clock
	75	+crosses it. To see what a dispatch does before it answers, start it
	76	+unawaited, `await clock.settle()`, then look: the clock stays where it was.
	77	+`$.ui.press({ plugin, key })` presses a `Button` the test rendered, as a
	78	+click in the terminal does.
	79	+
	80	+`tsc -p mods/tsconfig.json` typechecks every mod's hooks and tests against
	81	+`types/` and each mod's own `types/` contract.
	82	+
	83	+## Composing mods: noun contracts
	84	+
	85	+A mod that adds a noun to `$` in the `engine.create` fold owns that noun's
	86	+types, and keeps them in one place: its `types/index.d.ts`, a declaration
	87	+file with no imports that exports the types the noun is made of, each named
	88	+for the noun, and declares the noun on `EngineInterface` in `claude-code`
	89	+(`telemetry/types/index.d.ts` exports `Telemetry`, `TelemetryLogEntry`,
	90	+`TelemetryMarkEntry` and the rest, and declares `$.telemetry`).
	91	+
	92	+- The contract is the only declaration of the noun. The mod's own hooks
	93	+ import its types from the folder (`import type { Telemetry } from
	94	+ '../types'`), and the value its `engine.create` hook returns is checked
	95	+ against `EngineInterface['telemetry']`, so the implementation cannot drift
	96	+ from what callers read.
	97	+- A mod that calls another's noun reads the same file and never copies it:
	98	+ `mods/tsconfig.json` includes `/types//.d.ts`, so `$.telemetry.log(…)`
	99	+ in `diff` types against `telemetry`'s contract as it stands, and a helper
	100	+ that must name one of its types imports it from that folder by path.
	101	+- A test of a mod that calls another's noun seats a provider for it, an inline
	102	+ plugin whose `engine.create` hook adds the noun, and answers the calls the
	103	+ way it answers the engine's: `on('telemetry.log', ($, e) => ({ value:
	104	+ undefined }))` runs above the provider's own method, its `e` typed by the
	105	+ contract. With no provider loaded the `$` build refuses the hook, naming the
	106	+ noun nobody provides.
	107	+
	108	+A plugin outside this repository that depends on a mod's noun points its
	109	+tsconfig `include` at that mod's `types/` folder for now; once the engine
	110	+writes the contracts of the plugins a session has installed, `/plugin-types`
	111	+will put them beside `claude-code.d.ts` and the include goes away.
	112	+
21	113	Early access: hooks modules load only where function hooks are enabled, and
22	114	the API these mods are written against may change between releases without
23	115	notice. They are not listed in this repository's marketplace; the copies that

		@@ -7,7 +7,10 @@
7	7	repository's HEAD so a commit or checkout made elsewhere shows too. The
8	8	first successful edit of a session opens the pane by itself where the
9	9	terminal is wide enough (144 columns when the person never chose, 110 when
10		-they kept it open before; a person who closed it is left alone). A file's
	10	+they kept it open before; a person who closed it is left alone). On a
	11	+terminal under 110 columns `/diff` answers with the built-in's line asking
	12	+for a wider terminal and opens nothing; a pane opened wider that the surface
	13	+then seats inline shows only that line. A file's
11	14	ask button arms that file: its hunks ride the next prompt as context, once.
12	15
13	16	The pane compares the working tree against HEAD, split at the session's

		@@ -1,0 +1,5 @@
	1	+/**
	2	+ * The line an ask ends with when its diff was cut to fit the prompt.
	3	+ */
	4	+export const ASK_CUT_NOTE =
	5	+ '(The rest of this diff was cut: it did not fit in the prompt.)'

		@@ -1,0 +1,3 @@
	1	+export * from './ask-cut-note.js'
	2	+
	3	+export * as default from '.'

		@@ -1,0 +1,36 @@
	1	+import { ASK_CUT_NOTE } from './ask-cut-note'
	2	+
	3	+/**
	4	+ * An armed ask's text as it fits in the room a prompt's context has left:
	5	+ * whole when it fits, else its first lines and ASK_CUT_NOTE.
	6	+ *
	7	+ * @param text the armed ask's text
	8	+ * @param room the characters the context has left
	9	+ * @returns the text to attach, or undefined when not even its first line fits
	10	+ */
	11	+export function fittedAskTextOf(
	12	+ text: string,
	13	+ room: number,
	14	+): string \| undefined {
	15	+ if (text.length <= room) {
	16	+ return text
	17	+ }
	18	+
	19	+ const kept: string[] = []
	20	+ let used = ASK_CUT_NOTE.length
	21	+
	22	+ for (const line of text.split('\n')) {
	23	+ const cost = line.length + 1
	24	+
	25	+ if (used + cost > room) {
	26	+ break
	27	+ }
	28	+
	29	+ kept.push(line)
	30	+ used += cost
	31	+ }
	32	+
	33	+ const hasBody = kept.length > 1
	34	+
	35	+ return hasBody ? `${kept.join('\n')}\n${ASK_CUT_NOTE}` : undefined
	36	+}

		@@ -1,4 +1,6 @@
1	1	export * from './armed-ask'
2	2	export * from './armed-ask-of.js'
	3	+export * from './ask-cut-note'
	4	+export * from './fitted-ask-text-of.js'
3	5
4	6	export * as default from '.'

		@@ -2,10 +2,11 @@
2	2	import type { Backend, BackendHost, BackendProbe } from './types'
3	3
4	4	/**
5		- * The backend holding the session's directory: the first of `probes` that
6		- * answers one, else git when a git working tree holds it, else none. The
7		- * probes go first so a probe may claim a working copy by its own rule
8		- * (the nearer of two markers, say); a probe answers null wherever git
	5	+ * The backend holding the session's directory: another system's when its
	6	+ * probe answers first, else git when a git working tree holds it, else none.
	7	+ *
	8	+ * Other systems are asked first so one may claim a working copy by its own
	9	+ * rule (the nearer of two markers, say); each answers null wherever git
9	10	* should govern.
10	11	*
11	12	* @param host the bound host's runner and probes

		@@ -1,15 +1,12 @@
1	1	import type { BackendProbe } from './types'
2	2
3	3	/**
4		- * Where a host adds backends to the plugin: probes for version-control systems
5		- * other than git, consulted in insertion order before git (backendOf); a
6		- * probe answers null wherever git should govern. Empty as shipped, so the
7		- * plugin reads git alone. A host
8		- * that compiles the module in may add a probe once, before the plugin
9		- * registers; the module runs natively, so that probe is what
10		- * `session.start` sees. The module contract offers no other channel: the
11		- * options `register` receives are the manifest's userConfig, and the
12		- * shipped scan requires `register` itself to be a plain exported function.
	4	+ * Where a host adds backends: probes for version-control systems other than
	5	+ * git, asked in insertion order before git (backendOf). Empty as shipped.
	6	+ *
	7	+ * A host compiling the module in adds a probe once, before the plugin
	8	+ * registers: the module runs natively, and there is no other channel (the
	9	+ * options are the manifest's userConfig; the scan wants a plain function).
13	10	*/
14	11	// module-state-allow: module-evaluation code wiring — a compiling host adds its probe functions (code references, not runtime input) once before registration and never removes or rebinds them; tests pass probes to backendOf directly; a per-Host copy would hold the same functions
15	12	export const INSTALLED_BACKEND_PROBES = new Set<BackendProbe>()

		@@ -2,9 +2,8 @@
2	2	import type { BackendWords } from '../backend-words'
3	3
4	4	/**
5		- * The version-control system behind the pane, pinned once per session:
6		- * where its working tree is, which comparisons it offers, how it words
7		- * them, and the three reads the pane makes of it.
	5	+ * The version-control system behind the pane, pinned once per session: its
	6	+ * working tree, what it compares, how it words them, and the pane's reads.
8	7	*
9	8	* Git is the plugin's own backend; a host may install probes for others,
10	9	* consulted where no git working tree holds the directory (backendOf).
		@@ -16,7 +15,7 @@
16	15	repository: Pick<Git.Repository, 'toplevel'>
17	16
18	17	/**
19		- * The base modes the picker offers, in picker order.
	18	+ * What the picker offers to compare against, in its order.
20	19	*/
21	20	baseModes: readonly Git.BaseMode[]
22	21

		@@ -1,19 +1,20 @@
1	1	import type Git from '../../../git'
2		-import type Host from '../../../host'
	2	+import type { Host } from '../../../host'
3	3
4	4	/**
5		- * What pinning a backend takes from the bound host: the raw process
6		- * runner (each backend names its own program, argv lead, environment and
7		- * timeout), the file probes, the engine's clock, the session's start as it
8		- * stands at each fetch (a later `session.start` moves it), and the
9		- * branch-base listener.
	5	+ * What pinning a backend takes from the bound host: its raw process runner,
	6	+ * file probes, clock, session start and branch-base listener.
	7	+ *
	8	+ * Each backend names its own program, argv lead, environment and timeout
	9	+ * to the runner; the session's start is read as it stands at each fetch
	10	+ * (a later `session.start` moves it).
10	11	*/
11		-export type BackendHost = Pick<Host.Host, 'run' \| 'readFile'> &
	12	+export type BackendHost = Pick<Host, 'run' \| 'readFile'> &
12	13	Pick<Git.GitDeps, 'mtimeOf' \| 'entryKindsOf' \| 'onBranchBase'> & {
13	14	/**
14	15	* The engine's clock, in milliseconds (`$.clock.now`).
15	16	*/
16		- nowMs: () => number
	17	+ nowMs: () => Promise<number>
17	18
18	19	/**
19	20	* When the current session began, read at each fetch.

		@@ -15,6 +15,7 @@
15	15	export function isGeneratedFile(path: string) {
16	16	const name = baseNameOf(path).toLowerCase()
17	17	const rooted = rootedPathOf(path)
	18	+
18	19	const hasGeneratedSuffix = GENERATED_SUFFIXES.some(suffix =>
19	20	name.endsWith(suffix),
20	21	)

		@@ -1,0 +1,33 @@
	1	+import Probes from '../probes'
	2	+import Tiers from '../tiers'
	3	+import type Types from '../types'
	4	+
	5	+/**
	6	+ * One fetch of the session's pinned repository, as the built-in panel
	7	+ * fetches; every git child names it so paths stay root-relative.
	8	+ *
	9	+ * Mid-merge, mid-rebase, mid-cherry-pick or mid-revert, or when git cannot
	10	+ * answer, it is unavailable and the caller keeps what it had.
	11	+ *
	12	+ * @param deps the host: pinned git, the repository, the file probes
	13	+ * @param mode what to compare against
	14	+ * @returns the outcome
	15	+ */
	16	+export async function fetchDiff(
	17	+ deps: Types.GitDeps,
	18	+ mode: Types.BaseMode,
	19	+): Promise<Types.FetchOutcome> {
	20	+ const isBusy = await Probes.isTransient(
	21	+ deps.entryKindsOf,
	22	+ deps.repository.gitDir,
	23	+ )
	24	+
	25	+ if (isBusy) {
	26	+ return { kind: 'unavailable' }
	27	+ }
	28	+
	29	+ const context = Tiers.fetchContextOf(deps, mode)
	30	+ const isBranch = mode === 'branch'
	31	+
	32	+ return isBranch ? Tiers.branchTier(context) : Tiers.workingTreeTier(context)
	33	+}

		@@ -1,33 +1,0 @@
1		-import Probes from './probes'
2		-import Tiers from './tiers'
3		-import type Types from './types'
4		-
5		-/**
6		- * One fetch of the session's pinned repository, as the built-in panel
7		- * fetches; every git child names it so paths stay root-relative.
8		- *
9		- * Mid-merge, mid-rebase, mid-cherry-pick or mid-revert, or when git cannot
10		- * answer, it is unavailable and the caller keeps what it had.
11		- *
12		- * @param deps the host: pinned git, the repository, the file probes
13		- * @param mode what to compare against
14		- * @returns the outcome
15		- */
16		-export async function fetchDiff(
17		- deps: Types.GitDeps,
18		- mode: Types.BaseMode,
19		-): Promise<Types.FetchOutcome> {
20		- const isBusy = await Probes.isTransient(
21		- deps.entryKindsOf,
22		- deps.repository.gitDir,
23		- )
24		-
25		- if (isBusy) {
26		- return { kind: 'unavailable' }
27		- }
28		-
29		- const context = Tiers.fetchContextOf(deps, mode)
30		- const isBranch = mode === 'branch'
31		-
32		- return isBranch ? Tiers.branchTier(context) : Tiers.workingTreeTier(context)
33		-}

		@@ -3,7 +3,8 @@
3	3
4	4	/**
5	5	* Probes the session's directory for one backend's working tree: the
6		- * backend when it holds the directory, null when it does not or when git
7		- * should govern it instead (Git.gitBackendOf is git's).
	6	+ * backend when it holds the directory, else null.
	7	+ *
	8	+ * Null too where git should govern it instead (Git.gitBackendOf is git's).
8	9	*/
9	10	export type BackendProbe = (host: BackendHost) => Promise<Backend \| null>

		@@ -1,7 +1,9 @@
1	1	/**
2		- * The words the pane draws that name the backend: what uncommitted mode
3		- * compares against, the command whose failure the empty state names, the
4		- * tool that lists untracked files, and the note under an untracked row.
	2	+ * The words the pane draws that name the backend.
	3	+ *
	4	+ * What uncommitted mode compares against, the command whose failure the
	5	+ * empty state names, the tool that lists untracked files, and the note
	6	+ * under an untracked row.
5	7	*/
6	8	export type BackendWords = {
7	9	/**

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

		@@ -1,0 +1,41 @@
	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	+
	6	+/**
	7	+ * One file's hunks against the base its row was read against, so body and
	8	+ * counts agree, by literal pathspec, as the built-in panel reads hunks.
	9	+ *
	10	+ * A rename passes both its paths so git pairs them; an untracked or binary
	11	+ * row, or on an unborn HEAD a file edited after staging, has no honest
	12	+ * body and answers no hunks.
	13	+ *
	14	+ * @param run runs git against the pinned repository
	15	+ * @param data the fetch the row belongs to
	16	+ * @param file the row
	17	+ * @returns the parsed body, or null when git failed
	18	+ */
	19	+export async function fetchFileHunks(
	20	+ run: Types.GitRun,
	21	+ data: Types.DiffData,
	22	+ file: Types.FileStat,
	23	+): Promise<Types.FileHunks \| null> {
	24	+ const hasNoBody =
	25	+ file.isUntracked \|\| file.isBinary \|\| data.stalePaths.includes(file.path)
	26	+
	27	+ if (hasNoBody) {
	28	+ return EMPTY_FILE_HUNKS
	29	+ }
	30	+
	31	+ const { exitCode, stdout } = await run([
	32	+ '--literal-pathspecs',
	33	+ ...Argv.DIFF_LEADING_ARGS,
	34	+ data.baseRef,
	35	+ '--',
	36	+ ...(file.renamedFrom === null ? [] : [file.renamedFrom]),
	37	+ file.path,
	38	+ ])
	39	+
	40	+ return exitCode === 0 ? Parse.parseFileDiff(stdout) : null
	41	+}

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

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

		@@ -2,8 +2,8 @@
2	2	import Limits from '../limits'
3	3	import Argv from './argv'
4	4	import { FAILED_RUN } from './failed-run'
5		-import { fetchDiff } from './fetch-diff.js'
6		-import { fetchFileHunks } from './fetch-file-hunks.js'
	5	+import { fetchDiff } from './fetch-diff'
	6	+import { fetchFileHunks } from './fetch-file-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'
		@@ -11,10 +11,11 @@
11	11
12	12	/**
13	13	* The git backend over the session's directory: the repository read with
14		- * one `rev-parse` in that directory, then every child pinned to it
15		- * (`--git-dir`, `--work-tree`, cwd the top) under the C locale and the
16		- * fetch's timeout (gitDiff.ts execPinnedGit).
	14	+ * one `rev-parse` in that directory, then every child pinned to it.
17	15	*
	16	+ * Each child runs with `--git-dir`, `--work-tree` and cwd the top, under
	17	+ * the C locale and the fetch's timeout (the built-in's execPinnedGit).
	18	+ *
18	19	* @param host the bound host's runner and probes
19	20	* @returns the backend, or null outside a git working tree
20	21	*/
		@@ -45,6 +46,7 @@
45	46	}
46	47
47	48	const run = runOf(repository)
	49	+
48	50	const depsOf = (): Types.GitDeps => ({
49	51	run,
50	52	repository,

		@@ -1,8 +1,10 @@
1	1	import type Backend from '../../backend'
2	2
3	3	/**
4		- * The pane's git words: compared with HEAD, read by `git diff`, untracked
5		- * files listed by git and staged with `git add ':/…'` (DiffDetailView's).
	4	+ * The pane's git words, unquoted as DiffDetailView words them.
	5	+ *
	6	+ * Compared with HEAD, read by `git diff`, untracked files listed by git and
	7	+ * staged with `git add :/…`.
6	8	*/
7	9	export const GIT_WORDS: Backend.BackendWords = Object.freeze({
8	10	base: 'HEAD',
		@@ -11,7 +13,7 @@
11	13	untrackedNoteOf: (path: string, isPasteable: boolean) => [
12	14	'New file not yet staged.',
13	15	isPasteable
14		- ? `Run \`git add ':/${path}'\` to see line counts.`
	16	+ ? `Run \`git add :/${path}\` to see line counts.`
15	17	: 'Stage it with git add to see line counts.',
16	18	],
17	19	})

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

		@@ -3,12 +3,11 @@
3	3	import { MOST_UTF8_BYTES } from './most-utf8-bytes'
4	4
5	5	/**
6		- * Whether a listing arrived whole: every record terminated (NUL for git's
7		- * `-z` listings, a newline for line records) and the text short of the
8		- * host's output cap, so no record was cut or lost.
	6	+ * Whether a listing arrived whole, so no record was cut or lost.
9	7	*
10		- * A cut inside a multi-byte character costs the decoded text up to
11		- * MOST_UTF8_BYTES, hence the margin under the cap.
	8	+ * Every record is terminated (NUL for `-z` listings, a newline for line
	9	+ * records) and the text is short of the host's output cap by MOST_UTF8_BYTES,
	10	+ * what a cut inside a multi-byte character can cost the decoded text.
12	11	*
13	12	* @param stdout the listing as `$.process.run` returned it
14	13	* @param terminator what ends every record; NUL when absent

		@@ -22,6 +22,7 @@
22	22	}
23	23
24	24	const rows = stdout.split('\n')
	25	+
25	26	const headerRows = rows.flatMap((row, at) =>
26	27	HUNK_HEADER.test(row) ? [at] : [],
27	28	)

		@@ -26,11 +26,13 @@
26	26	const [addedField, removedField, ...pathFields] = (records[at] ?? '').split(
27	27	'\t',
28	28	)
	29	+
29	30	const inline = pathFields.join('\t')
30	31	const isRename = pathFields.length === 1 && inline === ''
31	32	const renamedFrom = isRename ? (records[at + 1] ?? null) : null
32	33	const path = isRename ? (records[at + 2] ?? '') : inline
33	34	at += isRename ? RENAME_RECORDS : 1
	35	+
34	36	const isRow =
35	37	addedField !== undefined && removedField !== undefined && path !== ''
36	38
		@@ -41,6 +43,7 @@
41	43	const isBinary = addedField === '-' \|\| removedField === '-'
42	44	const added = isBinary ? 0 : Number(addedField) \|\| 0
43	45	const removed = isBinary ? 0 : Number(removedField) \|\| 0
	46	+
44	47	stats.filesCount += 1
45	48	stats.linesAdded += added
46	49	stats.linesRemoved += removed

		@@ -23,6 +23,7 @@
23	23	currentBranchOf(run),
24	24	defaultBranchOf(run),
25	25	])
	26	+
26	27	const isUnrelated = branch === 'HEAD' \|\| defaultBranch.startsWith('-')
27	28
28	29	if (isUnrelated) {
		@@ -37,6 +38,7 @@
37	38	run,
38	39	defaultBranch,
39	40	)
	41	+
40	42	const [first, second] = candidates
41	43
42	44	if (first === undefined) {
		@@ -57,6 +59,7 @@
57	59	second,
58	60	])
59	61	).exitCode === 0
	62	+
60	63	const mergeBase = isLocalBaseNewer ? second : first
61	64	const head = await run([Argv.NO_OPTIONAL_LOCKS, 'rev-parse', 'HEAD'])
62	65

		@@ -14,6 +14,7 @@
14	14	'--abbrev-ref',
15	15	'HEAD',
16	16	])
	17	+
17	18	const name = stdout.trim()
18	19
19	20	return exitCode === 0 && name !== '' ? name : 'HEAD'

		@@ -9,18 +9,19 @@
9	9	* path is never listed, descended or stat'ed: session work (the engine
10	10	* lstats); a path the listing budget never reached is the caller's to place.
11	11	*
12		- * @param probe the fetch's stamp probe over the working tree's top
13		- * @param sessionStartMs when the session began
	12	+ * @param context the fetch's stamp probe over the working tree's top, and
	13	+ * when the session began
14	14	* @param paths repository-relative paths, `/`-separated as git prints them
15	15	* @returns each path's Dating
16	16	*/
17	17	export async function datingsOf(
18		- probe: Types.StampProbe,
19		- sessionStartMs: number,
	18	+ context: Types.DatingContext,
20	19	paths: readonly string[],
21	20	): Promise<ReadonlyMap<string, Types.Dating>> {
	21	+ const { sessionStartMs } = context.deps
	22	+
22	23	const stamps: readonly Types.Stamp[] = await Promise.all(
23		- paths.map(path => stampIfFile(probe, path)),
	24	+ paths.map(path => stampIfFile(context.stamps, path)),
24	25	)
25	26
26	27	function datingOf(stamp: Types.Stamp): Types.Dating {

		@@ -22,12 +22,14 @@
22	22	`refs/remotes/origin/${branch}`,
23	23	])
24	24	).exitCode === 0
	25	+
25	26	const symref = await run([
26	27	Argv.NO_OPTIONAL_LOCKS,
27	28	'symbolic-ref',
28	29	'--short',
29	30	'refs/remotes/origin/HEAD',
30	31	])
	32	+
31	33	const named =
32	34	symref.exitCode === 0 ? symref.stdout.trim().replace(/^origin\//, '') : ''
33	35

		@@ -26,7 +26,9 @@
26	26	repository.gitDir,
27	27	Limits.MAX_LISTED_DIRECTORIES,
28	28	)
	29	+
29	30	const isShared = repository.commonDir === repository.gitDir
	31	+
30	32	const common = isShared
31	33	? own
32	34	: stampProbeOf(deps, repository.commonDir, Limits.MAX_LISTED_DIRECTORIES)

		@@ -22,7 +22,7 @@
22	22	export * from './transient-state-files'
23	23	export * from './unstaged-numstat.js'
24	24	export * from './untracked-files'
25		-export * from './untracked-rows-of'
26	25	export * from './untracked-place'
	26	+export * from './untracked-rows-of'
27	27
28	28	export * as default from '.'

		@@ -33,6 +33,7 @@
33	33
34	34	const listed =
35	35	held ?? entryKindsOf(directory === '' ? root : `${root}/${directory}`)
	36	+
36	37	listings.set(directory, listed)
37	38
38	39	return listed

		@@ -27,6 +27,7 @@
27	27	'--quiet',
28	28	ref,
29	29	])
	30	+
30	31	const isPresentOrUnknown = exitCode === 0 \|\| exitCode === -1
31	32
32	33	if (isPresentOrUnknown) {