import { execSync } from "node:child_process"; import { existsSync, rmSync } from "node:fs"; import type { Octokit } from "@octokit/rest"; import type { Payload } from "../external.ts"; import type { ToolState } from "../main.ts"; import { checkoutPrBranch } from "../mcp/checkout.ts"; import { log } from "./cli.ts"; import { $ } from "./shell.ts"; export interface SetupOptions { tempDir: string; forceClean?: boolean; } /** * Setup the test repository for running actions */ export function setupTestRepo(options: SetupOptions): void { const { tempDir, forceClean = false } = options; const repo = process.env.GITHUB_REPOSITORY; if (!repo) { throw new Error( "GITHUB_REPOSITORY environment variable must be specified (e.g. pullfrog/scratch)" ); } const cloneUrl = `git@github.com:${repo}.git`; if (existsSync(tempDir)) { if (forceClean) { log.info("» removing existing .temp directory..."); rmSync(tempDir, { recursive: true, force: true }); log.info(`» cloning ${repo} into .temp...`); $("git", ["clone", cloneUrl, tempDir]); } else { log.info("» resetting existing .temp repository..."); execSync("git reset --hard HEAD && git clean -fd", { cwd: tempDir, stdio: "inherit", }); } } else { log.info(`» cloning ${repo} into .temp...`); $("git", ["clone", cloneUrl, tempDir]); } } /** * Setup git configuration to avoid identity errors * Uses --local flag to scope config to the current repo only */ export function setupGitConfig(): void { const repoDir = process.cwd(); log.info("» setting up git configuration..."); try { // Use --local to scope config to this repo only, preventing leakage to user's global config execSync('git config --local user.email "team@pullfrog.com"', { cwd: repoDir, stdio: "pipe", }); execSync('git config --local user.name "pullfrog"', { cwd: repoDir, stdio: "pipe", }); // disable credential helper to prevent macOS keychain prompts when using x-access-token // only needed locally - GitHub Actions doesn't have this issue if (!process.env.GITHUB_ACTIONS) { execSync('git config --local credential.helper ""', { cwd: repoDir, stdio: "pipe", }); } log.debug("» git configuration set successfully (scoped to repo)"); } catch (error) { // If git config fails, log warning but don't fail the action // This can happen if we're not in a git repo or git isn't available log.warning( `Failed to set git config: ${error instanceof Error ? error.message : String(error)}` ); } } interface SetupGitAuthParams { token: string; owner: string; name: string; payload: Payload; octokit: Octokit; toolState: ToolState; } /** * Setup git authentication for the repository. * For PR events, uses the shared checkoutPrBranch helper (also used by checkout_pr MCP tool). * * FORK PR ARCHITECTURE: * - origin: always points to BASE REPO (where PR targets) * - checkoutPrBranch sets per-branch pushRemote config for fork PRs * - diff operations use: git diff origin/..HEAD */ export async function setupGitAuth(params: SetupGitAuthParams): Promise { const repoDir = process.cwd(); log.info("» setting up git authentication..."); // remove existing git auth headers that actions/checkout might have set try { execSync("git config --local --unset-all http.https://github.com/.extraheader", { cwd: repoDir, stdio: "pipe", }); log.info("» removed existing authentication headers"); } catch { log.debug("» no existing authentication headers to remove"); } // non-PR events: set up origin with token, stay on default branch if (params.payload.event.is_pr !== true || !params.payload.event.issue_number) { const originUrl = `https://x-access-token:${params.token}@github.com/${params.owner}/${params.name}.git`; $("git", ["remote", "set-url", "origin", originUrl], { cwd: repoDir }); log.info("» updated origin URL with authentication token"); return; } // PR event: checkout PR branch using shared helper const prNumber = params.payload.event.issue_number; // ensure origin is configured with auth token before checkout const originUrl = `https://x-access-token:${params.token}@github.com/${params.owner}/${params.name}.git`; $("git", ["remote", "set-url", "origin", originUrl], { cwd: repoDir }); // use shared checkout helper (handles fork remotes, push config, etc.) const prContext = await checkoutPrBranch({ octokit: params.octokit, owner: params.owner, name: params.name, token: params.token, pullNumber: prNumber, }); // set prNumber on toolState (the only mutation) params.toolState.prNumber = prContext.prNumber; }