diff --git a/lib/file_io.h b/lib/file_io.h
index 0964a5c8..27fd7eb5 100644
--- a/lib/file_io.h
+++ b/lib/file_io.h
@@ -1,5 +1,5 @@
 /* file_io — синхронные файловые операции: UTF-8 пути, идентичность и публикация через соседний temp.
- * inspect: 0 найден, 1 отсутствует, -1 ошибка; остальные операции 0/-1, paths также 1 для одного файла.
+ * inspect различает найденный/отсутствующий файл и ошибку; paths сравнивает идентичность файлов.
  * Temp обнулить → open → писать в file → finish → publish; discard обязателен также при ошибке.
  * Активный temp автоматически защищён от remove_orphan во всех потоках до publish/discard, включая время после finish.
  * Пока temp активен, структуру нельзя копировать/перемещать; с одним temp работает один владелец.