Module git_util 

Enums

BranchClass

Classification of a local branch relative to its origin counterpart.

MidMergeState

Describes which incomplete git operation is in progress. Presence of the corresponding marker file/directory under .git/ is definitive — git creates these for the duration of the operation and removes them on commit or abort.

Functions

branch_tip

Get the commit SHA at the tip of a local branch.

check_leaked_files

Returns the list of files that are both modified on ticket_branch (since its merge-base with target_branch) AND dirty (uncommitted) in the target worktree. Returns an empty Vec when the check cannot be performed (no shared history, target worktree not found on disk).

classify_branch

Classify local branch relative to remote ref using SHA equality and directed ancestry.

commit

commit_files_to_branch

Commit multiple files to a branch in a single commit without disturbing the working tree.

commit_to_branch

Commit a file to a specific branch without disturbing the current working tree.

content_merged_into_main

Detect whether a ticket branch’s implementation content has been merged into main_ref even when state-transition commits (touching only files under tickets_dir/) were pushed to the branch after the merge.

create_branch_at

Create a local branch pointing at a specific commit SHA.

current_branch

delete_local_branch

delete_remote_branch

Delete a remote branch on origin.

detect_mid_merge_state

Detect whether the repo is in a mid-merge, mid-rebase, or mid-cherry-pick state.

fetch_all

fetch_branch

git_config_get

has_commits

has_remote

is_ancestor

Check if commit is a git ancestor of of_ref (i.e. reachable from of_ref). Uses git merge-base --is-ancestor.

is_file_tracked

is_worktree_dirty

list_files_on_branch

List all files in a directory on a branch (non-recursive).

list_remote_ticket_branches

Authoritative list of remote ticket branch names via git ls-remote. Unlike local remote-tracking refs (which can be stale or pruned), this queries origin directly. Returns an empty set on any error (no remote, network failure, etc.) so callers treat it as “no remote branches” and skip remote deletions safely.

local_branch_exists

main_worktree_root

merge_base

Run git merge-base ref1 ref2 and return the common ancestor SHA.

merge_branch_into_default

merge_into_default

merge_ref

merged_into_main

ticket/* branches that are merged into the default branch (remote or local), including branches that were squash-merged (not detected by --merged).

move_files_on_branch

Move files on a branch in a single commit. Each element of moves is (old_rel_path, new_rel_path, content). Writes each new file, stages it, then removes each old file via git rm. Uses the same permanent-worktree / temp-worktree pattern as commit_files_to_branch.

prune_remote_tracking

pull_default

push_branch

push_branch_tracking

push_ticket_branches

Push all local ticket/* branches that have commits not yet on origin. Non-fatal: logs warnings on push failure. No-op when no origin is configured.

read_from_branch

Read a file’s content from a branch ref without changing working tree. Prefers the local ref (reflects recent commits before push); falls back to origin when no local ref exists.

remote_branch_tip

Get the commit SHA at the tip of the remote tracking ref for a branch.

remote_ticket_branches_with_dates

Merge branch into default_branch (fast-forward or merge commit). Pushes default_branch to origin when a remote exists. List remote ticket/* branches with their last commit date. Returns (branch_name_without_origin_prefix, commit_date) pairs.

resolve_branch_sha

Resolve a branch name to a commit SHA. Prefers origin/<branch>; falls back to local <branch>.

stage_files

sync_default_branch

Bring local default branch into sync with origin/<default> without ever pushing.

sync_non_checked_out_refs

Sync non-checked-out ticket/* and epic/* local refs with their origin counterparts.

ticket_branches

All ticket/* branch names visible locally or remotely (deduplicated). Local branches are included even when a remote exists, so that unpushed branches (e.g. just created) are visible without a push.