docs: добавь поясняющие комментарии к модулям и инструментам

python/firmware_image/__init__.py

@@ -1,2 +1,6 @@
+# Входная точка пакета firmware_image. Определяет доступные при импорте имена; подробные
+# контракты находятся в специализированных модулях пакета. Изменение реэкспортов влияет на
+# существующие import у потребителей.
+
 """Shared firmware images and flash layout plans."""
 from .core import *

python/firmware_image/core.py

@@ -1,3 +1,7 @@
+# Проверка Intel HEX и подготовка адресованного образа прошивки. Контрольные суммы записей,
+# расширенные адреса и пересечения проверяются до использования результата; рабочая память
+# C-парсера принадлежит вызывающему.
+
 """Переносимое ядро проверки образа прошивки STM32.
 
 Модуль не знает ни про HTTP, ни про Modbus, ни про файловую систему, ни про

python/firmware_image/native.py

@@ -1,3 +1,8 @@
+# Проверка Intel HEX и подготовка адресованного образа прошивки. Контрольные суммы записей,
+# расширенные адреса и пересечения проверяются до использования результата; рабочая память
+# C-парсера принадлежит вызывающему. Python-слой предоставляет модели и ctypes-вызовы без
+# резервного парсера на Python.
+
 """Models for the C99 Intel HEX parser. No Python parser fallback."""
 import ctypes as ct
 from functools import lru_cache