Class: RailsAiBridge::Registry::DefaultGitRunner

Inherits:
Object
  • Object
show all
Includes:
GitRunner
Defined in:
lib/rails_ai_bridge/registry/skill_source_resolver.rb

Overview

Default implementation of GitRunner using Open3 to spawn git subprocesses.

This is the production implementation used for actual git operations. All git commands are wrapped in a +Timeout::timeout+ block so a slow or unreachable remote cannot block the calling thread indefinitely.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(timeout: 30) ⇒ DefaultGitRunner

Returns a new instance of DefaultGitRunner.



55
56
57
 
# File 'lib/rails_ai_bridge/registry/skill_source_resolver.rb', line 55

def initialize(timeout: 30)
  @timeout = timeout
end

Instance Attribute Details

#timeout ⇒ Object (readonly)

Parameters:

  • timeout (Integer) —

    seconds before a git operation is forcibly interrupted



53
54
55
 
# File 'lib/rails_ai_bridge/registry/skill_source_resolver.rb', line 53

def timeout
  @timeout
end

Instance Method Details

#checkout_ref(path, ref) ⇒ void

This method returns an undefined value.

Checks out a specific git ref inside a local repository directory.

Parameters:

  • path (String) —

    path to the local repository

  • ref (String) —

    branch, tag, or commit SHA to check out

Raises:

  • (ArgumentError) —

    if ref starts with a dash (option injection guard)

  • (RuntimeError) —

    if git checkout command fails, returns non-zero, or times out



95
96
97
98
99
100
101
102
103
 
# File 'lib/rails_ai_bridge/registry/skill_source_resolver.rb', line 95

def checkout_ref(path, ref)
  raise ArgumentError, "Invalid ref #{ref.inspect}: refs must not start with '-'" if ref.start_with?('-')

  with_timeout('git checkout') do
    # The ref is validated above before being passed to git.
    _stdout, stderr, status = Open3.capture3('git', 'checkout', ref, chdir: path) # nosemgrep: ruby.lang.security.dangerous-exec.dangerous-exec
    fail_with_sanitized_error!('git checkout', stderr) unless status.success?
  end
end

#clone_repo(url, dest) ⇒ void

This method returns an undefined value.

Clones a remote repository to a local directory path.

Parameters:

  • url (String) —

    git repository URL

  • dest (String) —

    destination directory path

Raises:

  • (RuntimeError) —

    if git clone command fails, returns non-zero, or times out



65
66
67
68
69
70
71
72
73
 
# File 'lib/rails_ai_bridge/registry/skill_source_resolver.rb', line 65

def clone_repo(url, dest)
  raise ArgumentError, "Invalid git URL #{url.inspect}: URLs must not start with '-'" if url.start_with?('-')
  raise ArgumentError, "Invalid destination #{dest.inspect}: paths must not start with '-'" if dest.to_s.start_with?('-')

  with_timeout('git clone') do
    _stdout, stderr, status = Open3.capture3('git', 'clone', '--', url, dest)
    fail_with_sanitized_error!('git clone', stderr) unless status.success?
  end
end

#pull_repo(path) ⇒ void

This method returns an undefined value.

Pulls latest changes inside a local repository directory.

Parameters:

  • path (String) —

    path to the local repository

Raises:

  • (RuntimeError) —

    if git pull command fails, returns non-zero, or times out



80
81
82
83
84
85
86
 
# File 'lib/rails_ai_bridge/registry/skill_source_resolver.rb', line 80

def pull_repo(path)
  with_timeout('git pull') do
    # Command is fully static; only the chdir option is a validated directory path.
    _stdout, stderr, status = Open3.capture3('git', 'pull', chdir: path) # nosemgrep: ruby.lang.security.dangerous-exec.dangerous-exec
    fail_with_sanitized_error!('git pull', stderr) unless status.success?
  end
end