Files
orca/src/main/git/remove-worktree-test-harness.ts
T
Neil 9367169888 refactor(tests): split every oversized test file off the max-lines suppression list (#14728)
* refactor(tests): split oversized test files off the max-lines suppression list

Every `*.test.ts`/`*.spec.ts` that carried an `eslint/oxlint-disable max-lines`
directive is now split into focused, behavior-scoped suites that fit the 800-line
test budget, with shared setup extracted into co-located `*-test-harness.ts` /
`*-test-fixtures.ts` modules (300-line budget). 83 files became ~930; the largest
output is 797 effective lines. `orca-runtime.test.ts` is intentionally untouched.

Test bodies were moved by scripted line-range slicing rather than retyped, so
assertions are byte-identical. The only permitted body edits were mechanical
rebinding where a shared value moved into a harness (e.g. `tmpHome` ->
`homes.tmpHome`).

Registries that enumerate test files were updated in lockstep:
- config/max-lines-baseline.txt: pruned 341 -> 258 entries (all 83 removed).
- config/reliability-gates.jsonc: 33 gates repointed at the split files, with
  assertionRefs split per file where a gate's coverage now spans several.
- .github/workflows/pr.yml: the real-zsh lane now lists the 4 split files that
  actually exercise zsh, so they keep running in the dedicated shell lane.

Also renamed agent-hooks `server-test-fixtures.ts` to `server.test-fixtures.ts`
so the global-fetch call-site audit keeps skipping it, and added `.js` extensions
to the CLI suites' dynamic harness imports (node16 resolution) to unbreak
`build:cli`.

Verification: full suite 52,449 passing vs 52,448 at baseline with zero
assertions lost; `pnpm lint`, `pnpm typecheck`, and `pnpm build:cli` all exit 0;
the terminal-pane e2e spec runs 31/31 headless.

* refactor(tests): split hook-idle arbitration suite that oxfmt pushed over budget

The pre-commit oxfmt pass reflowed pty-connection-hook-idle-arbitration.test.ts
to 811 effective lines, 11 over the test budget. Split the hook-completion side
effect and replacement-agent veto cases into their own suite; both files now sit
well under the cap and the 15 tests are unchanged.

* test: port upstream test changes into the split files after rebase

Rebasing onto main surfaced 27 tests that main had added to files this branch
deleted, plus edits to tests that had already moved. Taking the deletion side of
those modify/delete conflicts would have dropped that coverage silently, so each
upstream change is ported into the split file that now owns the behavior — for
example main's six orchestration mailbox tests land across orchestration-runs,
-send, and -check.

Also repoints `orchestration.notification-mailbox-consistency`, a gate main added
after this branch's gate remap, at those same three split files, and re-prunes
the max-lines baseline against main's (257 entries).

Verified: all 27 upstream test titles present; full suite 52,761 passing with the
only diff vs baseline being 12 tests main itself removed and 3 that moved from
skipped to passing; lint and typecheck exit 0.

* fix(test): flush pending continuations before tearing down terminal test globals

CI shard 5/16 failed on both Node 24 and 26 with `ReferenceError: window is not
defined` from pty-connection.ts, surfacing through
pty-connection-daemon-snapshot-replay.test.ts.

The reattach/settle chains `await` a real promise and then touch `window.api`.
Under fake timers those continuations cannot run, so they only become schedulable
once restoreTerminalTestGlobals() switches back to real timers — which previously
happened immediately before `delete globalThis.window`, so a late continuation
threw and failed the whole file. Flush async ticks in that window instead.

This is latent in the source rather than new: the pre-split 25k-line file kept
running other tests after these, which gave the chains time to settle before
teardown. Splitting the file moved teardown directly behind them.

* fix(test): keep an inert window after terminal test teardown instead of deleting it

The async-tick flush was not enough: the reattach/settle chain can resolve after
teardown regardless of how long we drain, so CI shard 5/16 still failed with
`ReferenceError: window is not defined` from pty-connection.ts.

A real renderer never loses `window`, so deleting it was the artificial part.
Swap in an inert proxy whose properties resolve to callables and whose calls
resolve to undefined, making a late `window.api.pty.*` call a harmless no-op.
The next test replaces it wholesale via installTerminalTestGlobals(), and no test
asserts that `window` is absent.
2026-08-15 00:54:20 -07:00

126 lines
4.6 KiB
TypeScript

import { expect, type Mock } from 'vitest'
import { clearGitCapabilityStateForTests } from './git-capability-state'
import { _resetWorktreeScanCacheForTests } from './worktree'
export type MockResult = {
error?: Error
stdout?: string
stderr?: string
}
// Why: detectSparseCheckout on main also requires core.sparseCheckout=true in git
// config (not just a non-empty pattern file). Unit tests that assert isSparse must
// present an enabled flag; other paths never reach this read after the pattern-file
// fast-path ENOENT.
const ENABLED_SPARSE_CHECKOUT_CONFIG = '[core]\nsparseCheckout = true\n'
function enoent(): Error {
return Object.assign(new Error('ENOENT'), { code: 'ENOENT' })
}
/** Routes git calls to canned results keyed by `git <args>`, with `#n` selecting the nth call. */
export function createGitCommandMocker(
gitExecFileAsyncMock: Mock
): (results: Record<string, MockResult>) => void {
return (results) => {
const callCounts = new Map<string, number>()
gitExecFileAsyncMock.mockImplementation((args: string[]) => {
const key = `git ${args.join(' ')}`
const callCount = (callCounts.get(key) ?? 0) + 1
callCounts.set(key, callCount)
const lineListKey =
key === 'git worktree list --porcelain -z' ? 'git worktree list --porcelain' : ''
const result =
results[`${key}#${callCount}`] ??
results[key] ??
(lineListKey
? (results[`${lineListKey}#${callCount}`] ?? results[lineListKey])
: undefined) ??
{}
if (result.error) {
throw Object.assign(result.error, {
stdout: result.stdout ?? '',
stderr: result.stderr ?? ''
})
}
return {
stdout: result.stdout ?? '',
stderr: result.stderr ?? ''
}
})
}
}
export function createGitCallReader(gitExecFileAsyncMock: Mock): () => string[] {
return () =>
(gitExecFileAsyncMock.mock.calls as [string[]][]).map((call) => `git ${call[0].join(' ')}`)
}
export function expectGitCallOrder(calls: string[], beforeCall: string, afterCall: string): void {
expect(calls.indexOf(beforeCall)).toBeGreaterThanOrEqual(0)
expect(calls.indexOf(afterCall)).toBeGreaterThan(calls.indexOf(beforeCall))
}
export function mockSparseCheckoutEnabledConfig(readFileMock: Mock): void {
readFileMock.mockImplementation(async (filePath: string) => {
const normalized = String(filePath).replaceAll('\\', '/')
// Why: linked worktrees may point at a common dir; treat missing commondir as
// "this gitdir is the common dir" so the shared config read still runs.
if (normalized.endsWith('/commondir')) {
throw enoent()
}
if (normalized.endsWith('/config') || normalized.endsWith('/config.worktree')) {
return ENABLED_SPARSE_CHECKOUT_CONFIG
}
throw enoent()
})
}
export type WorktreeTrashMocks = {
moveWorktreeDirectoryToTrashMock: Mock
restoreWorktreeDirectoryFromTrashMock: Mock
scheduleWorktreeTrashDeletionMock: Mock
}
/** Per-test reset shared by every worktree suite: caches cleared, trash rename unavailable. */
export function resetWorktreeRemovalState(trashMocks: WorktreeTrashMocks): void {
clearGitCapabilityStateForTests()
_resetWorktreeScanCacheForTests()
// Default: the checkout cannot be renamed aside, so removal deletes it in place.
trashMocks.moveWorktreeDirectoryToTrashMock.mockReset()
trashMocks.moveWorktreeDirectoryToTrashMock.mockResolvedValue(undefined)
trashMocks.restoreWorktreeDirectoryFromTrashMock.mockReset()
trashMocks.restoreWorktreeDirectoryFromTrashMock.mockResolvedValue(true)
trashMocks.scheduleWorktreeTrashDeletionMock.mockReset()
}
export type WorktreeGitMocks = {
gitExecFileAsyncMock: Mock
gitExecFileSyncMock: Mock
translateWslOutputPathsMock: Mock
statMock: Mock
resolveGitDirMock: Mock
/** Omit to leave the sparse-config reader untouched (suites that never read it). */
readFileMock?: Mock
}
export function resetWorktreeGitMocks(mocks: WorktreeGitMocks): void {
mocks.gitExecFileAsyncMock.mockReset()
mocks.gitExecFileSyncMock.mockReset()
mocks.translateWslOutputPathsMock.mockReset()
mocks.translateWslOutputPathsMock.mockImplementation((output: string) => output)
mocks.statMock.mockReset()
// Default: no worktree has a sparse-checkout config file. Tests that need
// sparse detection override this.
mocks.statMock.mockRejectedValue(enoent())
if (mocks.readFileMock) {
mocks.readFileMock.mockReset()
mockSparseCheckoutEnabledConfig(mocks.readFileMock)
}
mocks.resolveGitDirMock.mockReset()
mocks.resolveGitDirMock.mockImplementation(async (worktreePath: string) => `${worktreePath}/.git`)
}