feat(codex): detect git bash on windows

Plan: plans/codex-windows-git-bash-profile.md
2026-05-31 06:03:36 +09:00
parent c4db598834
commit 5b9ca5fa26
2 changed files with 222 additions and 0 deletions
@@ -0,0 +1,118 @@
+/// <reference path="../../../bun-test.d.ts" />
+/// <reference types="bun-types" />
+
+import { describe, expect, test } from "bun:test"
+import { resolveGitBash } from "./git-bash"
+
+const PROGRAM_FILES_GIT_BASH = "C:\\Program Files\\Git\\bin\\bash.exe"
+const PROGRAM_FILES_X86_GIT_BASH = "C:\\Program Files (x86)\\Git\\bin\\bash.exe"
+
+describe("git-bash", () => {
+  test("#given non-Windows platform #when resolving Git Bash #then no preflight is required", () => {
+    // given / when
+    const result = resolveGitBash({
+      platform: "darwin",
+      env: {},
+      exists: () => false,
+      where: () => [],
+    })
+
+    // then
+    expect(result).toEqual({ found: true, path: null, source: "not-required" })
+  })
+
+  test("#given Windows env override to bash.exe #when the file exists #then env path wins", () => {
+    // given
+    const overridePath = "D:\\Tools\\Git\\bin\\bash.exe"
+
+    // when
+    const result = resolveGitBash({
+      platform: "win32",
+      env: { OMO_CODEX_GIT_BASH_PATH: overridePath },
+      exists: (path: string) => path === overridePath,
+      where: () => [PROGRAM_FILES_GIT_BASH],
+    })
+
+    // then
+    expect(result).toEqual({ found: true, path: overridePath, source: "env" })
+  })
+
+  test("#given Windows env override not pointing to bash.exe #when resolving #then reports invalid override and stops", () => {
+    // given
+    const overridePath = "D:\\Tools\\Git\\bin\\git.exe"
+
+    // when
+    const result = resolveGitBash({
+      platform: "win32",
+      env: { OMO_CODEX_GIT_BASH_PATH: overridePath },
+      exists: () => true,
+      where: () => [PROGRAM_FILES_GIT_BASH],
+    })
+
+    // then
+    expect(result.found).toBe(false)
+    if (result.found) return
+    expect(result.checkedPaths).toContain(overridePath)
+    expect(result.installHint).toContain("OMO_CODEX_GIT_BASH_PATH=C:\\path\\to\\bash.exe")
+  })
+
+  test("#given Windows standard 64-bit Git Bash exists #when resolving #then uses Program Files path", () => {
+    // given / when
+    const result = resolveGitBash({
+      platform: "win32",
+      env: {},
+      exists: (path: string) => path === PROGRAM_FILES_GIT_BASH,
+      where: () => [],
+    })
+
+    // then
+    expect(result).toEqual({ found: true, path: PROGRAM_FILES_GIT_BASH, source: "program-files" })
+  })
+
+  test("#given Windows standard 32-bit Git Bash exists #when resolving #then uses Program Files x86 path", () => {
+    // given / when
+    const result = resolveGitBash({
+      platform: "win32",
+      env: {},
+      exists: (path: string) => path === PROGRAM_FILES_X86_GIT_BASH,
+      where: () => [],
+    })
+
+    // then
+    expect(result).toEqual({ found: true, path: PROGRAM_FILES_X86_GIT_BASH, source: "program-files-x86" })
+  })
+
+  test("#given Windows bash on PATH #when standard paths are missing #then uses where bash candidate", () => {
+    // given
+    const pathCandidate = "E:\\Git\\bin\\bash.exe"
+
+    // when
+    const result = resolveGitBash({
+      platform: "win32",
+      env: {},
+      exists: (path: string) => path === pathCandidate,
+      where: () => ["C:\\Windows\\System32\\bash.exe", pathCandidate],
+    })
+
+    // then
+    expect(result).toEqual({ found: true, path: pathCandidate, source: "path" })
+  })
+
+  test("#given Windows without Git Bash #when resolving #then returns install guidance", () => {
+    // given / when
+    const result = resolveGitBash({
+      platform: "win32",
+      env: {},
+      exists: () => false,
+      where: () => [],
+    })
+
+    // then
+    expect(result.found).toBe(false)
+    if (result.found) return
+    expect(result.checkedPaths).toEqual([PROGRAM_FILES_GIT_BASH, PROGRAM_FILES_X86_GIT_BASH])
+    expect(result.installHint).toContain("winget install --id Git.Git -e --source winget")
+    expect(result.installHint).toContain("OMO_CODEX_GIT_BASH_PATH=C:\\path\\to\\bash.exe")
+    expect(result.installHint).toContain("rerun `bunx omo install --platform=codex`")
+  })
+})