Module scanner 

Repository and unmerged-branch discovery via git shell-out. Design decision: shell-out (not git2/gix) — simple and debuggable; the product performance bottleneck is the LLM, not git.

Structs

OpenLoop

An open loop: an unmerged branch with its own commits.

RepoCandidate

A git repository discovered under a configured root (deduped by common-dir).

ScanOptions

Options controlling a scan (light phase always; heavy phase optional + memoised).

WorktreeEntry

One entry from git worktree list --porcelain.

Functions

commit_window

Time window of the branch-exclusive commits.

default_branch

Default branch: origin/HEAD’s target if it resolves locally; otherwise main; otherwise master.

diffstat

Diffstat of the branch against the base (for the distillation prompt).

find_repos

Walks roots up to scan_depth looking for git repo candidates, then deduplicates by absolute --git-common-dir.

find_repos_cached

Like find_repos but optionally consults index to skip git rev-parse for already-known paths (resolves #17).

git_common_dir

Absolute path of the git common-dir for path (bare store / .git dir).

git_log

Branch-exclusive commits relative to the default (for the distillation prompt).

open_loops

Returns all unmerged branches (except default) in a repo, optionally reading and updating the inventory memo for ahead/behind.

open_loops_indexed

Like open_loops but optionally consults a SQLite index for the refs-fingerprint gate (#13).

parse_worktree_porcelain

Parses git worktree list --porcelain into entries.

refs_fingerprint

Cheap fingerprint of a repo’s refs: the MAX mtime (unix nanoseconds since the epoch) of <common_dir>/HEAD, <common_dir>/packed-refs (when present), the newest entry anywhere under the <common_dir>/refs tree, and the newest entry anywhere under the <common_dir>/worktrees/ tree. Missing files or directories contribute 0.

repo_name_from_common_dir

Derives a stable repo name from the absolute git common-dir (§5 of Spec Fase A).

repo_name_hint

Path-based repo name guess when git rev-parse --git-common-dir fails. Primary naming comes from common-dir during dedup; this is the error fallback only.

scan

Scans all repos found under the roots in parallel.

scan_indexed

Like scan but optionally consults a SQLite index for the refs-fingerprint gate (#13) and to cache --git-common-dir during repo discovery.

worktree_map

Maps each checked-out branch to the absolute path of its worktree.