fermilink.optimize.git module

fermilink.optimize.git.branch_exists(repo_dir, branch_name)[source]
Parameters:
  • repo_dir (Path)

  • branch_name (str)

Return type:

bool

fermilink.optimize.git.checkout_optimize_branch(repo_dir, *, branch_name)[source]
Parameters:
  • repo_dir (Path)

  • branch_name (str)

Return type:

dict[str, str | bool | None]

fermilink.optimize.git.clean_worker_untracked(worker_repo_dir)[source]
Parameters:

worker_repo_dir (Path)

Return type:

None

fermilink.optimize.git.cleanup_paths(repo_dir, paths)[source]
Parameters:
  • repo_dir (Path)

  • paths (list[str])

Return type:

None

fermilink.optimize.git.cleanup_stale_temporary_optimize_agents(repo_dir)[source]

Remove stale temporary AGENTS artifacts left by interrupted optimize turns.

Parameters:

repo_dir (Path)

Return type:

list[str]

fermilink.optimize.git.commit_paths(repo_dir, *, paths, message)[source]
Parameters:
  • repo_dir (Path)

  • paths (list[str])

  • message (str)

Return type:

str

fermilink.optimize.git.current_branch(repo_dir)[source]
Parameters:

repo_dir (Path)

Return type:

str | None

fermilink.optimize.git.ensure_clean_repo(repo_dir, *, allow_dirty)[source]
Parameters:
  • repo_dir (Path)

  • allow_dirty (bool)

Return type:

None

fermilink.optimize.git.ensure_local_excludes(repo_dir, patterns)[source]
Parameters:
  • repo_dir (Path)

  • patterns (list[str])

Return type:

None

fermilink.optimize.git.ensure_worker_worktree(repo_dir, *, controller_branch, start_commit=None)[source]
Parameters:
  • repo_dir (Path)

  • controller_branch (str)

  • start_commit (str | None)

Return type:

dict[str, str | bool]

fermilink.optimize.git.head_sha(repo_dir)[source]
Parameters:

repo_dir (Path)

Return type:

str

fermilink.optimize.git.inspect_worker_git_metadata(worker_repo_dir)[source]
Parameters:

worker_repo_dir (Path)

Return type:

dict[str, str | bool]

fermilink.optimize.git.list_changed_paths(repo_dir)[source]
Parameters:

repo_dir (Path)

Return type:

list[dict[str, str]]

fermilink.optimize.git.list_untracked_paths(repo_dir)[source]
Parameters:

repo_dir (Path)

Return type:

list[str]

fermilink.optimize.git.reset_to_commit(repo_dir, *, commit_sha, cleanup_paths_list)[source]
Parameters:
  • repo_dir (Path)

  • commit_sha (str)

  • cleanup_paths_list (list[str])

Return type:

None

fermilink.optimize.git.reset_worker_to_commit(worker_repo_dir, *, commit_sha)[source]
Parameters:
  • worker_repo_dir (Path)

  • commit_sha (str)

Return type:

None

fermilink.optimize.git.restore_worker_git_metadata(worker_repo_dir)[source]
Parameters:

worker_repo_dir (Path)

Return type:

bool

fermilink.optimize.git.run_git(repo_dir, args, *, check=True, capture_output=True)[source]
Parameters:
  • repo_dir (Path)

  • args (list[str])

  • check (bool)

  • capture_output (bool)

Return type:

CompletedProcess[str]

fermilink.optimize.git.temporary_optimize_agents(repo_dir, *, provider, content)[source]
Parameters:
  • repo_dir (Path)

  • provider (str)

  • content (str)

fermilink.optimize.git.with_worker_git_disabled(worker_repo_dir)[source]
Parameters:

worker_repo_dir (Path)

fermilink.optimize.git.worker_branch_name(controller_branch)[source]
Parameters:

controller_branch (str)

Return type:

str

fermilink.optimize.git.worker_worktree_path(repo_dir, *, controller_branch)[source]
Parameters:
  • repo_dir (Path)

  • controller_branch (str)

Return type:

Path