From 4aa53c08d91107a2e175ed9a8d7fcc196ef0c1cb Mon Sep 17 00:00:00 2001
From: Alex Hope-O'Connor <alex.hope.oconnor@pomonaqld.au>
Date: Sun, 20 Sep 2026 19:43:40 +1000
Subject: [PATCH] build: share maintained ESP32 cache

---
 docs/DEVELOPMENT.md | 11 ++++++-----
 scripts/test.sh     |  2 +-
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md
index 88b0eed..0a04d87 100644
--- a/docs/DEVELOPMENT.md
+++ b/docs/DEVELOPMENT.md
@@ -23,11 +23,12 @@ note](https://github.com/alexhopeoconnor/arduino-home-assistant/blob/main/docs/E
 For the pioarduino release-to-Core mapping and cache-collision diagnosis, see
 [DeviceFramework's toolchain guide](https://github.com/alexhopeoconnor/DeviceFramework/blob/main/docs/TOOLCHAINS.md).
 
-`./scripts/test.sh` keeps the ESP32 lane in a dedicated persistent PlatformIO
-Core/cache directory by default:
-`${XDG_CACHE_HOME:-$HOME/.cache}/dfte-platformio/core-3.3.11`. That prevents a
-stale global `tool-esptoolpy` installation from shadowing the current pioarduino
-uploader. Override it with `DFTE_PLATFORMIO_CORE_DIR`,
+`./scripts/test.sh` uses the persistent PlatformIO Core/cache shared by the
+maintained framework repositories:
+`${XDG_CACHE_HOME:-$HOME/.cache}/arduino-framework-platformio/core-3.3.11`.
+All maintained ESP32 lanes pin this exact graph, avoiding repeated downloads
+while keeping stale global `tool-esptoolpy` metadata from shadowing the current
+pioarduino uploader. Override it with `DFTE_PLATFORMIO_CORE_DIR`,
 `DFTE_PLATFORMIO_PACKAGES_DIR`, and `DFTE_PLATFORMIO_CACHE_DIR` for another
 disk; the script never clears that cache or pins one compiler separately.
 
diff --git a/scripts/test.sh b/scripts/test.sh
index 510b5df..3aa03d0 100755
--- a/scripts/test.sh
+++ b/scripts/test.sh
@@ -23,7 +23,7 @@ pio_for_platform() {
     # repository-owned cache. This avoids unrelated global package metadata;
     # it is never cleared by this script.
     local core_dir packages_dir cache_dir
-    core_dir="${DFTE_PLATFORMIO_CORE_DIR:-${XDG_CACHE_HOME:-$HOME/.cache}/dfte-platformio/core-3.3.11}"
+    core_dir="${DFTE_PLATFORMIO_CORE_DIR:-${XDG_CACHE_HOME:-$HOME/.cache}/arduino-framework-platformio/core-3.3.11}"
     packages_dir="${DFTE_PLATFORMIO_PACKAGES_DIR:-$core_dir/packages}"
     cache_dir="${DFTE_PLATFORMIO_CACHE_DIR:-$core_dir/cache}"
     install -d -m 700 "$core_dir" "$packages_dir" "$cache_dir"