diff --git a/tests/prof_cmocka.h b/tests/prof_cmocka.h
index c8561404..7d87a03c 100644
--- a/tests/prof_cmocka.h
+++ b/tests/prof_cmocka.h
@@ -1,5 +1,22 @@
+/*
+ * Compatibility header for cmocka 1.x and 2.x
+ *
+ * cmocka 2.0 (released Dec 2025) deprecated several macros:
+ * - will_return() -> will_return_int() / will_return_ptr()
+ * - mock_type() -> mock_int() / mock_ptr_type()
+ * - check_expected() -> check_expected_int() / check_expected_ptr()
+ *
+ * This header disables deprecation warnings for backward compatibility
+ * with cmocka 1.x style code.
+ */
+
 #include <stdarg.h>
+#include <stdbool.h>
 #include <stddef.h>
 #include <stdint.h>
 #include <setjmp.h>
+
+/* Disable cmocka 2.0 deprecation warnings for backward compatibility */
+#define CMOCKA_DISABLE_DEPRECATION_WARNINGS
+
 #include <cmocka.h>