diff --git a/engine/macos-arm64/terrain_3d/bin/libterrain.macos.debug.framework/_CodeSignature/CodeResources b/engine/macos-arm64/terrain_3d/bin/libterrain.macos.debug.framework/_CodeSignature/CodeResources
new file mode 100644
index 0000000..82736c8
--- /dev/null
+++ b/engine/macos-arm64/terrain_3d/bin/libterrain.macos.debug.framework/_CodeSignature/CodeResources
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3de9ed42ab92f66b2c6033b59ccfa441b1d050c319daeeb557551b4da513147e
+size 1716
diff --git a/engine/macos-arm64/terrain_3d/bin/libterrain.macos.debug.framework/libterrain.macos.debug b/engine/macos-arm64/terrain_3d/bin/libterrain.macos.debug.framework/libterrain.macos.debug
new file mode 100755
index 0000000..aae9c72
--- /dev/null
+++ b/engine/macos-arm64/terrain_3d/bin/libterrain.macos.debug.framework/libterrain.macos.debug
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:653a16ffdc3e6bb05cf514b9700c943c8694133e28ec65800d074c58c13ea216
+size 1683648
diff --git a/engine/macos-arm64/terrain_3d/bin/libterrain.macos.release.framework/_CodeSignature/CodeResources b/engine/macos-arm64/terrain_3d/bin/libterrain.macos.release.framework/_CodeSignature/CodeResources
new file mode 100644
index 0000000..82736c8
--- /dev/null
+++ b/engine/macos-arm64/terrain_3d/bin/libterrain.macos.release.framework/_CodeSignature/CodeResources
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3de9ed42ab92f66b2c6033b59ccfa441b1d050c319daeeb557551b4da513147e
+size 1716
diff --git a/engine/macos-arm64/terrain_3d/bin/libterrain.macos.release.framework/libterrain.macos.release b/engine/macos-arm64/terrain_3d/bin/libterrain.macos.release.framework/libterrain.macos.release
new file mode 100644
index 0000000..1aa6631
--- /dev/null
+++ b/engine/macos-arm64/terrain_3d/bin/libterrain.macos.release.framework/libterrain.macos.release
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ca16b2a6afa80c382ffd578ebb6b31ce456a251ef8642e7d1addba79ef51d564
+size 1268560
diff --git a/manifest.json b/manifest.json
index 2b63fe4..57e6498 100644
--- a/manifest.json
+++ b/manifest.json
@@ -11,7 +11,7 @@
       "built_by": "Kraken (local build — pipeline not yet trusted/verified)",
       "toolchain": "Xcode 26.3 (Apple clang 17)",
       "scons_flags": "platform=macos target=editor arch=arm64 module_mono_enabled=yes vulkan",
-      "note": "Editor binary only, built from the squashed-history engine (de00a30). .NET assemblies (GodotSharp) + the Terrain3D addon are provided by the game project. Run with the existing ariki-game project."
+      "note": "Editor binary only, built from the squashed-history engine (de00a30). .NET assemblies (GodotSharp) are provided by the game project. Terrain3D macOS frameworks ship HERE (see terrain_3d below) — they are gitignored in the game repo. Run with the existing ariki-game project."
     },
     "windows-x64": {
       "binary": "engine/windows-x64/tinqs.windows.editor.x86_64.mono.exe",
@@ -27,5 +27,21 @@
       "scons_flags": "platform=windows target=editor module_mono_enabled=yes",
       "note": "Branded editor binary (Tinqs app icon/splash/logos baked in). Built from engine 67d0322. .NET assemblies (GodotSharp) + the Terrain3D addon are provided by the game project. Run with the existing ariki-game project. console_binary = the .console.exe variant for terminal stdout."
     }
+  },
+  "terrain_3d": {
+    "macos-arm64": {
+      "debug_framework": "engine/macos-arm64/terrain_3d/bin/libterrain.macos.debug.framework",
+      "release_framework": "engine/macos-arm64/terrain_3d/bin/libterrain.macos.release.framework",
+      "sha256_debug": "653a16ffdc3e6bb05cf514b9700c943c8694133e28ec65800d074c58c13ea216",
+      "sha256_release": "ca16b2a6afa80c382ffd578ebb6b31ce456a251ef8642e7d1addba79ef51d564",
+      "engine_repo": "tinqs/engine",
+      "engine_commit": "bb8fe2f",
+      "built_against_engine_binary": "de00a306c (ABI via dumped extension_api.json — engine binary itself UNCHANGED, keep using de00a30)",
+      "built_on": "2026-06-09",
+      "built_by": "Kraken (engine/terrain3d/build.sh — dump API, scons editor+release, ad-hoc sign)",
+      "fix": "get_height no longer returns NaN at region borders (bilerp corners crossing a missing neighbor region propagated NaN for valid positions — the NaN-on-saved-.res bug the game shimmed around). Hole semantics unchanged.",
+      "install": "cp -R engine/macos-arm64/terrain_3d/bin/libterrain.macos.*.framework <ariki-game>/addons/terrain_3d/bin/ — the game's .gitignore (bin/) means these never come from game git on macOS.",
+      "note": "GDExtension only — no engine rebuild needed or performed. Verified: ariki-game itest 70/70 with these frameworks loaded."
+    }
   }
 }