Method create

lib/worktree.ts:115–149

Create an isolated worktree. Returns the worktree path. Throws on failure.

(testName: string)

  /** Create an isolated worktree. Returns the worktree path. Throws on failure. */
  create(testName: string): string {
    const originalSha = git(['rev-parse', 'HEAD'], this.repoRoot);

    const worktreeBase = path.join(this.repoRoot, '.gstack-worktrees', this.runId);
    fs.mkdirSync(worktreeBase, { recursive: true });

    const worktreePath = path.join(worktreeBase, testName);

    // Create detached worktree at current HEAD
    git(['worktree', 'add', '--detach', worktreePath, 'HEAD'], this.repoRoot);

    // Copy gitignored build artifacts that tests need (config-driven)
    const { getExternalHosts } = require('../hosts/index');
    for (const hostConfig of getExternalHosts()) {
      const hostSrc = path.join(this.repoRoot, hostConfig.hostSubdir);
      if (fs.existsSync(hostSrc)) {
        copyDirSync(hostSrc, path.join(worktreePath, hostConfig.hostSubdir));
      }
    }

    const browseDist = path.join(this.repoRoot, 'browse', 'dist');
    if (fs.existsSync(browseDist)) {
      copyDirSync(browseDist, path.join(worktreePath, 'browse', 'dist'));
    }

    const info: WorktreeInfo = {
      path: worktreePath,
      testName,
      originalSha,
      createdAt: Date.now(),
    };
    this.active.set(testName, info);

    return worktreePath;
  }

  /** Harvest changes from a worktree. Returns null if clean or on error. */
  harvest(testName: string): HarvestResult | null {