From 63d6094c9412808730ef5d8043a096c655ae901a Mon Sep 17 00:00:00 2001
From: Meta Vens <rwvens@hotmail.com>
Date: Wed, 26 Aug 2026 17:47:06 +0200
Subject: [PATCH] Clarify CultMath and CultGeometry ownership

---
 packages/cultmath/README.md     | 16 ++++++++--------
 src/GameCult.Geometry/README.md |  6 +++++-
 2 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/packages/cultmath/README.md b/packages/cultmath/README.md
index edd24d37..8fd3888c 100644
--- a/packages/cultmath/README.md
+++ b/packages/cultmath/README.md
@@ -83,7 +83,7 @@ cargo build --release --manifest-path packages/cultmath/native/cultmath-core/Car
 ## Unity package
 
 CultMath's Unity 2021.3 surface is the tracked precompiled package at
-`unity/org.gamecult.cultmath`. Unity consumes `CultMath.dll` and the numeric
+`packages/cultmath/unity/org.gamecult.cultmath`. Unity consumes `CultMath.dll` and the numeric
 `CultMath.hlsl`; it does not compile the repository's current-language C# source
 tree and does not require a consumer `csc.rsp` workaround.
 
@@ -92,22 +92,22 @@ tree and does not require a consumer `csc.rsp` workaround.
 ```
 
 The repository root is not a Unity package. Build the tracked package with
-`scripts/build-unity-package.ps1`; the script fresh-builds the netstandard2.1
+`packages/cultmath/scripts/build-unity-package.ps1`; the script fresh-builds the netstandard2.1
 assembly and rejects stale binaries, missing metadata, unexpected assemblies,
 or leaked C# source.
 
 ## Shader Tooling
 
-CultMath keeps portable DXC outside git under `.tools/`:
+CultMath keeps portable DXC outside git under `packages/cultmath/.tools/`:
 
 ```powershell
-.\tools\get-dxc.ps1
-.\tools\get-spirv-cross.ps1
-.\tools\compile-hlsl-spirv.ps1 `
+.\packages\cultmath\tools\get-dxc.ps1
+.\packages\cultmath\tools\get-spirv-cross.ps1
+.\packages\cultmath\tools\compile-hlsl-spirv.ps1 `
   -ShaderPath E:\Projects\Odin\crates\muninn-move-tracker\shaders\MoveSphereCandidate.comp.hlsl `
   -OutputPath E:\Projects\Odin\crates\muninn-move-tracker\artifacts\shader\MoveSphereCandidate.comp.spv `
-  -IncludePath E:\Projects\CultMath\shaders
-.\tools\compile-spirv-metal.ps1 `
+  -IncludePath E:\Projects\CultLib\packages\cultmath\shaders
+.\packages\cultmath\tools\compile-spirv-metal.ps1 `
   -SpirvPath E:\Projects\Odin\crates\muninn-move-tracker\artifacts\shader\MoveSphereCandidate.comp.spv `
   -OutputPath E:\Projects\Odin\crates\muninn-move-tracker\artifacts\shader\MoveSphereCandidate.comp.metal
 ```
diff --git a/src/GameCult.Geometry/README.md b/src/GameCult.Geometry/README.md
index 1ea60768..2d12dc25 100644
--- a/src/GameCult.Geometry/README.md
+++ b/src/GameCult.Geometry/README.md
@@ -7,6 +7,10 @@ package and namespace identity.
 the CultCache-native documents that carry their domains, build requests,
 selected cuts, and mesh chunk artifacts.
 
+It is the schema authority for the shared `CultGeometry*` records.
+`GameCult.Geometry.Csg` owns CSG production behavior and proves wire parity
+against those records; it does not independently evolve their identities.
+
 Its first engine-neutral algorithm is `CultGeometryIsoSurface.Extract`, a
 marching-tetrahedra extractor over regular scalar grids. It uses CultMath for
 numeric primitives and emits `CultGeometryTriangleMesh`; Godot, Unity, native
@@ -63,7 +67,7 @@ using var node = await CultMesh.CreateNodeAsync("ragnarok-geometry.ccmp", new Cu
 {
     DatabaseOptions = new CultNetDatabaseOptions
     {
-        RuntimeId = "unity-runtime",
+        RuntimeId = "godot-runtime",
         DocumentRegistry = geometryDocuments
     }
 });