Compare commits
No commits in common. "190ef9cc4b27f2670c60275488dbe1780010956c" and "93075ab1fd1eed4b45007c1dc230a46d15470d79" have entirely different histories.
190ef9cc4b
...
93075ab1fd
10 changed files with 39 additions and 19 deletions
19
.github/workflows/ci.yml
vendored
Normal file
19
.github/workflows/ci.yml
vendored
Normal 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
|
||||
|
|
@ -14,7 +14,7 @@
|
|||
|
||||
| Этап | Что готово |
|
||||
|---|---|
|
||||
| M0 | workspace, правила кода (`tools/limits`), pre-commit |
|
||||
| M0 | workspace, правила кода (`tools/limits`), pre-commit, CI |
|
||||
| M1 | ядро: СИ-единицы, целое время, детерминированная математика, планировщик, снимки |
|
||||
| M2 | в работе: своя векторная математика, RNG, один шарнир с мотором и датчиками |
|
||||
|
||||
|
|
|
|||
2
TODO.md
2
TODO.md
|
|
@ -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-тест детерминизма.
|
||||
|
|
|
|||
|
|
@ -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
|
||||
нужно внести туда, иначе сборка падает.
|
||||
|
|
|
|||
|
|
@ -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).
|
||||
|
|
|
|||
|
|
@ -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`, с обоснованием) | контроль рисков |
|
||||
|
|
|
|||
|
|
@ -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: тетраэдры для всей детали или балки + локальные тетраэдры в узлах.
|
||||
|
|
|
|||
|
|
@ -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`)
|
||||
|
|
|
|||
|
|
@ -37,6 +37,6 @@
|
|||
|
||||
Название: Fabrilis (лат. fabrilis, «относящийся к мастеру, ремесленнику»). Автор: loki.
|
||||
|
||||
Статус: готовы M0 (скелет, правила) и M1 (ядро: единицы, время, математика,
|
||||
Статус: готовы M0 (скелет, правила, CI) и M1 (ядро: единицы, время, математика,
|
||||
планировщик, Fidelity, снимки). Дальше M2 — один шарнир: своя векторная
|
||||
математика, seeded RNG, минимальная физика с мотором и датчиками.
|
||||
|
|
|
|||
|
|
@ -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 (совпадение с реальной
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue