/** Git command bounds, snapshot recovery, and diff failure reporting. */ import { mkdir, writeFile } from 'node:fs/promises' import { join } from 'node:path' import { afterEach, describe, expect, it } from 'vitest' import { Context } from '@deepseek-ai/cordis' import LocalSubprocessRuntime from '@deepseek-ai/dsh-subprocess-local' import { GitRunner, diffTrees, ignoredPaths, locateGitWorkspace, snapshotTree } from '../src/git.ts' import { TurnRecorder } from '../src/recorder.ts' import { temporaryRoots } from '../src/paths.ts' import SessionStore, { SessionId } from '@deepseek-ai/dsh-session' import { git, scratchDir } from './support.ts' const cleanups: Array<() => Promise> = [] afterEach(async () => { for (const cleanup of cleanups.reverse()) await cleanup() cleanups.length = 0 }) async function runner(limits = { timeoutMs: 30_000, outputMaxBytes: 1024 * 1024 }, executable = 'git') { const ctx = new Context() cleanups.push(() => ctx.fiber.dispose()) await ctx.plugin(SessionStore) await ctx.plugin(LocalSubprocessRuntime) return { ctx, git: new GitRunner(ctx.subprocess, await ctx.subprocess.resolveExecutable(executable).catch(() => executable), limits) } } const signal = new AbortController().signal describe('GitRunner', () => { it('reports timeouts and external aborts as failures', async () => { const cwd = await scratchDir('dsh-git-runner-', cleanups) const { git: slow } = await runner({ timeoutMs: 1, outputMaxBytes: 1024 }) await expect(slow.run(['--version'], { cwd, signal })).rejects.toThrow('timed out after 1ms') const { git: quick } = await runner() const aborted = new AbortController() setTimeout(() => { aborted.abort() }, 0) await expect(quick.run(['--version'], { cwd, signal: aborted.signal })).rejects.toThrow('git --version was aborted') const ok = await quick.run(['--version'], { cwd, signal }) expect(ok.exitCode).toBe(0) expect(ok.stdout).toContain('git version') }) }) describe('snapshots and diffs', () => { it('snapshots a repository whose index holds unmerged entries without touching that index', async () => { const cwd = await scratchDir('dsh-git-conflict-', cleanups) git(cwd, 'init', '-q', '-b', 'main') await writeFile(join(cwd, 'f.txt'), 'base\n') git(cwd, 'add', '-A'); git(cwd, 'commit', '-q', '-m', 'base') git(cwd, 'checkout', '-q', '-b', 'side') await writeFile(join(cwd, 'f.txt'), 'side\n') git(cwd, 'commit', '-q', '-am', 'side') git(cwd, 'checkout', '-q', 'main') await writeFile(join(cwd, 'f.txt'), 'main\n') git(cwd, 'commit', '-q', '-am', 'main') expect(() => git(cwd, 'merge', 'side')).toThrow() expect(git(cwd, 'status', '--porcelain')).toContain('UU f.txt') const { git: runnerGit } = await runner() const workspace = await locateGitWorkspace(runnerGit, cwd, { home: join(cwd, 'unused'), excludes: [] }, signal) expect(workspace.kind).toBe('repository') const tree = await snapshotTree(runnerGit, workspace, signal) expect(tree).toMatch(/^[0-9a-f]{40,64}$/) expect(git(cwd, 'status', '--porcelain')).toContain('UU f.txt') }) it('fails loudly when the addressed repository cannot be written or diffed', async () => { const cwd = await scratchDir('dsh-git-broken-', cleanups) const { git: runnerGit } = await runner() const broken = { kind: 'shadow' as const, root: cwd, gitDir: join(cwd, 'missing'), env: { GIT_DIR: join(cwd, 'missing'), GIT_WORK_TREE: cwd } } await expect(snapshotTree(runnerGit, broken, signal)).rejects.toThrow('git add in') await expect(ignoredPaths(runnerGit, broken, ['x'], signal)).rejects.toThrow('git check-ignore failed') expect(await ignoredPaths(runnerGit, broken, [], signal)).toEqual(new Set()) git(cwd, 'init', '-q') const workspace = await locateGitWorkspace(runnerGit, cwd, { home: join(cwd, 'unused'), excludes: [] }, signal) await expect(diffTrees(runnerGit, workspace, 'a'.repeat(40), 'b'.repeat(40), signal)).rejects.toThrow('git diff-tree failed') await writeFile(join(cwd, 'many.txt'), Array.from({ length: 50 }, (_, index) => `line ${index}`).join('\n')) const before = await snapshotTree(runnerGit, workspace, signal) await writeFile(join(cwd, 'many.txt'), 'gone') for (let index = 0; index < 20; index += 1) await writeFile(join(cwd, `file-${index}.txt`), 'x\n') const after = await snapshotTree(runnerGit, workspace, signal) const { git: tiny } = await runner({ timeoutMs: 30_000, outputMaxBytes: 16 }) await expect(diffTrees(tiny, workspace, before, after, signal)).rejects.toThrow('exceeded') expect((await diffTrees(runnerGit, workspace, before, after, signal)).length).toBe(21) }) it('refuses a shadow home whose git directory cannot be initialized', async () => { const cwd = await scratchDir('dsh-git-shadow-broken-', cleanups) const home = join(cwd, 'home') const { git: runnerGit } = await runner() const probe = await locateGitWorkspace(runnerGit, cwd, { home, excludes: ['x/'] }, signal) expect(probe.kind).toBe('shadow') await mkdir(join(probe.gitDir, 'objects', 'broken'), { recursive: true }) await writeFile(join(probe.gitDir, 'HEAD'), 'not a ref') await writeFile(join(probe.gitDir, 'config'), '[core]\n\tbare = maybe\n') await expect(locateGitWorkspace(runnerGit, cwd, { home, excludes: [] }, signal)).rejects.toThrow('git init of shadow repository') }) }) describe('TurnRecorder', () => { it('stays silent when disposed while git work is pending, and warns on failures otherwise', async () => { const cwd = await scratchDir('dsh-recorder-', cleanups) const { ctx, git: runnerGit } = await runner() const session = ctx.sessions.create(SessionId('recorder'), { meta: { cwd } }) const warnings: string[] = [] let release!: (runner: GitRunner | null) => void const gate = new Promise((resolve) => { release = resolve }) const env = { git: gate, shadow: { home: join(cwd, 'home'), excludes: [] }, home: '', temporaryRoots: temporaryRoots(), maxFiles: 10, warn: (m: string) => { warnings.push(m) } } const disposed = new TurnRecorder(session, cwd, env) disposed.start(1) await new Promise(resolve => setTimeout(resolve, 5)) disposed.dispose() release(runnerGit) await disposed.settled() disposed.start(2) await disposed.settled() expect(warnings).toEqual([]) const { git: missing } = await runner(undefined, '/nonexistent/git-binary') const failing = new TurnRecorder(session, cwd, { ...env, git: Promise.resolve(missing) }) failing.start(1) await failing.settled() expect(warnings).toHaveLength(1) expect(warnings[0]).toContain('workspace-changes:') }) })