cuelo 0.10.52 → 0.10.53

package/Tools/OMP_Global_Config/agent/tools/git-finalizer/sync-checkout.ts

@@ -1,184 +1,184 @@
-/**
- * 검증·게시가 끝난 커밋을 같은 프로젝트의 다른 체크아웃(예: WSL 작업본 → Windows 사본)에 fast-forward로 반영하는 CLI.
- *
- *   bun sync-checkout.ts --source <루트> --target <루트> --revision <40자 sha>
- *
- * 모델 도구가 아니다. 상시 동기화·스케줄러·훅 없이, 호출될 때 한 번만 일한다. 빌드·설치·배포는 하지 않는다.
- * 대상 사본의 변경(tracked·staged·무시되지 않는 untracked)이나 갈라진/앞선 이력이 있으면 아무것도 바꾸지 않고 멈춘다.
- * reset·stash·clean·force checkout·rebase·merge·잠금 삭제는 쓰지 않는다. 갱신은 `merge --ff-only <정확한 sha>` 하나다.
- */
-import { execFile } from "node:child_process";
-import { realpath } from "node:fs/promises";
-import { resolve, sep } from "node:path";
-import { fileURLToPath } from "node:url";
-import { type GitExecutor, selectGitExecutor } from "./wsl-git";
-
-export interface SyncCheckoutOptions {
-  source: string;
-  target: string;
-  revision: string;
-}
-
-export type SyncCheckoutResult =
-  | { ok: true; status: "updated" | "already-current"; revision: string; branch: string; previous: string }
-  | { ok: false; status: "blocked"; reason: string };
-
-interface GitOutput {
-  code: number;
-  stdout: string;
-  stderr: string;
-}
-
-class Blocked extends Error {}
-
-function blocked(reason: string): never {
-  throw new Blocked(reason);
-}
-
-/**
- * git에 넘길 비대화형 환경. Windows git.exe는 interop에서 WSLENV에 이름이 든 변수만 받으므로(2026-10-11 실측: 이름이 없으면
- * 빈 값) 두 변수를 WSLENV에 더한다. 기존 WSLENV 항목은 보존한다. 전역 환경은 바꾸지 않고 자식 프로세스에만 적용한다.
- */
-function gitEnv(): NodeJS.ProcessEnv {
-  const names = (process.env.WSLENV ?? "").split(":").filter((entry) => entry.length > 0);
-  for (const name of ["GIT_TERMINAL_PROMPT", "GCM_INTERACTIVE"]) {
-    if (!names.some((entry) => entry.split("/")[0] === name)) names.push(name);
-  }
-  return { ...process.env, GIT_TERMINAL_PROMPT: "0", GCM_INTERACTIVE: "never", WSLENV: names.join(":") };
-}
-
-function runGit(executor: GitExecutor, cwd: string, args: string[]): Promise<GitOutput> {
-  const { promise, resolve, reject } = Promise.withResolvers<GitOutput>();
-  execFile(
-    executor.command,
-    args,
-    { cwd, env: gitEnv(), maxBuffer: 16 * 1024 * 1024 },
-    (error, stdout, stderr) => {
-      if (error && typeof error.code !== "number") {
-        reject(error);
-        return;
-      }
-      resolve({ code: typeof error?.code === "number" ? error.code : 0, stdout: String(stdout), stderr: String(stderr) });
-    },
-  );
-  return promise;
-}
-
-/** 성공해야 하는 git 호출. 실패하면 stderr를 이유로 멈춘다. */
-async function git(executor: GitExecutor, cwd: string, args: string[], what: string): Promise<string> {
-  const out = await runGit(executor, cwd, args);
-  if (out.code !== 0) blocked(`${what} 실패(git ${args[0]}, 종료 ${out.code}): ${out.stderr.trim() || out.stdout.trim()}`);
-  return out.stdout.trim();
-}
-
-interface Checkout {
-  executor: GitExecutor;
-  root: string;
-  branch: string;
-  origin: string;
-  head: string;
-}
-
-async function inspect(label: string, path: string): Promise<Checkout> {
-  const root = await realpath(resolve(path)).catch(() => blocked(`${label} 경로가 없다: ${path}`));
-  const executor = await selectGitExecutor(root);
-  const top = executor.toPosix(await git(executor, root, ["rev-parse", "--show-toplevel"], `${label} 루트 확인`));
-  const topReal = await realpath(top).catch(() => blocked(`${label} git 루트를 해석하지 못했다: ${top}`));
-  if (topReal !== root) blocked(`${label} 경로가 체크아웃 루트가 아니다: ${root} (루트 ${topReal})`);
-  const branchOut = await runGit(executor, root, ["symbolic-ref", "--short", "-q", "HEAD"]);
-  if (branchOut.code !== 0 || !branchOut.stdout.trim()) blocked(`${label}이 detached HEAD 상태다`);
-  const origin = await git(executor, root, ["remote", "get-url", "origin"], `${label} origin 확인`);
-  const head = await git(executor, root, ["rev-parse", "HEAD"], `${label} HEAD 확인`);
-  return { executor, root, branch: branchOut.stdout.trim(), origin, head };
-}
-
-/**
- * 네트워크 원격(`file://`을 뺀 스킴 URL, `[user@]host:path` SSH 형식)은 끝의 `/`와 `.git`을 떼고 비교한다.
- * `https://github.com/o/r`와 `https://github.com/o/r.git`은 같은 저장소다.
- * 로컬 경로·`file://` origin은 `r`과 `r.git`이 서로 다른 디렉터리일 수 있어 그대로 비교한다.
- * SSH 형식의 host는 두 글자 이상이어서 `C:/…` 같은 드라이브 경로는 로컬로 남는다.
- */
-export function sameOrigin(a: string, b: string): boolean {
-  const remote = /^(?!file:)[a-z][a-z0-9+.-]*:\/\/|^(?:[^/\\@:]+@)?[^/\\@:]{2,}:(?!\/\/)/i;
-  const norm = (url: string) => (remote.test(url) ? url.replace(/\/+$/, "").replace(/\.git$/, "") : url);
-  return norm(a) === norm(b);
-}
-
-async function run({ source, target, revision }: SyncCheckoutOptions): Promise<SyncCheckoutResult> {
-  if (!/^[0-9a-f]{40}$/.test(revision)) blocked("revision은 소문자 40자 전체 sha여야 한다");
-  const src = await inspect("source", source);
-  const dst = await inspect("target", target);
-  if (src.root === dst.root || src.root.startsWith(dst.root + sep) || dst.root.startsWith(src.root + sep)) {
-    blocked(`source와 target이 같거나 겹친다: ${src.root} / ${dst.root}`);
-  }
-  if (!sameOrigin(src.origin, dst.origin)) blocked("source와 target의 origin이 다르다");
-  if (src.branch !== dst.branch) blocked(`브랜치가 다르다: source ${src.branch} / target ${dst.branch}`);
-  if (src.head !== revision) blocked(`요청한 revision이 source HEAD(${src.head})와 다르다`);
-
-  const { executor, root, branch } = dst;
-  const dirty = await git(executor, root, ["status", "--porcelain", "--untracked-files=normal"], "target 상태 확인");
-  if (dirty) blocked(`target에 반영되지 않은 변경이 있어 건드리지 않는다:\n${dirty}`);
-
-  // target의 기존 origin 설정 그대로, 비대화형으로 그 브랜치 하나만 가져와 게시 여부를 확인한다.
-  await git(executor, root, ["fetch", "--no-tags", "origin", `refs/heads/${branch}`], "origin fetch");
-  const tip = await git(executor, root, ["rev-parse", "FETCH_HEAD"], "FETCH_HEAD 확인");
-  const known = await runGit(executor, root, ["cat-file", "-e", `${revision}^{commit}`]);
-  if (known.code !== 0) blocked(`origin/${branch}에서 ${revision} 커밋을 찾지 못했다(게시되지 않음)`);
-  const published = await runGit(executor, root, ["merge-base", "--is-ancestor", revision, tip]);
-  if (published.code !== 0) blocked(`${revision}은 origin/${branch}에 게시되지 않았다`);
-
-  const previous = dst.head;
-  if (previous === revision) return { ok: true, status: "already-current", revision, branch, previous };
-
-  const ff = await runGit(executor, root, ["merge-base", "--is-ancestor", previous, revision]);
-  if (ff.code !== 0) blocked(`target HEAD(${previous})가 ${revision}의 조상이 아니다(앞섰거나 갈라짐). 건드리지 않는다`);
-
-  // fetch 동안 target이 바뀌지 않았는지 갱신 직전에 다시 본다. 바뀌었으면 되돌리지 않고 멈춘다.
-  const nowHead = await git(executor, root, ["rev-parse", "HEAD"], "갱신 직전 HEAD 확인");
-  const nowDirty = await git(executor, root, ["status", "--porcelain", "--untracked-files=normal"], "갱신 직전 상태 확인");
-  if (nowHead !== previous || nowDirty) blocked("fetch 중 target이 바뀌어 갱신하지 않았다");
-  // 무시된 로컬 파일이 새로 추적되는 경로와 겹쳐도 덮어쓰지 않는다(git merge 기본값은 덮어쓴다).
-  await git(executor, root, ["merge", "--ff-only", "--no-overwrite-ignore", revision], "fast-forward");
-  const after = await git(executor, root, ["rev-parse", "HEAD"], "갱신 후 HEAD 확인");
-  if (after !== revision) blocked(`갱신 후 target HEAD(${after})가 요청 revision과 다르다`);
-  const left = await git(executor, root, ["status", "--porcelain", "--untracked-files=normal"], "갱신 후 상태 확인");
-  if (left) blocked(`갱신 후 target이 깨끗하지 않다:\n${left}`);
-  return { ok: true, status: "updated", revision, branch, previous };
-}
-
-/** 막힘(Blocked)은 결과로 돌려주고, 예기치 못한 오류는 그대로 던진다. */
-export async function syncCheckout(options: SyncCheckoutOptions): Promise<SyncCheckoutResult> {
-  try {
-    return await run(options);
-  } catch (error) {
-    if (error instanceof Blocked) return { ok: false, status: "blocked", reason: error.message };
-    throw error;
-  }
-}
-
-function parseArgs(argv: string[]): SyncCheckoutOptions {
-  const values: Record<string, string> = {};
-  for (let i = 0; i < argv.length; i += 2) {
-    const key = argv[i];
-    const value = argv[i + 1];
-    if (!["--source", "--target", "--revision"].includes(key) || value === undefined) {
-      throw new Error("usage: sync-checkout.ts --source <path> --target <path> --revision <sha>");
-    }
-    values[key.slice(2)] = value;
-  }
-  if (!values.source || !values.target || !values.revision) {
-    throw new Error("usage: sync-checkout.ts --source <path> --target <path> --revision <sha>");
-  }
-  return { source: values.source, target: values.target, revision: values.revision };
-}
-
-if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
-  try {
-    const result = await syncCheckout(parseArgs(process.argv.slice(2)));
-    console.log(JSON.stringify(result));
-    process.exit(result.ok ? 0 : 1);
-  } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exit(2);
-  }
-}
+/**
+ * 검증·게시가 끝난 커밋을 같은 프로젝트의 다른 체크아웃(예: WSL 작업본 → Windows 사본)에 fast-forward로 반영하는 CLI.
+ *
+ *   bun sync-checkout.ts --source <루트> --target <루트> --revision <40자 sha>
+ *
+ * 모델 도구가 아니다. 상시 동기화·스케줄러·훅 없이, 호출될 때 한 번만 일한다. 빌드·설치·배포는 하지 않는다.
+ * 대상 사본의 변경(tracked·staged·무시되지 않는 untracked)이나 갈라진/앞선 이력이 있으면 아무것도 바꾸지 않고 멈춘다.
+ * reset·stash·clean·force checkout·rebase·merge·잠금 삭제는 쓰지 않는다. 갱신은 `merge --ff-only <정확한 sha>` 하나다.
+ */
+import { execFile } from "node:child_process";
+import { realpath } from "node:fs/promises";
+import { resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { type GitExecutor, selectGitExecutor } from "./wsl-git";
+
+export interface SyncCheckoutOptions {
+  source: string;
+  target: string;
+  revision: string;
+}
+
+export type SyncCheckoutResult =
+  | { ok: true; status: "updated" | "already-current"; revision: string; branch: string; previous: string }
+  | { ok: false; status: "blocked"; reason: string };
+
+interface GitOutput {
+  code: number;
+  stdout: string;
+  stderr: string;
+}
+
+class Blocked extends Error {}
+
+function blocked(reason: string): never {
+  throw new Blocked(reason);
+}
+
+/**
+ * git에 넘길 비대화형 환경. Windows git.exe는 interop에서 WSLENV에 이름이 든 변수만 받으므로(2026-10-11 실측: 이름이 없으면
+ * 빈 값) 두 변수를 WSLENV에 더한다. 기존 WSLENV 항목은 보존한다. 전역 환경은 바꾸지 않고 자식 프로세스에만 적용한다.
+ */
+function gitEnv(): NodeJS.ProcessEnv {
+  const names = (process.env.WSLENV ?? "").split(":").filter((entry) => entry.length > 0);
+  for (const name of ["GIT_TERMINAL_PROMPT", "GCM_INTERACTIVE"]) {
+    if (!names.some((entry) => entry.split("/")[0] === name)) names.push(name);
+  }
+  return { ...process.env, GIT_TERMINAL_PROMPT: "0", GCM_INTERACTIVE: "never", WSLENV: names.join(":") };
+}
+
+function runGit(executor: GitExecutor, cwd: string, args: string[]): Promise<GitOutput> {
+  const { promise, resolve, reject } = Promise.withResolvers<GitOutput>();
+  execFile(
+    executor.command,
+    args,
+    { cwd, env: gitEnv(), maxBuffer: 16 * 1024 * 1024 },
+    (error, stdout, stderr) => {
+      if (error && typeof error.code !== "number") {
+        reject(error);
+        return;
+      }
+      resolve({ code: typeof error?.code === "number" ? error.code : 0, stdout: String(stdout), stderr: String(stderr) });
+    },
+  );
+  return promise;
+}
+
+/** 성공해야 하는 git 호출. 실패하면 stderr를 이유로 멈춘다. */
+async function git(executor: GitExecutor, cwd: string, args: string[], what: string): Promise<string> {
+  const out = await runGit(executor, cwd, args);
+  if (out.code !== 0) blocked(`${what} 실패(git ${args[0]}, 종료 ${out.code}): ${out.stderr.trim() || out.stdout.trim()}`);
+  return out.stdout.trim();
+}
+
+interface Checkout {
+  executor: GitExecutor;
+  root: string;
+  branch: string;
+  origin: string;
+  head: string;
+}
+
+async function inspect(label: string, path: string): Promise<Checkout> {
+  const root = await realpath(resolve(path)).catch(() => blocked(`${label} 경로가 없다: ${path}`));
+  const executor = await selectGitExecutor(root);
+  const top = executor.toPosix(await git(executor, root, ["rev-parse", "--show-toplevel"], `${label} 루트 확인`));
+  const topReal = await realpath(top).catch(() => blocked(`${label} git 루트를 해석하지 못했다: ${top}`));
+  if (topReal !== root) blocked(`${label} 경로가 체크아웃 루트가 아니다: ${root} (루트 ${topReal})`);
+  const branchOut = await runGit(executor, root, ["symbolic-ref", "--short", "-q", "HEAD"]);
+  if (branchOut.code !== 0 || !branchOut.stdout.trim()) blocked(`${label}이 detached HEAD 상태다`);
+  const origin = await git(executor, root, ["remote", "get-url", "origin"], `${label} origin 확인`);
+  const head = await git(executor, root, ["rev-parse", "HEAD"], `${label} HEAD 확인`);
+  return { executor, root, branch: branchOut.stdout.trim(), origin, head };
+}
+
+/**
+ * 네트워크 원격(`file://`을 뺀 스킴 URL, `[user@]host:path` SSH 형식)은 끝의 `/`와 `.git`을 떼고 비교한다.
+ * `https://github.com/o/r`와 `https://github.com/o/r.git`은 같은 저장소다.
+ * 로컬 경로·`file://` origin은 `r`과 `r.git`이 서로 다른 디렉터리일 수 있어 그대로 비교한다.
+ * SSH 형식의 host는 두 글자 이상이어서 `C:/…` 같은 드라이브 경로는 로컬로 남는다.
+ */
+export function sameOrigin(a: string, b: string): boolean {
+  const remote = /^(?!file:)[a-z][a-z0-9+.-]*:\/\/|^(?:[^/\\@:]+@)?[^/\\@:]{2,}:(?!\/\/)/i;
+  const norm = (url: string) => (remote.test(url) ? url.replace(/\/+$/, "").replace(/\.git$/, "") : url);
+  return norm(a) === norm(b);
+}
+
+async function run({ source, target, revision }: SyncCheckoutOptions): Promise<SyncCheckoutResult> {
+  if (!/^[0-9a-f]{40}$/.test(revision)) blocked("revision은 소문자 40자 전체 sha여야 한다");
+  const src = await inspect("source", source);
+  const dst = await inspect("target", target);
+  if (src.root === dst.root || src.root.startsWith(dst.root + sep) || dst.root.startsWith(src.root + sep)) {
+    blocked(`source와 target이 같거나 겹친다: ${src.root} / ${dst.root}`);
+  }
+  if (!sameOrigin(src.origin, dst.origin)) blocked("source와 target의 origin이 다르다");
+  if (src.branch !== dst.branch) blocked(`브랜치가 다르다: source ${src.branch} / target ${dst.branch}`);
+  if (src.head !== revision) blocked(`요청한 revision이 source HEAD(${src.head})와 다르다`);
+
+  const { executor, root, branch } = dst;
+  const dirty = await git(executor, root, ["status", "--porcelain", "--untracked-files=normal"], "target 상태 확인");
+  if (dirty) blocked(`target에 반영되지 않은 변경이 있어 건드리지 않는다:\n${dirty}`);
+
+  // target의 기존 origin 설정 그대로, 비대화형으로 그 브랜치 하나만 가져와 게시 여부를 확인한다.
+  await git(executor, root, ["fetch", "--no-tags", "origin", `refs/heads/${branch}`], "origin fetch");
+  const tip = await git(executor, root, ["rev-parse", "FETCH_HEAD"], "FETCH_HEAD 확인");
+  const known = await runGit(executor, root, ["cat-file", "-e", `${revision}^{commit}`]);
+  if (known.code !== 0) blocked(`origin/${branch}에서 ${revision} 커밋을 찾지 못했다(게시되지 않음)`);
+  const published = await runGit(executor, root, ["merge-base", "--is-ancestor", revision, tip]);
+  if (published.code !== 0) blocked(`${revision}은 origin/${branch}에 게시되지 않았다`);
+
+  const previous = dst.head;
+  if (previous === revision) return { ok: true, status: "already-current", revision, branch, previous };
+
+  const ff = await runGit(executor, root, ["merge-base", "--is-ancestor", previous, revision]);
+  if (ff.code !== 0) blocked(`target HEAD(${previous})가 ${revision}의 조상이 아니다(앞섰거나 갈라짐). 건드리지 않는다`);
+
+  // fetch 동안 target이 바뀌지 않았는지 갱신 직전에 다시 본다. 바뀌었으면 되돌리지 않고 멈춘다.
+  const nowHead = await git(executor, root, ["rev-parse", "HEAD"], "갱신 직전 HEAD 확인");
+  const nowDirty = await git(executor, root, ["status", "--porcelain", "--untracked-files=normal"], "갱신 직전 상태 확인");
+  if (nowHead !== previous || nowDirty) blocked("fetch 중 target이 바뀌어 갱신하지 않았다");
+  // 무시된 로컬 파일이 새로 추적되는 경로와 겹쳐도 덮어쓰지 않는다(git merge 기본값은 덮어쓴다).
+  await git(executor, root, ["merge", "--ff-only", "--no-overwrite-ignore", revision], "fast-forward");
+  const after = await git(executor, root, ["rev-parse", "HEAD"], "갱신 후 HEAD 확인");
+  if (after !== revision) blocked(`갱신 후 target HEAD(${after})가 요청 revision과 다르다`);
+  const left = await git(executor, root, ["status", "--porcelain", "--untracked-files=normal"], "갱신 후 상태 확인");
+  if (left) blocked(`갱신 후 target이 깨끗하지 않다:\n${left}`);
+  return { ok: true, status: "updated", revision, branch, previous };
+}
+
+/** 막힘(Blocked)은 결과로 돌려주고, 예기치 못한 오류는 그대로 던진다. */
+export async function syncCheckout(options: SyncCheckoutOptions): Promise<SyncCheckoutResult> {
+  try {
+    return await run(options);
+  } catch (error) {
+    if (error instanceof Blocked) return { ok: false, status: "blocked", reason: error.message };
+    throw error;
+  }
+}
+
+function parseArgs(argv: string[]): SyncCheckoutOptions {
+  const values: Record<string, string> = {};
+  for (let i = 0; i < argv.length; i += 2) {
+    const key = argv[i];
+    const value = argv[i + 1];
+    if (!["--source", "--target", "--revision"].includes(key) || value === undefined) {
+      throw new Error("usage: sync-checkout.ts --source <path> --target <path> --revision <sha>");
+    }
+    values[key.slice(2)] = value;
+  }
+  if (!values.source || !values.target || !values.revision) {
+    throw new Error("usage: sync-checkout.ts --source <path> --target <path> --revision <sha>");
+  }
+  return { source: values.source, target: values.target, revision: values.revision };
+}
+
+if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  try {
+    const result = await syncCheckout(parseArgs(process.argv.slice(2)));
+    console.log(JSON.stringify(result));
+    process.exit(result.ok ? 0 : 1);
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(2);
+  }
+}

package/Tools/OMP_Global_Config/agent/tools/git-finalizer/wsl-git.ts

@@ -1,96 +1,96 @@
-/**
- * WSL에서 Windows 드라이브(`/mnt/<드라이브>/`) 위 저장소를 어느 git으로 다룰지 정하는 공용 규칙.
- *
- * Linux git은 9p로 파일마다 stat해 3,905개 파일 저장소의 `git status`가 4초 가까이 걸린다(2026-10-09 실측).
- * 같은 저장소를 Windows `git.exe`(interop)에 맡기면 수십 ms다. 그래서 WSL + `/mnt/<드라이브>/` 경로면 Windows git을
- * 쓴다. 단 하나는 예외다: WSL Linux git이 만든 linked worktree는 `.git` 파일에 `gitdir: /mnt/e/...` 같은 Linux 경로를
- * 적어 Windows git이 따라가지 못한다. 그런 worktree는 느려도 Linux git이다.
- *
- * 이 파일은 `lib/wsl-git.ts`(Next 앱)와 같은 규칙의 짝이다. 하네스는 ~/.omp/agent로 복사돼 앱 번들과 분리되므로
- * 한쪽이 다른 쪽을 import할 수 없다. 규칙을 바꿀 때는 두 파일을 함께 바꾼다(`lib/wsl-git.test.mjs`가 두 구현이
- * 같은 판정을 내는지 확인한다).
- */
-import { existsSync } from "node:fs";
-import { readFile, stat } from "node:fs/promises";
-import { delimiter, dirname, join, resolve } from "node:path";
-
-export interface GitExecutor {
-  /** execFile에 넘길 실행 파일. */
-  command: "git" | "git.exe";
-  windows: boolean;
-  /**
-   * git이 출력한 절대 경로를 호출자가 쓰는 POSIX 경로로 바꾼다. Windows git은 `D:/repo/.git`처럼 쓰므로
-   * `/mnt/d/repo/.git`로 돌려놓아야 Linux 쪽 경로와 같은 기준으로 비교된다. Linux git이면 그대로다.
-   */
-  toPosix(value: string): string;
-}
-
-/** WSL이고 `/mnt/<드라이브>` 아래(드라이브 루트 포함) 경로인가. */
-export function isWindowsDrivePath(cwd: string): boolean {
-  return process.platform === "linux" && Boolean(process.env.WSL_DISTRO_NAME) && /^\/mnt\/[a-z](?:\/|$)/i.test(cwd);
-}
-
-/** `D:/a/b`·`D:\a\b`를 `/mnt/d/a/b`로 바꾼다. 드라이브 문자로 시작하지 않으면 그대로 돌려준다. */
-export function windowsPathToPosix(value: string): string {
-  const match = /^([A-Za-z]):[\\/]*(.*)$/.exec(value);
-  if (!match) return value;
-  const rest = match[2].replace(/\\/g, "/").replace(/\/+$/, "");
-  return rest ? `/mnt/${match[1].toLowerCase()}/${rest}` : `/mnt/${match[1].toLowerCase()}`;
-}
-
-/**
- * 시작 디렉터리에서 위로 올라가 처음 만나는 `.git`이 `gitdir: /...`(POSIX 경로)를 가리키는 파일이면 true다.
- * 2026-10-09 `.worktrees/dart-cron-order`에서 Windows git이 `fatal: not a git repository`로 끝났다.
- */
-export async function hasPosixGitdirWorktreeFrom(startDirectory: string): Promise<boolean> {
-  let dir = resolve(startDirectory);
-  for (;;) {
-    const dotGit = join(dir, ".git");
-    const info = await stat(dotGit).catch(() => undefined);
-    if (info) return info.isFile() && /^gitdir:\s*\//m.test(await readFile(dotGit, "utf8"));
-    const parent = dirname(dir);
-    if (parent === dir) return false;
-    dir = parent;
-  }
-}
-
-/** 대상 파일마다 위로 올라가 POSIX gitdir worktree에 속한 파일이 하나라도 있으면 true다. */
-export async function hasPosixGitdirWorktree(cwd: string, files: string[]): Promise<boolean> {
-  for (const file of files) {
-    if (await hasPosixGitdirWorktreeFrom(dirname(resolve(cwd, file)))) return true;
-  }
-  return false;
-}
-
-/**
- * WSL + `/mnt/<드라이브>/` + POSIX gitdir worktree가 아님 → Windows 쪽에서 다룬다. finalizer와 git 실행기가 같은 판정을 쓴다.
- * `files`가 없으면 `cwd` 디렉터리 자체에서 위로 올라가며 보고, 있으면 파일마다 부모 디렉터리에서 올라간다.
- */
-export async function usesWindowsDriveRepo(cwd: string, files?: string[]): Promise<boolean> {
-  if (!isWindowsDrivePath(cwd)) return false;
-  return !(await (files ? hasPosixGitdirWorktree(cwd, files) : hasPosixGitdirWorktreeFrom(cwd)));
-}
-
-const LINUX_GIT: GitExecutor = { command: "git", windows: false, toPosix: (value) => value };
-const WINDOWS_GIT: GitExecutor = { command: "git.exe", windows: true, toPosix: windowsPathToPosix };
-
-let windowsGitProbe: { path: string; found: boolean } | undefined;
-
-/** interop이 꺼져 PATH에 git.exe가 없으면 Linux git으로 남긴다. PATH가 바뀌면 다시 본다. */
-function hasWindowsGit(): boolean {
-  const path = process.env.PATH ?? "";
-  if (windowsGitProbe?.path !== path) {
-    windowsGitProbe = { path, found: path.split(delimiter).some((dir) => dir && existsSync(join(dir, "git.exe"))) };
-  }
-  return windowsGitProbe.found;
-}
-
-/**
- * `directory`(git을 실행할 cwd)에서 쓸 git을 고른다. Windows git은 호출자의 cwd 옵션으로 실행한다.
- * WSL interop이 `/mnt/<드라이브>` cwd를 Windows 경로로 넘기므로 경로 인자를 따로 바꿀 필요가 없다.
- */
-export async function selectGitExecutor(directory: string): Promise<GitExecutor> {
-  if (!hasWindowsGit()) return LINUX_GIT;
-  // `.git` 파일을 읽지 못하는 등 판정을 못 하면 어느 git이든 열 수 있는 Linux git으로 남긴다.
-  return (await usesWindowsDriveRepo(directory).catch(() => false)) ? WINDOWS_GIT : LINUX_GIT;
-}
+/**
+ * WSL에서 Windows 드라이브(`/mnt/<드라이브>/`) 위 저장소를 어느 git으로 다룰지 정하는 공용 규칙.
+ *
+ * Linux git은 9p로 파일마다 stat해 3,905개 파일 저장소의 `git status`가 4초 가까이 걸린다(2026-10-09 실측).
+ * 같은 저장소를 Windows `git.exe`(interop)에 맡기면 수십 ms다. 그래서 WSL + `/mnt/<드라이브>/` 경로면 Windows git을
+ * 쓴다. 단 하나는 예외다: WSL Linux git이 만든 linked worktree는 `.git` 파일에 `gitdir: /mnt/e/...` 같은 Linux 경로를
+ * 적어 Windows git이 따라가지 못한다. 그런 worktree는 느려도 Linux git이다.
+ *
+ * 이 파일은 `lib/wsl-git.ts`(Next 앱)와 같은 규칙의 짝이다. 하네스는 ~/.omp/agent로 복사돼 앱 번들과 분리되므로
+ * 한쪽이 다른 쪽을 import할 수 없다. 규칙을 바꿀 때는 두 파일을 함께 바꾼다(`lib/wsl-git.test.mjs`가 두 구현이
+ * 같은 판정을 내는지 확인한다).
+ */
+import { existsSync } from "node:fs";
+import { readFile, stat } from "node:fs/promises";
+import { delimiter, dirname, join, resolve } from "node:path";
+
+export interface GitExecutor {
+  /** execFile에 넘길 실행 파일. */
+  command: "git" | "git.exe";
+  windows: boolean;
+  /**
+   * git이 출력한 절대 경로를 호출자가 쓰는 POSIX 경로로 바꾼다. Windows git은 `D:/repo/.git`처럼 쓰므로
+   * `/mnt/d/repo/.git`로 돌려놓아야 Linux 쪽 경로와 같은 기준으로 비교된다. Linux git이면 그대로다.
+   */
+  toPosix(value: string): string;
+}
+
+/** WSL이고 `/mnt/<드라이브>` 아래(드라이브 루트 포함) 경로인가. */
+export function isWindowsDrivePath(cwd: string): boolean {
+  return process.platform === "linux" && Boolean(process.env.WSL_DISTRO_NAME) && /^\/mnt\/[a-z](?:\/|$)/i.test(cwd);
+}
+
+/** `D:/a/b`·`D:\a\b`를 `/mnt/d/a/b`로 바꾼다. 드라이브 문자로 시작하지 않으면 그대로 돌려준다. */
+export function windowsPathToPosix(value: string): string {
+  const match = /^([A-Za-z]):[\\/]*(.*)$/.exec(value);
+  if (!match) return value;
+  const rest = match[2].replace(/\\/g, "/").replace(/\/+$/, "");
+  return rest ? `/mnt/${match[1].toLowerCase()}/${rest}` : `/mnt/${match[1].toLowerCase()}`;
+}
+
+/**
+ * 시작 디렉터리에서 위로 올라가 처음 만나는 `.git`이 `gitdir: /...`(POSIX 경로)를 가리키는 파일이면 true다.
+ * 2026-10-09 `.worktrees/dart-cron-order`에서 Windows git이 `fatal: not a git repository`로 끝났다.
+ */
+export async function hasPosixGitdirWorktreeFrom(startDirectory: string): Promise<boolean> {
+  let dir = resolve(startDirectory);
+  for (;;) {
+    const dotGit = join(dir, ".git");
+    const info = await stat(dotGit).catch(() => undefined);
+    if (info) return info.isFile() && /^gitdir:\s*\//m.test(await readFile(dotGit, "utf8"));
+    const parent = dirname(dir);
+    if (parent === dir) return false;
+    dir = parent;
+  }
+}
+
+/** 대상 파일마다 위로 올라가 POSIX gitdir worktree에 속한 파일이 하나라도 있으면 true다. */
+export async function hasPosixGitdirWorktree(cwd: string, files: string[]): Promise<boolean> {
+  for (const file of files) {
+    if (await hasPosixGitdirWorktreeFrom(dirname(resolve(cwd, file)))) return true;
+  }
+  return false;
+}
+
+/**
+ * WSL + `/mnt/<드라이브>/` + POSIX gitdir worktree가 아님 → Windows 쪽에서 다룬다. finalizer와 git 실행기가 같은 판정을 쓴다.
+ * `files`가 없으면 `cwd` 디렉터리 자체에서 위로 올라가며 보고, 있으면 파일마다 부모 디렉터리에서 올라간다.
+ */
+export async function usesWindowsDriveRepo(cwd: string, files?: string[]): Promise<boolean> {
+  if (!isWindowsDrivePath(cwd)) return false;
+  return !(await (files ? hasPosixGitdirWorktree(cwd, files) : hasPosixGitdirWorktreeFrom(cwd)));
+}
+
+const LINUX_GIT: GitExecutor = { command: "git", windows: false, toPosix: (value) => value };
+const WINDOWS_GIT: GitExecutor = { command: "git.exe", windows: true, toPosix: windowsPathToPosix };
+
+let windowsGitProbe: { path: string; found: boolean } | undefined;
+
+/** interop이 꺼져 PATH에 git.exe가 없으면 Linux git으로 남긴다. PATH가 바뀌면 다시 본다. */
+function hasWindowsGit(): boolean {
+  const path = process.env.PATH ?? "";
+  if (windowsGitProbe?.path !== path) {
+    windowsGitProbe = { path, found: path.split(delimiter).some((dir) => dir && existsSync(join(dir, "git.exe"))) };
+  }
+  return windowsGitProbe.found;
+}
+
+/**
+ * `directory`(git을 실행할 cwd)에서 쓸 git을 고른다. Windows git은 호출자의 cwd 옵션으로 실행한다.
+ * WSL interop이 `/mnt/<드라이브>` cwd를 Windows 경로로 넘기므로 경로 인자를 따로 바꿀 필요가 없다.
+ */
+export async function selectGitExecutor(directory: string): Promise<GitExecutor> {
+  if (!hasWindowsGit()) return LINUX_GIT;
+  // `.git` 파일을 읽지 못하는 등 판정을 못 하면 어느 git이든 열 수 있는 Linux git으로 남긴다.
+  return (await usesWindowsDriveRepo(directory).catch(() => false)) ? WINDOWS_GIT : LINUX_GIT;
+}