ReleaseKit/internal/git/path.go

package git

import (
	"context"
	"fmt"
	"path"
	"path/filepath"
	"strings"
)

// PathResolver traverses committed paths, sharing reference rules between
// release identity and validation. Lookups include both files and directories.
type PathResolver struct {
	RepositoryDir string
	Lookup        func(context.Context, string) (TreeEntry, bool, error)
	ReadLink      func(context.Context, TreeEntry) (string, error)
}

// DestinationKind classifies a committed local destination.
type DestinationKind string

const (
	DestinationEntry           DestinationKind = "entry"
	DestinationDirectory       DestinationKind = "directory"
	DestinationMissing         DestinationKind = "missing"
	DestinationOutsideCheckout DestinationKind = "outside-checkout"
	DestinationSubmodule       DestinationKind = "submodule"
	DestinationSymlinkCycle    DestinationKind = "symlink-cycle"
)

// Destination records the resolved identity and its classification.
type Destination struct {
	Kind DestinationKind
	Path string
}

// ResolveDestination resolves local destinations using the captured Git tree.
// Relative destinations start at the source directory; absolute destinations
// within the repository directory map back to committed paths.
func (resolver PathResolver) ResolveDestination(ctx context.Context, sourcePath, destination string) (Destination, error) {
	if err := ctx.Err(); err != nil {
		return Destination{}, err
	}
	directory := path.Dir(sourcePath)
	if path.IsAbs(destination) {
		relative, inside, err := resolver.relativeAbsoluteDestination(destination)
		if err != nil {
			return Destination{}, err
		}
		if !inside {
			return Destination{Kind: DestinationOutsideCheckout, Path: destination}, nil
		}
		directory, destination = ".", relative
	}
	return resolver.resolveDestination(ctx, directory, strings.Split(destination, "/"), make(map[string]bool))
}

func (resolver PathResolver) resolveDestination(ctx context.Context, directory string, components []string, active map[string]bool) (Destination, error) {
	for index, component := range components {
		if err := ctx.Err(); err != nil {
			return Destination{}, err
		}
		remaining := components[index+1:]
		switch component {
		case "", ".":
			continue
		case "..":
			if directory == "." {
				return Destination{Kind: DestinationOutsideCheckout, Path: unresolvedPath("..", remaining)}, nil
			}
			directory = path.Dir(directory)
			continue
		}
		partial := path.Join(directory, component)
		entry, exists, err := resolver.Lookup(ctx, partial)
		if err != nil {
			return Destination{}, err
		}
		if !exists {
			return Destination{Kind: DestinationMissing, Path: unresolvedPath(partial, remaining)}, nil
		}
		if entry.Type == "tree" {
			directory = partial
			continue
		}
		if entry.Mode == "160000" {
			return Destination{Kind: DestinationSubmodule, Path: unresolvedPath(partial, remaining)}, nil
		}
		if entry.Mode == "120000" {
			if active[partial] {
				return Destination{Kind: DestinationSymlinkCycle, Path: partial}, nil
			}
			linkText, err := resolver.ReadLink(ctx, entry)
			if err != nil {
				return Destination{}, fmt.Errorf("read committed symlink %q: %w", partial, err)
			}
			target := linkText
			targetDirectory := directory
			if path.IsAbs(target) {
				relative, inside, err := resolver.relativeAbsoluteDestination(target)
				if err != nil {
					return Destination{}, err
				}
				if !inside {
					return Destination{Kind: DestinationOutsideCheckout, Path: unresolvedPath(target, remaining)}, nil
				}
				targetDirectory, target = ".", relative
			}
			active[partial] = true
			destination, err := resolver.resolveDestination(ctx, targetDirectory, strings.Split(target, "/"), active)
			delete(active, partial)
			if err != nil || len(remaining) == 0 {
				return destination, err
			}
			switch destination.Kind {
			case DestinationDirectory:
				return resolver.resolveDestination(ctx, destination.Path, remaining, active)
			case DestinationEntry:
				destination.Kind = DestinationMissing
			case DestinationSymlinkCycle:
				return destination, nil
			}
			destination.Path = unresolvedPath(destination.Path, remaining)
			return destination, nil
		}
		if len(remaining) != 0 {
			return Destination{Kind: DestinationMissing, Path: unresolvedPath(partial, remaining)}, nil
		}
		return Destination{Kind: DestinationEntry, Path: partial}, nil
	}
	return Destination{Kind: DestinationDirectory, Path: directory}, nil
}

func (resolver PathResolver) relativeAbsoluteDestination(destination string) (string, bool, error) {
	root, err := filepath.Abs(resolver.RepositoryDir)
	if err != nil {
		return "", false, fmt.Errorf("resolve candidate repository directory: %w", err)
	}
	root = filepath.ToSlash(root)
	if destination == root {
		return ".", true, nil
	}
	// Preserve the suffix for component traversal, including symlinks before '..'.
	relative, inside := strings.CutPrefix(destination, strings.TrimSuffix(root, "/")+"/")
	return relative, inside, nil
}

// unresolvedPath preserves components that could not be traversed. Cleaning
// them would hide missing entries, non-directories, or checkout boundaries.
func unresolvedPath(base string, remaining []string) string {
	if len(remaining) == 0 {
		return base
	}
	return base + "/" + strings.Join(remaining, "/")
}