singularity-forge/tests/repro-worktree-bug/repro.mjs

/**
 * Reproduction: Parallel Worktree Path Resolution Escapes to Home Directory
 *
 * This script reproduces the bug where resolveProjectRoot() returns the
 * user's home directory (~) when the project .gsd is a symlink into
 * ~/.gsd/projects/<hash> and worktree isolation is enabled.
 *
 * Layout mimics pi's default:
 *   /root/.gsd/projects/<hash>/          ← user-level GSD storage
 *   /tmp/myproject/.gsd → symlink to ↑   ← project's .gsd
 *   /tmp/myproject/.gsd/worktrees/M001/  ← worktree (logical path through symlink)
 *
 * When a worker spawns with cwd = /tmp/myproject/.gsd/worktrees/M001,
 * process.cwd() resolves symlinks → /root/.gsd/projects/<hash>/worktrees/M001.
 * findWorktreeSegment() then matches /.gsd/ at the WRONG boundary (the
 * user-level ~/.gsd), causing resolveProjectRoot() to return /root (home dir).
 */

import { mkdirSync, symlinkSync, existsSync, realpathSync, mkdtempSync } from "node:fs";
import { execSync } from "node:child_process";
import { join } from "node:path";
import { homedir, tmpdir } from "node:os";

// ── Reproduce the exact functions from worktree.ts ──────────────────────

function findWorktreeSegment(normalizedPath) {
  // Direct layout: /.gsd/worktrees/<name>
  const directMarker = "/.gsd/worktrees/";
  const idx = normalizedPath.indexOf(directMarker);
  if (idx !== -1) {
    return { gsdIdx: idx, afterWorktrees: idx + directMarker.length };
  }
  // Symlink-resolved layout: /.gsd/projects/<hash>/worktrees/<name>
  const symlinkRe = /\/\.gsd\/projects\/[a-f0-9]+\/worktrees\//;
  const match = normalizedPath.match(symlinkRe);
  if (match && match.index !== undefined) {
    return { gsdIdx: match.index, afterWorktrees: match.index + match[0].length };
  }
  return null;
}

function resolveProjectRoot(basePath) {
  const normalizedPath = basePath.replaceAll("\\", "/");
  const seg = findWorktreeSegment(normalizedPath);
  if (!seg) return basePath;
  // Return the original path up to the /.gsd/ boundary
  const sep = basePath.includes("\\") ? "\\" : "/";
  const gsdMarker = `${sep}.gsd${sep}`;
  const gsdIdx = basePath.indexOf(gsdMarker);
  if (gsdIdx !== -1) return basePath.slice(0, gsdIdx);
  return basePath.slice(0, seg.gsdIdx);
}

// ── Set up the filesystem layout ────────────────────────────────────────

const HASH = "abc123def456";
const TEST_ROOT = mkdtempSync(join(tmpdir(), "gsd-repro-"));
const USER_GSD = process.env.GSD_HOME || join(TEST_ROOT, ".gsd");
const USER_HOME = homedir();
const PROJECT_GSD_STORAGE = `${USER_GSD}/projects/${HASH}`;
const PROJECT_DIR = mkdtempSync(join(tmpdir(), "myproject-"));
const PROJECT_GSD_LINK = `${PROJECT_DIR}/.gsd`;

console.log("=== Setting up filesystem layout ===\n");

// 1. Create user-level GSD structure
mkdirSync(`${PROJECT_GSD_STORAGE}/worktrees/M001`, { recursive: true });
mkdirSync(`${PROJECT_GSD_STORAGE}/milestones`, { recursive: true });
console.log(`Created: ${PROJECT_GSD_STORAGE}/worktrees/M001`);

// 2. Create project directory
mkdirSync(PROJECT_DIR, { recursive: true });
console.log(`Created: ${PROJECT_DIR}`);

// 3. Create symlink: project/.gsd → user-level storage
symlinkSync(PROJECT_GSD_STORAGE, PROJECT_GSD_LINK);
console.log(`Symlink: ${PROJECT_GSD_LINK} → ${PROJECT_GSD_STORAGE}`);

// 4. Init git in project dir
execSync("git init -b main", { cwd: PROJECT_DIR, stdio: "pipe" });
execSync('git config user.name "Test"', { cwd: PROJECT_DIR, stdio: "pipe" });
execSync('git config user.email "test@test.com"', { cwd: PROJECT_DIR, stdio: "pipe" });
execSync("git commit --allow-empty -m init", { cwd: PROJECT_DIR, stdio: "pipe" });
console.log(`Git init: ${PROJECT_DIR}`);

console.log("\n=== Path Resolution Tests ===\n");

// ── Test 1: Logical path (through symlink) ──────────────────────────────

const logicalPath = `${PROJECT_DIR}/.gsd/worktrees/M001`;
console.log(`Test 1: Logical path (through symlink)`);
console.log(`  Input:    ${logicalPath}`);
console.log(`  Expected: ${PROJECT_DIR}`);
const result1 = resolveProjectRoot(logicalPath);
console.log(`  Got:      ${result1}`);
console.log(`  Status:   ${result1 === PROJECT_DIR ? "✅ PASS" : "❌ FAIL — BUG NOT TRIGGERED (logical path)"}`);

// ── Test 2: Resolved path (what process.cwd() returns) ──────────────────

const resolvedPath = realpathSync(logicalPath);
console.log(`\nTest 2: Resolved path (what process.cwd() returns after chdir to worktree)`);
console.log(`  Input:    ${resolvedPath}`);
console.log(`  Expected: ${PROJECT_DIR}`);
const result2 = resolveProjectRoot(resolvedPath);
console.log(`  Got:      ${result2}`);
const isBuggy = result2 !== PROJECT_DIR;
console.log(`  Status:   ${isBuggy ? "🐛 BUG REPRODUCED — resolves to wrong directory!" : "✅ PASS"}`);

// ── Test 3: Simulate what actually happens in a worker ──────────────────

console.log(`\nTest 3: Simulating worker process.cwd() resolution`);
process.chdir(logicalPath);
const workerCwd = process.cwd(); // This resolves symlinks!
console.log(`  chdir to: ${logicalPath}`);
console.log(`  cwd():    ${workerCwd}`);
console.log(`  Expected project root: ${PROJECT_DIR}`);
const result3 = resolveProjectRoot(workerCwd);
console.log(`  resolveProjectRoot():  ${result3}`);
const workerBuggy = result3 !== PROJECT_DIR;
console.log(`  Status:   ${workerBuggy ? "🐛 BUG REPRODUCED — worker would use wrong project root!" : "✅ PASS"}`);

// ── Test 4: Show the cascade ────────────────────────────────────────────

if (workerBuggy) {
  console.log(`\n=== Cascade Analysis ===\n`);
  console.log(`The worker thinks project root is: ${result3}`);
  console.log(`It would look for .gsd at:         ${result3}/.gsd`);
  console.log(`That path exists:                   ${existsSync(join(result3, ".gsd"))}`);
  
  if (existsSync(join(result3, ".gsd"))) {
    const resolvedGsd = realpathSync(join(result3, ".gsd"));
    console.log(`It resolves to:                    ${resolvedGsd}`);
    console.log(`\nThis is the USER-LEVEL .gsd directory!`);
    console.log(`The worker would:`);
    console.log(`  1. Write session status to ~/.gsd/parallel/`);
    console.log(`  2. Write orchestrator.json to ~/.gsd/`);
    console.log(`  3. Potentially git init in ${result3} (the home directory)`);
    console.log(`  4. Corrupt the user-level GSD configuration`);
  }
}

// ── Test 5: Verify findWorktreeSegment matches at the wrong /.gsd/ ──────

console.log(`\n=== Root Cause Detail ===\n`);
const seg = findWorktreeSegment(resolvedPath);
if (seg) {
  console.log(`findWorktreeSegment() matched:`);
  console.log(`  gsdIdx:         ${seg.gsdIdx}`);
  console.log(`  afterWorktrees: ${seg.afterWorktrees}`);
  console.log(`  Path before /.gsd/: "${resolvedPath.slice(0, seg.gsdIdx)}"`);
  console.log(`  This is: ${resolvedPath.slice(0, seg.gsdIdx) === USER_HOME ? "THE HOME DIRECTORY (bug!)" : "some other directory"}`);
  
  // Show which regex matched
  const directMarker = "/.gsd/worktrees/";
  const directIdx = resolvedPath.indexOf(directMarker);
  if (directIdx !== -1) {
    console.log(`\n  Matched by: direct marker "/.gsd/worktrees/" at index ${directIdx}`);
    console.log(`  The /.gsd/ it found is at: "${resolvedPath.slice(0, directIdx + 5)}"`);
    console.log(`  This /.gsd/ is the USER-LEVEL ~/.gsd, not the project .gsd!`);
  } else {
    console.log(`\n  Matched by: symlink regex`);
  }
}

// ── Summary ─────────────────────────────────────────────────────────────

console.log(`\n${"=".repeat(60)}`);
if (workerBuggy) {
  console.log(`\n🐛 BUG CONFIRMED: resolveProjectRoot() returns "${result3}"`);
  console.log(`   when it should return "${PROJECT_DIR}"`);
  console.log(`   because findWorktreeSegment() matches the /.gsd/ in the`);
  console.log(`   user-level ~/.gsd path, not the project-level .gsd symlink.`);
  process.exit(1);
} else {
  console.log(`\n✅ Bug not reproduced — may be fixed.`);
  process.exit(0);
}