diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml deleted file mode 100644 index c8219cd..0000000 --- a/.github/workflows/ci.yml +++ /dev/null @@ -1,19 +0,0 @@ -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 diff --git a/README.md b/README.md index 7a435a5..593be9d 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ | Этап | Что готово | |---|---| -| M0 | workspace, правила кода (`tools/limits`), pre-commit, CI | +| M0 | workspace, правила кода (`tools/limits`), pre-commit | | M1 | ядро: СИ-единицы, целое время, детерминированная математика, планировщик, снимки | | M2 | в работе: своя векторная математика, RNG, один шарнир с мотором и датчиками | diff --git a/TODO.md b/TODO.md index a8dd923..9fd8477 100644 --- a/TODO.md +++ b/TODO.md @@ -5,7 +5,7 @@ Подробности: [docs/](docs/README.md). ## Готово -- **M0 — Скелет.** docs, workspace, `fabrilis-limits`, pre-commit, CI. +- **M0 — Скелет.** docs, workspace, `fabrilis-limits`, pre-commit. - **M1 — Детерминированное ядро.** `core::units`, `core::time` (u64 нс), `core::math` поверх `libm`, `core::sched` (эпохи, точки синхронизации), `core::fidelity`, `core::snapshot`, `core::id`, golden-тест детерминизма. diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 11a1c82..07ea01b 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -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,8 +74,7 @@ fabrilis/ ├── tools/measure_deps.py замер веса кандидатов в зависимости ├── examples/ эталонные конструкции (первый: мех-паук) ├── ref/ клоны чужих проектов для чтения (gitignored, не проверяются) -├── .githooks/ pre-commit: правила, fmt, clippy -└── .github/ CI на Linux, Windows, macOS +└── .githooks/ pre-commit: правила, fmt, clippy ``` Слои зависимостей закодированы в `tools/limits/src/rules/layers.rs`; новый crate нужно внести туда, иначе сборка падает. diff --git a/docs/CLI.md b/docs/CLI.md index 2113ecd..0a9b938 100644 --- a/docs/CLI.md +++ b/docs/CLI.md @@ -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-хеш проверяется в CI. +- Один seed и одни входы дают один результат; golden-хеш проверяется автоматическим прогоном. - Параллельные прогоны — отдельные процессы, результат не зависит от их числа. - Логи по LOGGING.md: обычный уровень `info`, `--dev` — `debug/trace`. - Метрики-лог CSV и dev-лог те же, что у GUI (LOGGING.md). diff --git a/docs/CODE_RULES.md b/docs/CODE_RULES.md index 1196115..b0ae22d 100644 --- a/docs/CODE_RULES.md +++ b/docs/CODE_RULES.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/`) и в CI. +`cargo run -p fabrilis-limits`; она же стоит в pre-commit (`.githooks/`). Правила касаются только нашего кода. `docs/`, `*.md` и `ref/` (локальные клоны чужих проектов, см. REFERENCES.md) не проверяются. @@ -35,7 +35,7 @@ crate `tools/limits` (`fabrilis-limits`). У каждого crate'а есть `b быть длинным. Разносить тесты по подпапкам ради лимитов не нужно — весь модуль тестируется одним файлом рядом. -## Проверяют rustfmt и clippy (pre-commit и CI с `-D warnings`) +## Проверяют rustfmt и clippy (pre-commit с `-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`, с обоснованием) | контроль рисков | diff --git a/docs/DECISIONS.md b/docs/DECISIONS.md index 1248040..d2d57f6 100644 --- a/docs/DECISIONS.md +++ b/docs/DECISIONS.md @@ -2,7 +2,7 @@ | # | Решение | Почему | |---|---|---| -| D1 | Multi-crate workspace, симуляция без GPU/Bevy | тесты без окна, CI, детерминизм | +| D1 | Multi-crate workspace, симуляция без GPU/Bevy | тесты без окна, автоматические прогоны, детерминизм | | 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`; CI собирает базовую и `native` сборки и сверяет хеши | разные LLVM могут разойтись в последних битах | +| D33 | Версия компилятора зафиксирована `rust-toolchain.toml`; автоматический прогон собирает базовую и `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), логика остаётся снаружи | один протокол для CI, сервера и агентов; движок остаётся симулятором, а не чужим рантаймом | +| D36 | Headless CLI — пульт управления движком и расчётный инструмент, отдельным бинарником без `render`/`ui`/`winit`; общий прогон мира живёт в `modes`. Внешние скрипты, агенты и нейросети управляют командами (JSON-RPC, позже MCP), логика остаётся снаружи | один протокол для прогонов, сервера и агентов; движок остаётся симулятором, а не чужим рантаймом | ## Открытые вопросы - FEM: тетраэдры для всей детали или балки + локальные тетраэдры в узлах. diff --git a/docs/DETERMINISM.md b/docs/DETERMINISM.md index 822c68c..15d0720 100644 --- a/docs/DETERMINISM.md +++ b/docs/DETERMINISM.md @@ -7,8 +7,8 @@ | Уровень | Что гарантирует | Где проверяется | |---|---|---| | **D1** | Повтор на той же машине, той же сборке, том же числе потоков даёт тот же результат | каждый коммит, golden-хеш | -| **D2** | То же при любом числе потоков | CI, прогон с 1, 2, 8 и 24 потоками | -| **D3** | Разные ОС и архитектуры (Linux x86-64, Windows, macOS ARM) дают одинаковый хеш | матрица CI, один хеш в репозитории | +| **D2** | То же при любом числе потоков | автоматический прогон с 1, 2, 8 и 24 потоками | +| **D3** | Разные ОС и архитектуры (Linux x86-64, Windows, macOS ARM) дают одинаковый хеш | прогон на трёх ОС, один хеш в репозитории | 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`), CI дополнительно + авторитетная сборка идёт с базовым `target-cpu` (без `native`), прогон дополнительно собирает с `native` и сверяет хеши. 11. **SIMD**: только явные ядра с фиксированным порядком операций. Обычная автовекторизация допустима: она не меняет порядок сложений и не включает @@ -53,7 +53,7 @@ D1 и D2 для конкретной сборки; хеши физических ## Проверка Golden-тест: хеш состояния после N тактов совпадает на Linux/Windows/macOS и при -1, 2, 8 и 24 потоках. Хеш хранится в репозитории. При расхождении CI печатает +1, 2, 8 и 24 потоках. Хеш хранится в репозитории. При расхождении прогон печатает первую подсистему, чей подснимок разошёлся (COUPLING.md). ## Адаптация под железо (`platform`) diff --git a/docs/README.md b/docs/README.md index db6e0d9..b9a93ce 100644 --- a/docs/README.md +++ b/docs/README.md @@ -37,6 +37,6 @@ Название: Fabrilis (лат. fabrilis, «относящийся к мастеру, ремесленнику»). Автор: loki. -Статус: готовы M0 (скелет, правила, CI) и M1 (ядро: единицы, время, математика, +Статус: готовы M0 (скелет, правила) и M1 (ядро: единицы, время, математика, планировщик, Fidelity, снимки). Дальше M2 — один шарнир: своя векторная математика, seeded RNG, минимальная физика с мотором и датчиками. diff --git a/docs/TESTING.md b/docs/TESTING.md index d256140..36cce67 100644 --- a/docs/TESTING.md +++ b/docs/TESTING.md @@ -20,10 +20,10 @@ 6. **Форматы**: snapshot-тесты сцены и миграции версий; проверка меша до расчёта массы (замкнутость, ориентация нормалей, единицы). 7. **Производительность**: бенчмарки горячих путей в `benches/` (`criterion` как - dev-зависимость, D26) плюс бюджет эталонной сцены в CI; регрессия видна как + dev-зависимость, D26) плюс бюджет эталонной сцены в автоматическом прогоне; регрессия видна как падение RTF. 8. **Правила репозитория**: `fabrilis-limits` (в `build.rs` каждого crate'а, - pre-commit и CI); тесты лежат в отдельных файлах (CODE_RULES.md). + pre-commit); тесты лежат в отдельных файлах (CODE_RULES.md). 9. **Сценарии Rhai** служат функциональными тестами («подними паука, замерь нагрузку»). Verification (правильность реализации) и validation (совпадение с реальной