Docs (architecture, decisions, coupling, determinism, UI, references), code rules enforced by tools/limits, deterministic core with units, time, math, sched, snapshot, vec and rng, plus smoke tests. ref/ stays out of git.
1.6 KiB
1.6 KiB
Плагины деталей
Деталь это данные (RON) плюс при необходимости плагин (Rust-код).
Правила до версии 1.0
- Только статическая регистрация через Rust API при сборке. Динамические библиотеки не поддерживаем.
- Идентификатор
автор.имяи версия semver. Зависимости от других плагинов и от версии ядра объявляются явно; несовместимость это ошибка загрузки. - Плагин получает доступ только к трейтам подсистем (порты: механический, электрический, тепловой), а не к их внутренним данным.
- Состояние плагина сериализуется через serde и входит в подснимок; после загрузки снимка плагин восстанавливается из него.
- Плагин детерминирован и подчиняется правилам DETERMINISM.md.
Жизненный цикл
register → validate (данные и версии) → instantiate (на сцену) → step (по
периоду) → snapshot и restore → drop.
Стабильность
Проект публичный, но до версии 0.6.0 API плагинов может ломаться без предупреждения (D26). К 0.6.0 API стабилизируется и дальше подчиняется semver.