Initial commit: Fabrilis docs, rules and deterministic core

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.
This commit is contained in:
Loki 2026-11-16 19:09:10 +01:00
commit 79928b645b
Signed by: boba
GPG key ID: 6CDE87BC9A778D97
222 changed files with 5335 additions and 0 deletions

53
tools/fetch_refs.sh Executable file
View file

@ -0,0 +1,53 @@
#!/usr/bin/env bash
# Clones reference projects into ref/ for local reading.
#
# ref/ is gitignored and exempt from repository rules. Clones are shallow: the goal
# is to read the code, not to keep history. Re-run to add missing projects; delete a
# directory to refresh it. See docs/REFERENCES.md for what to look at.
set -euo pipefail
root="$(cd "$(dirname "$0")/.." && pwd)"
dest="$root/ref"
mkdir -p "$dest"
clone() {
local repo="$1"
local name="$2"
if [ -d "$dest/$name/.git" ]; then
echo "skip $name"
return
fi
echo "clone $name"
git clone --depth 1 --single-branch --no-tags "https://github.com/$repo.git" "$dest/$name"
}
# Emulation and virtual hardware.
clone renode/renode renode
clone cnlohr/mini-rv32ima mini-rv32ima
# Physics.
clone google-deepmind/mujoco mujoco
clone jrouwe/JoltPhysics jolt
clone erincatto/box2d box2d
# FEM and structures.
clone Dhondtguido/CalculiX calculix
clone sofa-framework/sofa sofa
clone kinnala/scikit-fem scikit-fem
# Electronics.
clone ngspice/ngspice ngspice
clone sharpie7/circuitjs1 circuitjs
# World, sensors, rendering architecture.
clone gazebosim/gz-sim gazebo
# Robotics and scenarios.
clone mit-biomimetics/Cheetah-Software cheetah
clone PetoiCamp/OpenCat opencat
clone carla-simulator/scenario_runner carla-scenario-runner
# UI and data formats.
clone ocornut/imgui imgui
clone emilk/egui egui
clone openscad/openscad openscad