Files
orca/src/main/git/runner-wsl-linked-gitdir-timeout.test.ts
T
Brennan BensonandMerge Sim b5a85890ac perf(git): bound git subprocess execution with an atomic admission scheduler (#16874)
* perf(git): bound git subprocess execution with an atomic admission scheduler

Field traces (#16038, #11363) show Windows freeze storms driven by unbounded
concurrent git children (12+ at once, 50-65s status convoys for 25+ minutes).
Admit every main-process git child against atomic per-budget base+headroom
counters (general / network / per-route), with reserved interactive capacity,
ordering-only aging, close-bound permit release, a 120s fail-safe read timeout
that feeds scheduler backoff, tier plumbing through every option carrier, and
coalesced+jittered visibility pollers. Killswitch: ORCA_GIT_ADMISSION_DISABLED=1.

Storm harness A/B: max concurrent children 65 -> 6, interactive p95 791ms -> 88ms;
output-parity battery byte-identical with admission on vs off.

* test(git): run the admission output-parity battery on every platform

Parity needs real git, not the storm harness's PATH stub, so it must not share
that file's POSIX gate - Windows is the platform where parity evidence matters.

* fix(git): preserve interactive admission invariants

* perf(git): keep admission queue drains linear

* fix(git): close final admission gaps

* perf(git): bound eligible route selection

* fix(merge): remove unrelated stale snapshot changes

* fix(git): preserve refresh lifecycle authority

* test(git): align admission lifetime contracts

* fix(git): harden admission across runtime paths

* fix(git): restore freshness for bulk status reads

* test(git): repoint delete-dialog source pins after admission plumbing

The hydration effect now orders its targets through
orderDeleteWorktreeStatusHydrationTargets and passes includeLineStats
alongside the abort signal, so both literal anchors stopped matching.
The invariants are unchanged and still pinned: dropping the signal, the
main-worktree/folder filter, or getState-instead-of-subscribe each
still reddens this test.

* Fix git admission tier propagation and lock ordering

Decode optional Git status tiers permissively and default runtime RPC status reads to the status lane while preserving renderer caller intent.

Acquire the FETCH_HEAD mutex before atomic admission so same-repository fetch waiters hold no global or route permits.

Preserve automatic pull-request refresh reasons, keep explicit hosted-review refreshes interactive, remove the dead candidate tier, and keep relay scheduling unchanged.

Use tier-aware status lease keys because a shared lease cannot be safely promoted after its admission request is queued or granted.

* test: align expectations with admission plumbing

* refactor(child-process): move the process contract types to process-spec

run-process.ts crossed its line cap after gaining the termination observer;
the public types and defaults move out with re-exports so no caller changes.

* chore: restore pnpm-lock.yaml to main (unintended local drift)

---------

Co-authored-by: Merge Sim <sim@local>
2026-08-30 14:19:05 -07:00

107 lines
3.4 KiB
TypeScript

import { EventEmitter } from 'node:events'
import type * as FsPromises from 'node:fs/promises'
import { afterEach, describe, expect, it, vi } from 'vitest'
const { execFileMock, statMock, readFileMock } = vi.hoisted(() => ({
execFileMock: vi.fn(),
statMock: vi.fn(),
readFileMock: vi.fn()
}))
vi.mock('node:child_process', () => ({
execFile: execFileMock,
execFileSync: vi.fn(),
spawn: vi.fn()
}))
vi.mock('node:fs/promises', async (importOriginal) => ({
...(await importOriginal<typeof FsPromises>()),
stat: statMock,
readFile: readFileMock
}))
import { gitExecFileAsync } from './runner'
import { _resetGitAdmissionForTests } from './command-runner/git-subprocess-admission'
afterEach(() => _resetGitAdmissionForTests())
import {
resetWslLinkedWorktreeGitRoutingForTests,
WSL_LINKED_WORKTREE_ROUTE_PROBE_TIMEOUT_MS
} from './wsl-linked-worktree-git-routing'
function createMockChild(): EventEmitter & { pid: number; kill: ReturnType<typeof vi.fn> } {
const child = new EventEmitter() as EventEmitter & {
pid: number
kill: ReturnType<typeof vi.fn>
}
child.pid = 1234
child.kill = vi.fn()
return child
}
async function withWindowsPlatform(run: () => Promise<void>): Promise<void> {
const original = process.platform
Object.defineProperty(process, 'platform', { configurable: true, value: 'win32' })
try {
await run()
} finally {
Object.defineProperty(process, 'platform', { configurable: true, value: original })
}
}
afterEach(() => {
vi.useRealTimers()
vi.restoreAllMocks()
resetWslLinkedWorktreeGitRoutingForTests()
})
describe('WSL linked-worktree routing probe timeout', () => {
it('retries discovery on the next production Git call', async () => {
vi.useFakeTimers()
await withWindowsPlatform(async () => {
statMock
.mockImplementationOnce(() => new Promise(() => {}))
.mockResolvedValue({ isDirectory: () => false, isFile: () => true })
readFileMock.mockResolvedValue('gitdir: C:/main/.git/worktrees/linked\n')
execFileMock.mockImplementation((command, _args, _options, callback) => {
const child = createMockChild()
queueMicrotask(() => {
if (command === 'wsl.exe') {
callback?.(
Object.assign(new Error('not a git repository'), { code: 128 }),
'',
'fatal: not a git repository'
)
} else {
callback?.(null, 'host git recovered\n', '')
}
})
return child
})
const first = gitExecFileAsync(['status', '--short'], {
cwd: String.raw`C:\repo`,
wslDistro: 'Ubuntu'
})
const firstFailure = expect(first).rejects.toThrow('not a git repository')
await vi.advanceTimersByTimeAsync(WSL_LINKED_WORKTREE_ROUTE_PROBE_TIMEOUT_MS)
await firstFailure
await expect(
gitExecFileAsync(['status', '--short'], {
cwd: String.raw`C:\repo`,
wslDistro: 'Ubuntu'
})
).resolves.toEqual({ stdout: 'host git recovered\n', stderr: '' })
expect(statMock).toHaveBeenCalledTimes(2)
// A WSL read also warms the direct-git environment probe in the background;
// it is not part of the routing sequence under test.
const routedCommands = execFileMock.mock.calls
.filter(([, args]) => !String((args as string[])?.at(-1)).includes('^GIT_'))
.map(([command]) => command)
expect(routedCommands).toEqual(['wsl.exe', 'git'])
})
})
})