Function resolveRemoteSymlinks

pkg/parser/remote_fetch.go:795–820

resolveRemoteSymlinks resolves symlinks in a remote GitHub repository path. The GitHub Contents API doesn't follow symlinks in path components. For example, if .github/workflows/shared is a symlink to ../../gh-agent-workflows/shared, fetching .github/workflows/shared/elastic-tools.md returns 404. Th

(client *api.RESTClient, owner, repo, filePath, ref string)

// This function walks the path components and resolves any symlinks found.
// The caller must provide a REST client (already authenticated for the correct host).
func resolveRemoteSymlinks(client *api.RESTClient, owner, repo, filePath, ref string) (string, error) {
	parts := strings.Split(filePath, "/")
	if len(parts) <= 1 {
		return "", fmt.Errorf("no directory components to resolve in path: %s", filePath)
	}

	if client == nil {
		return "", fmt.Errorf("no REST client available for symlink resolution of %s/%s/%s@%s", owner, repo, filePath, ref)
	}

	remoteLog.Printf("Attempting symlink resolution for %s/%s/%s@%s (%d path components)", owner, repo, filePath, ref, len(parts))

	for i := 1; i < len(parts); i++ {
		dirPath := strings.Join(parts[:i], "/")
		resolvedPath, found, err := resolveRemoteSymlinkComponent(client, owner, repo, filePath, ref, parts, i, dirPath)
		if err != nil {
			return "", err
		}
		if found {
			return resolvedPath, nil
		}
	}

	remoteLog.Printf("No symlinks found after checking all %d directory components of %s", len(parts)-1, filePath)
	return "", fmt.Errorf("no symlinks found in path: %s", filePath)
}

func resolveRemoteSymlinkComponent(
	client *api.RESTClient,