Compare commits

..

No commits in common. "190ef9cc4b27f2670c60275488dbe1780010956c" and "93075ab1fd1eed4b45007c1dc230a46d15470d79" have entirely different histories.

10 changed files with 39 additions and 19 deletions

19
.github/workflows/ci.yml vendored Normal file
View file

@ -0,0 +1,19 @@
name: ci
on: [push, pull_request]
jobs:
check:
strategy:
matrix:
os: [ubuntu-latest, windows-latest, macos-latest]
runs-on: ${{ matrix.os }}
steps:
- uses: actions/checkout@v4
- uses: actions-rust-lang/setup-rust-toolchain@v1
- run: cargo run -q -p fabrilis-limits
- run: cargo fmt --all -- --check
- run: cargo clippy --workspace --all-targets -- -D warnings
- run: cargo test --workspace
- name: determinism with native target-cpu
env:
RUSTFLAGS: -C target-cpu=native
run: cargo test -p fabrilis-core --test determinism

View file

@ -14,7 +14,7 @@
| Этап | Что готово |
|---|---|
| M0 | workspace, правила кода (`tools/limits`), pre-commit |
| M0 | workspace, правила кода (`tools/limits`), pre-commit, CI |
| M1 | ядро: СИ-единицы, целое время, детерминированная математика, планировщик, снимки |
| M2 | в работе: своя векторная математика, RNG, один шарнир с мотором и датчиками |

View file

@ -5,7 +5,7 @@
Подробности: [docs/](docs/README.md).
## Готово
- **M0 — Скелет.** docs, workspace, `fabrilis-limits`, pre-commit.
- **M0 — Скелет.** docs, workspace, `fabrilis-limits`, pre-commit, CI.
- **M1 — Детерминированное ядро.** `core::units`, `core::time` (u64 нс),
`core::math` поверх `libm`, `core::sched` (эпохи, точки синхронизации),
`core::fidelity`, `core::snapshot`, `core::id`, golden-тест детерминизма.

View file

@ -52,7 +52,7 @@
Эталонная сцена — паук: 24 тела, 32 шарнира, 8 аналоговых узлов, 12 датчиков,
физика 1 кГц. Цель — RTF ≥ 1 на машине с RX 470 (AMD, 2016) при 60 кадрах.
Бюджет такта World: 0.5 мс на физику, 0.2 мс на электронику и датчики, остальное
на подготовку снимка. Бюджет проверяется бенчмарком в автоматическом прогоне; выход за него — повод
на подготовку снимка. Бюджет проверяется бенчмарком в CI; выход за него — повод
переходить на `ash` (D24) или упрощать World, но не менять шаг.
## Адаптация под устройство
@ -74,7 +74,8 @@ fabrilis/
├── tools/measure_deps.py замер веса кандидатов в зависимости
├── examples/ эталонные конструкции (первый: мех-паук)
├── ref/ клоны чужих проектов для чтения (gitignored, не проверяются)
└── .githooks/ pre-commit: правила, fmt, clippy
├── .githooks/ pre-commit: правила, fmt, clippy
└── .github/ CI на Linux, Windows, macOS
```
Слои зависимостей закодированы в `tools/limits/src/rules/layers.rs`; новый crate
нужно внести туда, иначе сборка падает.

View file

@ -10,7 +10,7 @@ CLI — это пульт управления движком и расчётн
## Зачем
- прогнать сценарий на сервере и получить CSV/отчёт;
- проверить регрессии автоматическим прогоном без дисплея;
- проверить регрессии в CI без дисплея;
- считать развёртки и Monte Carlo;
- держать один сервер физики и подключать клиентов (NETWORK.md);
- дать внешнему коду команды `open/run/step/set_actuator/read_sensor`, не встраивая
@ -35,7 +35,7 @@ CLI — это пульт управления движком и расчётн
## Гарантии
- Без GPU и окна; шаг физики фиксированный, как в мире.
- Один seed и одни входы дают один результат; golden-хеш проверяется автоматическим прогоном.
- Один seed и одни входы дают один результат; golden-хеш проверяется в CI.
- Параллельные прогоны — отдельные процессы, результат не зависит от их числа.
- Логи по LOGGING.md: обычный уровень `info`, `--dev` — `debug/trace`.
- Метрики-лог CSV и dev-лог те же, что у GUI (LOGGING.md).

View file

@ -4,7 +4,7 @@
crate `tools/limits` (`fabrilis-limits`). У каждого crate'а есть `build.rs`, который
вызывает его, поэтому **нарушение жёсткого правила ломает любую сборку**
(`cargo build`, `check`, `clippy`, `test`). Весь репозиторий проверяется командой
`cargo run -p fabrilis-limits`; она же стоит в pre-commit (`.githooks/`).
`cargo run -p fabrilis-limits`; она же стоит в pre-commit (`.githooks/`) и в CI.
Правила касаются только нашего кода. `docs/`, `*.md` и `ref/` (локальные клоны
чужих проектов, см. REFERENCES.md) не проверяются.
@ -35,7 +35,7 @@ crate `tools/limits` (`fabrilis-limits`). У каждого crate'а есть `b
быть длинным. Разносить тесты по подпапкам ради лимитов не нужно — весь модуль
тестируется одним файлом рядом.
## Проверяют rustfmt и clippy (pre-commit с `-D warnings`)
## Проверяют rustfmt и clippy (pre-commit и CI с `-D warnings`)
| Правило | Чем задано |
|---|---|
@ -137,7 +137,7 @@ crate `tools/limits` (`fabrilis-limits`). У каждого crate'а есть `b
| `float_cmp`: сравнение `f64` через допуск, а не `==` | корректная численная логика |
| Фаззинг (`cargo-fuzz`) для импорта мешей, форматов RON, декодера RISC-V | парсеры устойчивы к мусору |
| Мутационное тестирование (`cargo-mutants`) и покрытие (`cargo-llvm-cov`) для `core`, `analog`, `cpu` | тесты реально ловят ошибки |
| Порог регрессии бенчмарков в автоматическом прогоне (своя утилита замеров) | скорость не падает незаметно |
| Порог регрессии бенчмарков в CI (своя утилита замеров) | скорость не падает незаметно |
| Conventional Commits и `commit-msg` хук | читаемая история |
| Проверка, что каждый crate описан в `ARCHITECTURE.md` | документация не отстаёт |
| Лимит на число `unsafe`-блоков и место (только `cpu`, с обоснованием) | контроль рисков |

View file

@ -2,7 +2,7 @@
| # | Решение | Почему |
|---|---|---|
| D1 | Multi-crate workspace, симуляция без GPU/Bevy | тесты без окна, автоматические прогоны, детерминизм |
| D1 | Multi-crate workspace, симуляция без GPU/Bevy | тесты без окна, CI, детерминизм |
| D2 | Без Bevy; свой рендер на wgpu (Vulkan); без общего ECS, данные SoA внутри crate'ов | RX 470 слабая, нужен контроль; рендер заменяем |
| D3 | Физика: гибрид. `PhysicsBackend` + `rapier3d-f64` с `enhanced-determinism` на старте, нужное заменяем своим | быстрый старт без потери контроля и без границы f32 |
| D4 | Механика: жёсткие тела + нагрузки на шарниры (World); балки и FEM (Lab); разрушение | точность там, где нужна |
@ -34,10 +34,10 @@
| D30 | Проект публичный, но до 0.6.0 API плагинов и форматов нестабилен; обратная совместимость не обещается | ещё рано замораживать интерфейсы, а публичность задаёт планку документации |
| D31 | Углы — newtype `Radians`; градусы только в интерфейсе и при импорте | градусы и радианы иначе путаются молча |
| D32 | Очередь событий с метками в нс в планировщике: событие делит шаг подсистемы | фронты PWM и прерывания нельзя привязывать к эпохам |
| D33 | Версия компилятора зафиксирована `rust-toolchain.toml`; автоматический прогон собирает базовую и `native` сборки и сверяет хеши | разные LLVM могут разойтись в последних битах |
| D33 | Версия компилятора зафиксирована `rust-toolchain.toml`; CI собирает базовую и `native` сборки и сверяет хеши | разные LLVM могут разойтись в последних битах |
| D34 | UI — свой immediate-mode слой на нашем `wgpu`-рендере с event-driven redraw; retained-дерево только по профилировке. ShapeUI blueprint — источник контрактов, не фундамент | редактору нужны панели, дерево и графики, а не окна произвольной формы; UI-фреймворк на годы остановил бы проект |
| D35 | Логи — собственный фасад `core::log` с уровнями error/warn/info/debug/trace; приложение ставит приёмник, `--dev` включает debug/trace; логи не влияют на симуляцию | единый способ писать диагностику с первого дня, без внешних зависимостей и без влияния на детерминизм; `log`/`tracing` можно подключить позже |
| D36 | Headless CLI — пульт управления движком и расчётный инструмент, отдельным бинарником без `render`/`ui`/`winit`; общий прогон мира живёт в `modes`. Внешние скрипты, агенты и нейросети управляют командами (JSON-RPC, позже MCP), логика остаётся снаружи | один протокол для прогонов, сервера и агентов; движок остаётся симулятором, а не чужим рантаймом |
| D36 | Headless CLI — пульт управления движком и расчётный инструмент, отдельным бинарником без `render`/`ui`/`winit`; общий прогон мира живёт в `modes`. Внешние скрипты, агенты и нейросети управляют командами (JSON-RPC, позже MCP), логика остаётся снаружи | один протокол для CI, сервера и агентов; движок остаётся симулятором, а не чужим рантаймом |
## Открытые вопросы
- FEM: тетраэдры для всей детали или балки + локальные тетраэдры в узлах.

View file

@ -7,8 +7,8 @@
| Уровень | Что гарантирует | Где проверяется |
|---|---|---|
| **D1** | Повтор на той же машине, той же сборке, том же числе потоков даёт тот же результат | каждый коммит, golden-хеш |
| **D2** | То же при любом числе потоков | автоматический прогон с 1, 2, 8 и 24 потоками |
| **D3** | Разные ОС и архитектуры (Linux x86-64, Windows, macOS ARM) дают одинаковый хеш | прогон на трёх ОС, один хеш в репозитории |
| **D2** | То же при любом числе потоков | CI, прогон с 1, 2, 8 и 24 потоками |
| **D3** | Разные ОС и архитектуры (Linux x86-64, Windows, macOS ARM) дают одинаковый хеш | матрица CI, один хеш в репозитории |
D1 нужен для отладки, D2 — для параллельных развёрток, D3 — для «у меня не
воспроизводится». Гарантия относится только к авторитетному состоянию симуляции;
@ -36,7 +36,7 @@ D1 нужен для отладки, D2 — для параллельных ра
9. **Векторы**: свои `Vec3`, `Mat3`, `Quat` в `core::vec` на `f64` через `core::math`
(`glam` и `nalgebra` считают тригонометрию через системный libm).
10. **Инструменты**: версия компилятора зафиксирована `rust-toolchain.toml`;
авторитетная сборка идёт с базовым `target-cpu` (без `native`), прогон дополнительно
авторитетная сборка идёт с базовым `target-cpu` (без `native`), CI дополнительно
собирает с `native` и сверяет хеши.
11. **SIMD**: только явные ядра с фиксированным порядком операций. Обычная
автовекторизация допустима: она не меняет порядок сложений и не включает
@ -53,7 +53,7 @@ D1 и D2 для конкретной сборки; хеши физических
## Проверка
Golden-тест: хеш состояния после N тактов совпадает на Linux/Windows/macOS и при
1, 2, 8 и 24 потоках. Хеш хранится в репозитории. При расхождении прогон печатает
1, 2, 8 и 24 потоках. Хеш хранится в репозитории. При расхождении CI печатает
первую подсистему, чей подснимок разошёлся (COUPLING.md).
## Адаптация под железо (`platform`)

View file

@ -37,6 +37,6 @@
Название: Fabrilis (лат. fabrilis, «относящийся к мастеру, ремесленнику»). Автор: loki.
Статус: готовы M0 (скелет, правила) и M1 (ядро: единицы, время, математика,
Статус: готовы M0 (скелет, правила, CI) и M1 (ядро: единицы, время, математика,
планировщик, Fidelity, снимки). Дальше M2 — один шарнир: своя векторная
математика, seeded RNG, минимальная физика с мотором и датчиками.

View file

@ -20,10 +20,10 @@
6. **Форматы**: snapshot-тесты сцены и миграции версий; проверка меша до расчёта
массы (замкнутость, ориентация нормалей, единицы).
7. **Производительность**: бенчмарки горячих путей в `benches/` (`criterion` как
dev-зависимость, D26) плюс бюджет эталонной сцены в автоматическом прогоне; регрессия видна как
dev-зависимость, D26) плюс бюджет эталонной сцены в CI; регрессия видна как
падение RTF.
8. **Правила репозитория**: `fabrilis-limits` (в `build.rs` каждого crate'а,
pre-commit); тесты лежат в отдельных файлах (CODE_RULES.md).
pre-commit и CI); тесты лежат в отдельных файлах (CODE_RULES.md).
9. **Сценарии Rhai** служат функциональными тестами («подними паука, замерь нагрузку»).
Verification (правильность реализации) и validation (совпадение с реальной