1 files changed, 26 insertions, 4 deletions

diff --git a/include/utils.h b/include/utils.h
index 74c0ca1..08895c0 100644
--- a/include/utils.h
+++ b/include/utils.h
@@ -1,8 +1,30 @@
 #pragma once
+
+#include <stdbool.h>
 #include <stddef.h>
 
+/** Print a horizontal separator line */
 void print_line(void);
-void wait_enter(const char *msg);
-char ask_yes_no(const char *msg);
-void now_str(char *buf, size_t size);
-size_t rand_index(size_t max);
+
+/** Pause until the user presses ENTER */
+void wait_for_enter(const char* prompt);
+
+/** Ask a yes/no question and return boolean */
+bool ask_yes_no(const char* prompt);
+
+/**
+ * Get the current timestamp for recording when a question was answered
+ *
+ * @param answer_time_buffer Buffer to store the formatted timestamp
+ * @param buffer_capacity Size of the buffer in bytes
+ */
+void get_answer_timestamp(char* answer_time_buffer, size_t buffer_capacity);
+
+/**
+ * Get a random question index in the quiz (thread-safe)
+ *
+ * @param seed Pointer to an unsigned int seed (per-thread)
+ * @param total_questions Number of questions in the current quiz session
+ * @return Random index in the range [0, total_questions-1]
+ */
+size_t get_random_question_index(unsigned int* seed, size_t total_questions);