Git designed for AI agents.
package git
import (
"context"
"fmt"
"os"
"path/filepath"
"strings"
"github.com/feder-cr/git-ai/internal/log"
)
// alternateOutsideStorageError is returned when an alternates file contains an
// alternate which is not within the storage's root.
type alternateOutsideStorageError string
func (path alternateOutsideStorageError) Error() string {
return fmt.Sprintf("alternate %q is outside the storage root", string(path))
}
// ObjectDirectories looks for Git object directories, including
// alternates specified in objects/info/alternates.
//
// CAVEAT Git supports quoted strings in here, but we do not. We should
// never need those on a Gitaly server.
func ObjectDirectories(ctx context.Context, logger log.Logger, storageRoot, repoPath string) ([]string, error) {
objDir := filepath.Join(repoPath, "objects")
return altObjectDirs(ctx, logger, storageRoot+string(os.PathSeparator), objDir, 0)
}
// AlternateObjectDirectories reads the alternates file of the repository and returns absolute paths
// to its alternate object directories, if any. The returned directories are verified to exist and that
// they are within the storage root. The alternate directories are returned recursively, not only the
// immediate alternates.
func AlternateObjectDirectories(ctx context.Context, logger log.Logger, storageRoot, repoPath string) ([]string, error) {
dirs, err := ObjectDirectories(ctx, logger, storageRoot, repoPath)
if err != nil {
return nil, err
}
// first directory is the repository's own object dir
return dirs[1:], nil
}
func altObjectDirs(ctx context.Context, logger log.Logger, storagePrefix, objDir string, depth int) ([]string, error) {
const maxAlternatesDepth = 5 // Taken from https://github.com/git/git/blob/v2.23.0/sha1-file.c#L575
if depth > maxAlternatesDepth {
logger.WithField("objdir", objDir).WarnContext(ctx, "ignoring deeply nested alternate object directory")
return nil, nil
}
fi, err := os.Stat(objDir)
if os.IsNotExist(err) {
logger.WithField("objdir", objDir).WarnContext(ctx, "object directory not found")
return nil, nil
}
if err != nil {
return nil, err
}
if !fi.IsDir() {
return nil, nil
}
dirs := []string{objDir}
alternates, err := os.ReadFile(filepath.Join(objDir, "info", "alternates"))
if os.IsNotExist(err) {
return dirs, nil
}
if err != nil {
return nil, err
}
for _, newDir := range strings.Split(string(alternates), "\n") {
if len(newDir) == 0 || newDir[0] == '#' {
continue
}
if !filepath.IsAbs(newDir) {
newDir = filepath.Join(objDir, newDir)
}
if !strings.HasPrefix(newDir, storagePrefix) {
return nil, alternateOutsideStorageError(newDir)
}
nestedDirs, err := altObjectDirs(ctx, logger, storagePrefix, newDir, depth+1)
if err != nil {
return nil, err
}
dirs = append(dirs, nestedDirs...)
}
return dirs, nil
}