Initial commit: architecture docs and headless engineering proof

Aeternalis Evolution, a custom-engine persistent evolutionary MMO.

This first commit establishes the project skeleton:

- Architecture and design docs: project vision, system overview,
  engineering constitution, roadmap, 19 ADRs, and the simulation,
  world, network, persistence and infrastructure architectures.
- Headless engineering proof: deterministic synthetic particles,
  component lifecycle, explicit PRNG streams, canonical snapshots
  and restored execution.
- Build and tooling: CMake 3.28+ / Ninja presets, C++23 feature
  check, clang-format and clang-tidy config, format check script,
  Windows check script, and a Docker build context.
- Tests: unit tests, benchmarks, a snapshot fuzz target and CLI
  integration wiring.

No gameplay, renderer, network service or running deployment yet.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
dingo
2026-09-14 15:44:41 -04:00
co-authored by Claude Opus 5
commit d5b4bd068e
63 changed files with 3531 additions and 0 deletions
+14
View File
@@ -0,0 +1,14 @@
if(NOT FORMATTER OR NOT EXISTS "${FORMATTER}")
message(FATAL_ERROR "clang-format major 19 is required for format-check")
endif()
execute_process(COMMAND "${FORMATTER}" --version OUTPUT_VARIABLE version RESULT_VARIABLE result)
if(NOT result EQUAL 0 OR NOT version MATCHES "version 19\\.")
message(FATAL_ERROR "Expected clang-format major 19, got ${version}")
endif()
file(GLOB_RECURSE sources
"${SOURCE_ROOT}/include/*.hpp" "${SOURCE_ROOT}/src/*.cpp"
"${SOURCE_ROOT}/apps/*.cpp" "${SOURCE_ROOT}/tests/*.cpp")
execute_process(COMMAND "${FORMATTER}" --dry-run --Werror ${sources} RESULT_VARIABLE result)
if(NOT result EQUAL 0)
message(FATAL_ERROR "Formatting check failed")
endif()
+44
View File
@@ -0,0 +1,44 @@
param(
[ValidateSet('debug', 'release', 'analysis', 'asan', 'tsan')]
[string]$Preset = 'debug',
[ValidateSet('configure', 'build', 'test', 'format', 'check')]
[string]$Action = 'check'
)
$ErrorActionPreference = 'Stop'
$repositoryRoot = Split-Path -Parent $PSScriptRoot
$vswherePath = Join-Path ${env:ProgramFiles(x86)} 'Microsoft Visual Studio\Installer\vswhere.exe'
if (!(Test-Path -LiteralPath $vswherePath)) { throw 'Visual Studio Installer/vswhere is required' }
$visualStudioRoot = & $vswherePath -latest -version '[17.0,18.0)' -products '*' -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath
if (!$visualStudioRoot) { throw 'Visual Studio 2022 C++ build tools are required' }
$developerScript = Join-Path $visualStudioRoot 'Common7\Tools\VsDevCmd.bat'
# cmd only initializes compiler environment; all filesystem work stays in PowerShell/CMake.
$environmentCommand = 'call "{0}" -no_logo -arch=x64 -host_arch=x64 && set' -f $developerScript
$environmentLines = & $env:ComSpec /d /c $environmentCommand
if ($LASTEXITCODE -ne 0) { throw 'Visual Studio environment initialization failed' }
foreach ($line in $environmentLines) {
if ($line -match '^([^=]+)=(.*)$') {
[Environment]::SetEnvironmentVariable($matches[1], $matches[2], 'Process')
}
}
$cmakeRoot = Join-Path $visualStudioRoot 'Common7\IDE\CommonExtensions\Microsoft\CMake'
$llvmRoot = Join-Path $visualStudioRoot 'VC\Tools\Llvm\x64\bin'
$env:Path = "$cmakeRoot\CMake\bin;$cmakeRoot\Ninja;$llvmRoot;$env:Path"
Push-Location -LiteralPath $repositoryRoot
try {
if ($Action -in @('configure', 'check')) {
& cmake --preset $Preset
if ($LASTEXITCODE -ne 0) { throw 'CMake configure failed' }
}
if ($Action -in @('build', 'check')) {
& cmake --build --preset $Preset
if ($LASTEXITCODE -ne 0) { throw 'Build failed' }
}
if ($Action -in @('test', 'check')) {
& ctest --preset $Preset
if ($LASTEXITCODE -ne 0) { throw 'Tests failed' }
}
if ($Action -eq 'format') {
& cmake --build --preset $Preset --target format-check
if ($LASTEXITCODE -ne 0) { throw 'Formatting check failed' }
}
} finally { Pop-Location }