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:
@@ -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()
|
||||
@@ -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 }
|
||||
Reference in New Issue
Block a user