fix: expand tilde in project path input

apps/server/src/checkpointing/Utils.ts

@@ -1,5 +1,6 @@
 import { Encoding } from "effect";
 import { CheckpointRef, ProjectId, type ThreadId } from "@t3tools/contracts";
+import { expandTilde } from "../os-jank.js";
 
 export const CHECKPOINT_REFS_PREFIX = "refs/t3/checkpoints";
 
@@ -24,5 +25,7 @@ export function resolveThreadWorkspaceCwd(input: {
     return worktreeCwd;
   }
 
-  return input.projects.find((project) => project.id === input.thread.projectId)?.workspaceRoot;
+  const raw = input.projects.find((project) => project.id === input.thread.projectId)
+    ?.workspaceRoot;
+  return raw ? expandTilde(raw) : undefined;
 }

apps/server/src/os-jank.test.ts

@@ -0,0 +1,31 @@
+import * as OS from "node:os";
+import { describe, expect, it } from "vitest";
+import { expandTilde } from "./os-jank.js";
+
+describe("expandTilde", () => {
+  const home = OS.homedir();
+
+  it("expands bare ~", () => {
+    expect(expandTilde("~")).toBe(home);
+  });
+
+  it("expands ~/ prefix", () => {
+    expect(expandTilde("~/projects/foo")).toBe(`${home}/projects/foo`);
+  });
+
+  it("expands ~\\ prefix (Windows)", () => {
+    expect(expandTilde("~\\projects\\foo")).toBe(`${home}\\projects\\foo`);
+  });
+
+  it("does not expand ~ in the middle of a path", () => {
+    expect(expandTilde("/home/~user/foo")).toBe("/home/~user/foo");
+  });
+
+  it("returns absolute paths unchanged", () => {
+    expect(expandTilde("/usr/local/bin")).toBe("/usr/local/bin");
+  });
+
+  it("returns empty string unchanged", () => {
+    expect(expandTilde("")).toBe("");
+  });
+});

apps/server/src/os-jank.ts

@@ -16,21 +16,14 @@ export function fixPath(): void {
   }
 }
 
-export const expandHomePath = Effect.fn(function* (input: string) {
-  const { join } = yield* Path.Path;
-  if (input === "~") {
-    return OS.homedir();
-  }
-  if (input.startsWith("~/") || input.startsWith("~\\")) {
-    return join(OS.homedir(), input.slice(2));
-  }
-  return input;
-});
+export function expandTilde(pathStr: string): string {
+  return pathStr.replace(/^~(?=$|[\\/])/, OS.homedir());
+}
 
 export const resolveStateDir = Effect.fn(function* (raw: string | undefined) {
   const { join, resolve } = yield* Path.Path;
   if (!raw || raw.trim().length === 0) {
     return join(OS.homedir(), ".t3", "userdata");
   }
-  return resolve(yield* expandHomePath(raw.trim()));
+  return resolve(expandTilde(raw.trim()));
 });

apps/server/src/wsServer.ts

@@ -300,7 +300,7 @@ export const createServer = Effect.fn(function* (): Effect.fn.Return<
     readonly command: ClientOrchestrationCommand;
   }) {
     const normalizeProjectWorkspaceRoot = Effect.fnUntraced(function* (workspaceRoot: string) {
-      const normalizedWorkspaceRoot = path.resolve(yield* expandHomePath(workspaceRoot.trim()));
+      const normalizedWorkspaceRoot = path.resolve(expandTilde(workspaceRoot.trim()));
       const workspaceStat = yield* fileSystem
         .stat(normalizedWorkspaceRoot)
         .pipe(Effect.catch(() => Effect.succeed(null)));