An Empirical Framework for Evaluating Semantic Preservation Using Hugging Face

TL;DR

This paper presents an empirical framework that leverages Hugging Face data to evaluate semantic preservation in machine learning models, helping ensure trustworthiness and detect semantic drift during model evolution.

Contribution

It introduces a large-scale dataset and a practical pipeline for assessing semantic preservation across ML model versions, supported by empirical case studies.

Findings

Semantic drift can be detected via evaluation metrics across commits

Common refactoring patterns are identified through commit message analysis

The pipeline provides a foundation for defining community standards for semantic preservation

Abstract

As machine learning (ML) becomes an integral part of high-autonomy systems, it is critical to ensure the trustworthiness of learning-enabled software systems (LESS). Yet, the nondeterministic and run-time-defined semantics of ML complicate traditional software refactoring. We define semantic preservation in LESS as the property that optimizations of intelligent components do not alter the system's overall functional behavior. This paper introduces an empirical framework to evaluate semantic preservation in LESS by mining model evolution data from HuggingFace. We extract commit histories, $\textit{Model Cards}$, and performance metrics from a large number of models. To establish baselines, we conducted case studies in three domains, tracing performance changes across versions. Our analysis demonstrates how $\textit{semantic drift}$ can be detected via evaluation metrics across commits and reveals common refactoring patterns based on commit message analysis. Although API constraints limited the possibility of estimating a full-scale threshold, our pipeline offers a foundation for defining community-accepted boundaries for semantic preservation. Our contributions include: (1) a large-scale dataset of ML model evolution, curated from 1.7 million Hugging Face entries via a reproducible pipeline using the native HF hub API, (2) a practical pipeline for the evaluation of semantic preservation for a subset of 536 models and 4000+ metrics and (3) empirical case studies illustrating semantic drift in practice. Together, these contributions advance the foundations for more maintainable and trustworthy ML systems.