muxtools.utils.binaries.sanitization

def resolve_installed_name(name: str, items: Sequence[dict[str, Any]], catalog: dict[str, Any] | None = None) -> str:
    """Resolve an executable alias using the catalog or installed metadata."""
    if catalog:
        try:
            return resolve_name(name, catalog)
        except ValueError:
            pass
    providers = {item["name"] for item in items if item["name"] == name or name in item.get("binaries", {})}
    return min(providers, key=lambda value: (len(value), value)) if providers else name

def managed_install_directory(root: Path, item: dict[str, Any]) -> Path:
    """Validate a metadata entry before removing its installation directory."""
    directory = Path(item["_path"])
    if directory.parent.parent != root or (directory.parent.name, directory.name) != (item.get("name"), item.get("version")):
        raise ValueError(f"Unsafe installed binary path: {directory}")
    if directory.parent.is_symlink() or directory.is_symlink() or not directory.is_dir():
        raise ValueError(f"Unsafe installed binary path: {directory}")
    return directory