Cpp migration review base

CMakeLists.txt

@@ -0,0 +1,47 @@
+cmake_minimum_required(VERSION 3.16)
+project(diepcustom_cpp LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+
+add_library(diepcustom_protocol
+  cpp/src/protocol.cpp
+)
+
+add_library(diepcustom_physics
+  cpp/src/physics.cpp
+)
+
+add_library(diepcustom_entity_core
+  cpp/src/entity_core.cpp
+)
+
+add_library(diepcustom_gameplay
+  cpp/src/gameplay.cpp
+)
+target_include_directories(diepcustom_physics PUBLIC cpp/include)
+target_include_directories(diepcustom_protocol PUBLIC cpp/include)
+target_include_directories(diepcustom_entity_core PUBLIC cpp/include)
+target_include_directories(diepcustom_gameplay PUBLIC cpp/include)
+target_link_libraries(diepcustom_entity_core PUBLIC diepcustom_protocol)
+
+add_executable(protocol_golden_test cpp/tests/protocol_golden_test.cpp)
+target_link_libraries(protocol_golden_test PRIVATE diepcustom_protocol)
+
+add_executable(protocol_report cpp/tests/protocol_report.cpp)
+target_link_libraries(protocol_report PRIVATE diepcustom_protocol)
+
+add_executable(physics_report cpp/tests/physics_report.cpp)
+target_link_libraries(physics_report PRIVATE diepcustom_physics)
+
+add_executable(entity_core_report cpp/tests/entity_core_report.cpp)
+target_link_libraries(entity_core_report PRIVATE diepcustom_entity_core)
+
+add_executable(gameplay_report cpp/tests/gameplay_report.cpp)
+target_link_libraries(gameplay_report PRIVATE diepcustom_gameplay)
+
+enable_testing()
+add_test(NAME protocol_golden_test COMMAND protocol_golden_test)
+add_test(NAME entity_core_report_smoke COMMAND entity_core_report)
+add_test(NAME gameplay_report_smoke COMMAND gameplay_report)

README.md

@@ -14,6 +14,19 @@ After doing so, download or clone this repository and install the dependencies w
 $ npm install
 ```
 
+## C++ Migration / Headless RL Parity
+
+This repository is being migrated toward a deterministic C++ core for headless RL-agent training while the TypeScript server remains the behavior reference. See [docs/cpp-migration-status.md](./docs/cpp-migration-status.md) for the current parity harness, completed slices, verification commands, and next recommended work.
+
+Key migration commands:
+```bash
+npm run test:conformance
+npm run test:cpp
+npm run test:parity
+npm run bench:gameplay
+npm run test:all
+```
+
 ## Running the Server
 
 Run the server with:

conformance/entity-core/compare-parity.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+const assert = require('node:assert/strict');
+const { execFileSync } = require('node:child_process');
+const path = require('node:path');
+
+const root = path.join(__dirname, '../..');
+const tsReport = JSON.parse(execFileSync(process.execPath, [path.join(root, 'conformance/entity-core/report-ts.js')], { cwd: root, encoding: 'utf8' }));
+const cppReport = JSON.parse(execFileSync(path.join(root, 'build/cpp/entity_core_report'), { cwd: root, encoding: 'utf8' }));
+
+assert.deepEqual(cppReport, tsReport);
+console.log('entity-core parity report matched TypeScript reference');

conformance/entity-core/golden.test.js

@@ -0,0 +1,13 @@
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const test = require('node:test');
+const { execFileSync } = require('node:child_process');
+
+const root = path.join(__dirname, '../..');
+const fixture = JSON.parse(fs.readFileSync(path.join(root, 'conformance/fixtures/entity-core-golden.json'), 'utf8'));
+
+test('TS headless world snapshot plus minimal compatibility report matches golden fixture', () => {
+  const output = execFileSync(process.execPath, [path.join(root, 'conformance/entity-core/report-ts.js')], { cwd: root, encoding: 'utf8' });
+  assert.deepEqual(JSON.parse(output), fixture);
+});