Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScript adeagent-ideai-agentsautomationbotclaude-codecodexghosttygrok-bothermes-agentmobile-appmuseopenclawopencodeorchestrationpiruntimeterminalworktreesyc-backed
import { posix, win32 } from 'node:path'
import { describe, expect, it } from 'vitest'
import { resolveGitMetadataPath, resolveWorktreeHostPath } from './git-metadata-path'
const hostIsWindows = process.platform === 'win32'
describe('resolveGitMetadataPath', () => {
it('maps a drvfs pointer to its drive spelling on a Windows host with no distro context', () => {
expect(
resolveGitMetadataPath(
String.raw`C:\Users\me\repo`,
'/mnt/c/Users/me/repo/.git/worktrees/feature',
{ platform: 'win32' }
)
).toBe(String.raw`C:\Users\me\repo\.git\worktrees\feature`)
})
it('maps a drvfs drive root to its drive spelling', () => {
expect(resolveGitMetadataPath(String.raw`D:\repo`, '/mnt/d', { platform: 'win32' })).toBe(
'D:\\'
)
})
it('keeps a non-drvfs guest pointer verbatim when no distro names it', () => {
// Windows already reads this as drive-relative; guessing a distro would probe the wrong disk.
expect(
resolveGitMetadataPath(String.raw`C:\repo`, '/home/me/repo/.git', { platform: 'win32' })
).toBe('/home/me/repo/.git')
})
it('maps a guest pointer through the distro encoded by a WSL UNC base', () => {
expect(
resolveGitMetadataPath(
String.raw`\\wsl.localhost\Debian\home\me\repo`,
'/home/me/repo/.git',
{ platform: 'win32' }
)
).toBe(String.raw`\\wsl.localhost\Debian\home\me\repo\.git`)
})
it('maps a guest pointer through a caller-named distro when the base encodes none', () => {
expect(
resolveGitMetadataPath(String.raw`C:\Users\me\repo`, '/home/me/repo/.git', {
platform: 'win32',
wslDistro: 'Ubuntu'
})
).toBe(String.raw`\\wsl.localhost\Ubuntu\home\me\repo\.git`)
})
// Forward-slash UNC gitdirs are already host paths; translation would prepend the share twice.
it('keeps a forward-slash UNC pointer verbatim rather than re-prefixing the share', () => {
expect(
resolveGitMetadataPath(
String.raw`\\wsl.localhost\Ubuntu\home\me\repo\feature`,
'//wsl.localhost/Ubuntu/home/me/repo/.git/worktrees/feature',
{ platform: 'win32', wslDistro: 'Ubuntu' }
)
).toBe('//wsl.localhost/Ubuntu/home/me/repo/.git/worktrees/feature')
})
it('lets the distro encoded by a WSL UNC base outrank the caller-named one', () => {
expect(
resolveGitMetadataPath(
String.raw`\\wsl.localhost\Debian\home\me\repo`,
'/home/me/repo/.git',
{ platform: 'win32', wslDistro: 'Ubuntu' }
)
).toBe(String.raw`\\wsl.localhost\Debian\home\me\repo\.git`)
})
it('ignores a caller-named distro on a POSIX host', () => {
// A POSIX reader is already in the pointer's namespace; a UNC path there would be a filename.
expect(
resolveGitMetadataPath('/repo', '/home/me/repo/.git', {
platform: 'linux',
wslDistro: 'Ubuntu'
})
).toBe('/home/me/repo/.git')
expect(
resolveGitMetadataPath('/repo', '/mnt/c/repo/.git', {
platform: 'darwin',
wslDistro: 'Ubuntu'
})
).toBe('/mnt/c/repo/.git')
})
it('keeps a drvfs pointer on its drive spelling even when a distro is named', () => {
expect(
resolveGitMetadataPath(String.raw`C:\repo`, '/mnt/c/repo/.git', {
platform: 'win32',
wslDistro: 'Ubuntu'
})
).toBe(String.raw`C:\repo\.git`)
})
it('resolves a relative pointer against a WSL UNC base', () => {
expect(
resolveGitMetadataPath(
String.raw`\\wsl.localhost\Debian\home\me\repo\.git\worktrees\feature`,
'../..',
{ platform: 'win32' }
)
).toBe(String.raw`\\wsl.localhost\Debian\home\me\repo\.git`)
})
it('resolves relative pointers with the reading host path flavor', () => {
expect(
resolveGitMetadataPath('/repo/worktree', '../.git/worktrees/feature', { platform: 'linux' })
).toBe('/repo/.git/worktrees/feature')
expect(
resolveGitMetadataPath(String.raw`C:\repo\worktree`, String.raw`..\.git\worktrees\feature`, {
platform: 'win32'
})
).toBe(String.raw`C:\repo\.git\worktrees\feature`)
})
it('leaves absolute pointers alone on a POSIX host, drvfs spelling included', () => {
expect(
resolveGitMetadataPath('/repo/worktree', '/var/lib/git/worktrees/feature', {
platform: 'linux'
})
).toBe('/var/lib/git/worktrees/feature')
expect(
resolveGitMetadataPath('/repo/worktree', '/mnt/c/repo/.git', { platform: 'darwin' })
).toBe('/mnt/c/repo/.git')
})
it.each(['', ' ', '\t'])('rejects an empty metadata pointer %j', (rawPath) => {
expect(resolveGitMetadataPath('/repo', rawPath, { platform: 'linux' })).toBeNull()
})
it('trims a padded pointer before resolving it', () => {
expect(resolveGitMetadataPath('/repo/worktree', ' ../.git ', { platform: 'linux' })).toBe(
'/repo/.git'
)
})
// Production callers omit options: default to the reader’s path flavor without guessing a distro.
it.each([
[
String.raw`\\wsl.localhost\Debian\home\me\repo`,
'/home/me/repo/.git',
String.raw`\\wsl.localhost\Debian\home\me\repo\.git`
],
['/repo', '/mnt/c/repo/.git', hostIsWindows ? String.raw`C:\repo\.git` : '/mnt/c/repo/.git'],
['/repo', '/var/lib/git/worktrees/feature', '/var/lib/git/worktrees/feature'],
['/repo', ' ', null]
])('defaults to the current host with no distro for %j -> %j', (basePath, rawPath, expected) => {
expect(resolveGitMetadataPath(basePath, rawPath)).toBe(expected)
})
it('resolves a relative pointer with no options in the reading host flavor', () => {
// Expectation comes from node's own path module, not from a second call under test.
expect(resolveGitMetadataPath('/repo/worktree', '../.git/worktrees/feature')).toBe(
(hostIsWindows ? win32 : posix).resolve('/repo/worktree', '../.git/worktrees/feature')
)
})
})
describe('resolveWorktreeHostPath', () => {
// Gitfile payloads end with newlines; directory-name whitespace is real and must survive.
it.each(['/repo/my feature ', ' /repo/my feature'])(
'keeps whitespace that belongs to the directory name (%j)',
(worktreePath) => {
expect(resolveWorktreeHostPath(worktreePath, { platform: 'linux' })).toBe(worktreePath)
expect(resolveWorktreeHostPath(worktreePath, { platform: 'win32' })).toBe(worktreePath)
}
)
it('still translates a guest directory for a Windows reader', () => {
expect(
resolveWorktreeHostPath('/home/me/repo', { platform: 'win32', wslDistro: 'Ubuntu' })
).toBe(String.raw`\\wsl.localhost\Ubuntu\home\me\repo`)
expect(resolveWorktreeHostPath('/mnt/c/repo', { platform: 'win32' })).toBe(String.raw`C:\repo`)
})
it.each(['', ' '])('has no spelling for an empty worktree path %j', (worktreePath) => {
expect(resolveWorktreeHostPath(worktreePath, { platform: 'win32' })).toBeNull()
})
it('maps a drvfs worktree to its drive spelling on a Windows host', () => {
expect(resolveWorktreeHostPath('/mnt/c/Users/me/repo/feature', { platform: 'win32' })).toBe(
String.raw`C:\Users\me\repo\feature`
)
})
it('maps a guest worktree through a caller-named distro', () => {
expect(
resolveWorktreeHostPath('/home/me/repo/feature', { platform: 'win32', wslDistro: 'Ubuntu' })
).toBe(String.raw`\\wsl.localhost\Ubuntu\home\me\repo\feature`)
})
it('keeps a guest worktree verbatim on Windows when no distro names it', () => {
expect(resolveWorktreeHostPath('/home/me/repo/feature', { platform: 'win32' })).toBe(
'/home/me/repo/feature'
)
})
it('ignores a caller-named distro on a POSIX host', () => {
expect(
resolveWorktreeHostPath('/home/me/repo/feature', { platform: 'linux', wslDistro: 'Ubuntu' })
).toBe('/home/me/repo/feature')
expect(
resolveWorktreeHostPath('/mnt/c/repo/feature', { platform: 'darwin', wslDistro: 'Ubuntu' })
).toBe('/mnt/c/repo/feature')
})
// //x is host UNC syntax; do not prefix a second share. Relative paths are resolved by the wrapper.
it.each([
String.raw`C:\Users\me\repo\feature`,
String.raw`\\wsl.localhost\Ubuntu\home\me\repo\feature`,
'//wsl.localhost/Ubuntu/home/me/repo/feature'
])('leaves a non-guest worktree path untouched: %j', (worktreePath) => {
expect(resolveWorktreeHostPath(worktreePath, { platform: 'win32', wslDistro: 'Ubuntu' })).toBe(
worktreePath
)
})
})