#!/usr/bin/env bun /** * Git utilities for upstream merge automation */ import { $ } from "bun" export interface BranchInfo { current: string exists: boolean } export interface RemoteInfo { name: string url: string } export async function getCurrentBranch(): Promise { const result = await $`git rev-parse --abbrev-ref HEAD`.text() return result.trim() } export async function branchExists(name: string): Promise { const result = await $`git show-ref --verify --quiet refs/heads/${name}`.nothrow() return result.exitCode === 0 } export async function remoteBranchExists(remote: string, branch: string): Promise { const result = await $`git ls-remote --heads ${remote} ${branch}`.text() return result.trim().length > 0 } export async function getRemotes(): Promise { const result = await $`git remote -v`.text() const lines = result.trim().split("\n") const remotes: RemoteInfo[] = [] const seen = new Set() for (const line of lines) { const parts = line.split(/\s+/) const name = parts[0] ?? "" const url = parts[1] ?? "" if (name && !seen.has(name)) { seen.add(name) remotes.push({ name, url }) } } return remotes } export async function hasUpstreamRemote(): Promise { const remotes = await getRemotes() return remotes.some((r) => r.name === "upstream") } export async function fetchUpstream(): Promise { const result = await $`git fetch upstream`.quiet().nothrow() if (result.exitCode !== 0) { throw new Error(`Failed to fetch upstream: ${result.stderr.toString()}`) } } export async function checkout(ref: string): Promise { await $`git checkout ${ref}` } export async function createBranch(name: string, from?: string): Promise { if (from) { await $`git checkout -b ${name} ${from}` } else { await $`git checkout -b ${name}` } } export async function deleteBranch(name: string, force = false): Promise { if (force) { await $`git branch -D ${name}` } else { await $`git branch -d ${name}` } } export async function backupAndDeleteBranch(name: string): Promise { if (!(await branchExists(name))) return null const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19) const backupName = `backup/${name}-${timestamp}` const current = await getCurrentBranch() // Create backup from the existing branch await $`git branch ${backupName} ${name}` // Delete the old branch (must not be on it) if (current === name) { throw new Error(`Cannot backup and delete branch '${name}' while it is checked out`) } await deleteBranch(name, true) return backupName } export async function push(remote = "origin", branch?: string, setUpstream = false): Promise { const currentBranch = branch || (await getCurrentBranch()) if (setUpstream) { await $`git push -u ${remote} ${currentBranch}` } else { await $`git push ${remote} ${currentBranch}` } } export async function pull(remote = "origin", branch?: string): Promise { if (branch) { await $`git pull ${remote} ${branch}` } else { await $`git pull ${remote}` } } export async function commit(message: string): Promise { await $`git commit -am ${message}` } export async function merge(branch: string): Promise<{ success: boolean; conflicts: string[] }> { const result = await $`git merge ${branch}`.nothrow() if (result.exitCode === 0) { return { success: true, conflicts: [] } } // Get list of conflicted files const conflicts = await getConflictedFiles() return { success: false, conflicts } } export async function getConflictedFiles(): Promise { const result = await $`git diff --name-only --diff-filter=U`.text() return result .trim() .split("\n") .filter((f) => f.length > 0) } export async function hasUncommittedChanges(): Promise { const result = await $`git status --porcelain`.text() return result.trim().length > 0 } export async function restoreDirectories(dirs: string[]): Promise { for (const dir of dirs) { await $`git restore ${dir}`.quiet().nothrow() } } export async function stageAll(): Promise { await $`git add -A` } export async function stageFiles(files: string[]): Promise { for (const file of files) { await $`git add ${file}` } } export async function getCommitMessage(ref: string): Promise { const result = await $`git log -1 --format=%s ${ref}`.text() return result.trim() } export async function getCommitHash(ref: string): Promise { const result = await $`git rev-parse ${ref}`.text() return result.trim() } export async function getTagsForCommit(commit: string): Promise { const result = await $`git tag --points-at ${commit}`.text() return result .trim() .split("\n") .filter((t) => t.length > 0) } export async function getAllTags(): Promise { const result = await $`git tag -l`.text() return result .trim() .split("\n") .filter((t) => t.length > 0) } export async function getUpstreamTags(): Promise { const result = await $`git ls-remote --tags upstream`.quiet().nothrow() if (result.exitCode !== 0) { throw new Error(`Failed to list upstream tags: ${result.stderr.toString()}`) } const output = result.stdout.toString() const tags: string[] = [] for (const line of output.trim().split("\n")) { const match = line.match(/refs\/tags\/([^\^]+)$/) if (match && match[1]) tags.push(match[1]) } return tags } export async function abortMerge(): Promise { await $`git merge --abort` } export async function checkoutOurs(files: string[]): Promise { for (const file of files) { await $`git checkout --ours ${file}` } } export async function checkoutTheirs(files: string[]): Promise { for (const file of files) { await $`git checkout --theirs ${file}` } } /** * Remove untracked files and directories from specific directories. * Used to clean build artifacts from Kilo-specific directories after checking * out the upstream branch, where package-level .gitignore files don't exist. */ export async function cleanDirectories(dirs: string[]): Promise { for (const dir of dirs) { await $`git clean -fd ${dir}`.quiet().nothrow() } } /** * Check if the "ours" version of a conflicted file contains kilocode_change markers. * Uses git stage :2: which is the "ours" side during a merge conflict. * Returns false if the file doesn't exist in ours (new file from upstream). */ export async function oursHasKilocodeChanges(file: string): Promise { const result = await $`git show :2:${file}`.quiet().nothrow() if (result.exitCode !== 0) return false return result.stdout.toString().includes("kilocode_change") } /** * Enable git rerere (REuse REcorded REsolution) in the local repo config. * Also enables autoupdate so resolved files are automatically staged. */ export async function ensureRerere(): Promise { await $`git config rerere.enabled true`.quiet() await $`git config rerere.autoupdate true`.quiet() } /** * Train the rerere cache from past merge commits in the repo history. * Implements the same logic as git's contrib/rerere-train.sh: * For each merge commit in the range, replay the merge to let rerere * record the pre-image, then check out the resolved tree so rerere * records the post-image (the resolution). * * Returns the number of resolutions learned. */ export async function trainRerere(grep: string): Promise { // Save the current HEAD so we can restore it afterwards const headResult = await $`git symbolic-ref -q HEAD`.quiet().nothrow() const branch = headResult.exitCode === 0 ? headResult.stdout.toString().trim() : null const originalHead = branch ?? (await $`git rev-parse --verify HEAD`.text()).trim() let learned = 0 try { // Find all merge commits matching the grep pattern (merges have multiple parents) const revList = await $`git rev-list --parents --all --grep=${grep}`.quiet().nothrow() if (revList.exitCode !== 0 || !revList.stdout.toString().trim()) return 0 const lines = revList.stdout .toString() .trim() .split("\n") .filter((l) => l.trim()) for (const line of lines) { const parts = line.trim().split(/\s+/) if (parts.length < 3) continue // skip non-merges (need commit + at least 2 parents) const [commit, parent1, ...otherParents] = parts // Checkout the first parent const coResult = await $`git checkout -q ${parent1}`.quiet().nothrow() if (coResult.exitCode !== 0) continue // Attempt the merge - we expect it to fail with conflicts const mergeResult = await $`git merge --no-gpg-sign ${otherParents}`.quiet().nothrow() if (mergeResult.exitCode === 0) { // Cleanly merged — no conflicts to learn from, reset and skip await $`git reset -q --hard`.quiet().nothrow() continue } // Check if rerere recorded a pre-image (MERGE_RR exists and is non-empty) const mergeRR = Bun.file(`${process.env.GIT_DIR || ".git"}/MERGE_RR`) const hasMergeRR = await mergeRR.exists().catch(() => false) if (!hasMergeRR) { await $`git reset -q --hard`.quiet().nothrow() continue } // Record the conflict pre-image await $`git rerere`.quiet().nothrow() // Apply the actual resolution by checking out the merge commit's tree await $`git checkout -q ${commit} -- .`.quiet().nothrow() // Record the resolution post-image await $`git rerere`.quiet().nothrow() learned++ await $`git reset -q --hard`.quiet().nothrow() } } finally { // Always restore original branch if (branch) { await $`git checkout ${branch.replace("refs/heads/", "")}`.quiet().nothrow() } else { await $`git checkout ${originalHead}`.quiet().nothrow() } } return learned } /** * Return files that git rerere has already auto-resolved. * These files no longer have conflict markers but haven't been staged yet * (unless rerere.autoupdate is true, in which case they're already staged). */ export async function getRerereResolved(): Promise { const result = await $`git rerere status`.quiet().nothrow() if (result.exitCode !== 0 || !result.stdout.toString().trim()) return [] return result.stdout .toString() .trim() .split("\n") .filter((f) => f.length > 0) }