Git designed for AI agents.
package localrepo
import (
"context"
"fmt"
"os"
"path/filepath"
"strings"
"github.com/feder-cr/git-ai/internal/gitaly/storage"
"github.com/feder-cr/git-ai/internal/structerr"
)
// Path returns the on-disk path of the repository.
func (repo *Repo) Path(ctx context.Context) (string, error) {
return repo.locator.GetRepoPath(ctx, repo)
}
// PathWithoutVerification returns the on-disk path of the repository without verifying that it is a
// valid Git directory. Use it only where the repository may legitimately be in an invalid state,
// such as when repairing one; Path is the right choice everywhere else.
func (repo *Repo) PathWithoutVerification(ctx context.Context) (string, error) {
return repo.locator.GetRepoPath(ctx, repo, storage.WithRepositoryVerificationSkipped())
}
// ObjectDirectoryPath returns the full path of the object directory. The errors returned are gRPC
// errors with relevant error codes and should be passed back to gRPC without further decoration.
func (repo *Repo) ObjectDirectoryPath(ctx context.Context) (string, error) {
repoPath, err := repo.Path(ctx)
if err != nil {
return "", err
}
objectDirectoryPath := repo.GetGitObjectDirectory()
if objectDirectoryPath == "" {
return "", structerr.NewInvalidArgument("object directory path is not set")
}
storagePath, err := repo.locator.GetStorageByName(ctx, repo.GetStorageName())
if err != nil {
return "", fmt.Errorf("get storage by name: %w", err)
}
// Ensure the path points somewhere in the storage.
relativeObjectDirectoryPath, err := storage.ValidateRelativePath(storagePath, filepath.Join(repoPath, objectDirectoryPath))
if err != nil {
return "", structerr.NewInvalidArgument("validate relative path: %w", err)
}
parentDir := filepath.Base(filepath.Dir(relativeObjectDirectoryPath))
baseDir := filepath.Base(relativeObjectDirectoryPath)
isTransactionQuarantineDir := (baseDir == "quarantine") || ((parentDir == "quarantine") && strings.HasPrefix(baseDir, "tmp_objdir"))
// Transactions quarantine a repository by pointing the object directory to a 'quarantine' named
// directory in the transaction's temporary directory. If the base directory is `quarantine`,
// Git push may apply an additional layer of quarantine such as `/quarantine/tmp_objdir-incoming-Gbc29N`
// so we don't assert the `/quarantine` being the last element of the path. We thus also check for
// whether the parent directory is in `quarantine` and whether the base directory has the expected
// `tmp_objdir` suffix.
if !isTransactionQuarantineDir {
// We need to check whether the relative object directory as given by the repository is
// a valid path. This may either be a path in the Git repository itself, where it may either
// point to the main object directory storage or to an object quarantine directory as
// created by git-receive-pack(1). Alternatively, if that is not the case, then it may be a
// manual object quarantine directory located in the storage's temporary directory. These
// have a repository-specific prefix which we must check in order to determine whether the
// quarantine directory does in fact belong to the repo at hand.
if _, origError := storage.ValidateRelativePath(repoPath, objectDirectoryPath); origError != nil {
tempDir, err := repo.locator.TempDir(repo.GetStorageName())
if err != nil {
return "", structerr.NewInvalidArgument("getting storage's temporary directory: %w", err)
}
expectedQuarantinePrefix := filepath.Join(tempDir, storage.QuarantineDirectoryPrefix(repo))
absoluteObjectDirectoryPath := filepath.Join(repoPath, objectDirectoryPath)
// The relative path is outside of the repository
if !strings.HasPrefix(absoluteObjectDirectoryPath, expectedQuarantinePrefix) {
return "", structerr.NewInvalidArgument("not a valid relative path: %w", origError)
}
}
}
fullPath := filepath.Join(repoPath, objectDirectoryPath)
if _, err := os.Stat(fullPath); os.IsNotExist(err) {
return "", structerr.NewNotFound("object directory does not exist: %q", fullPath)
}
return fullPath, nil
}
// InfoAlternatesPath returns the full path of the alternates file.
func (repo *Repo) InfoAlternatesPath(ctx context.Context) (string, error) {
repoPath, err := repo.Path(ctx)
if err != nil {
return "", err
}
return filepath.Join(repoPath, "objects", "info", "alternates"), nil
}