docs(doctor-triage): the mxbuild cache lane is not Linux-only on macOS (#525)

CHANGELOG.md

@@ -19,6 +19,7 @@ Sections dated before 2026-09-19 predate the cycle and stay as they are. Named m
 
 ## Unreleased
 
+- docs(doctor-triage): **the `~/.mxcli/mxbuild/` cache lane is no longer called Linux-only**: on macOS it held a working Mach-O arm64 build for 11.14.0, while 10.24 and 11.12 downloads were ELF. The lane table now says to run `file` on the cached `mx` before calling the lane unavailable (#525). — AlvinnYeo (report)
 - fix(_common): **an `export KEY=value` line in `toolkit.env` now sets KEY**: `mxtk_load_env` squeezed all whitespace out of the key, so `export MENDIX_APP=...` set a variable named `exportMENDIX_APP` and the override did nothing, although the function's own comment says that form works. `KEY = "value"` also kept its quotes (the quote strip ran before the trim); the trim now runs first. Pure bash, no extra process per line. Fixture `tests/wave2/test-common-windows.sh` case 4b (#579). — triage of #579
 - fix(exec): **a write no longer leaves units that changed only in XPath whitespace for the reviewer to read.** mxcli v0.27.0's `alter entity … rename attribute` rewrote 135 units in 20 unrelated modules that way (mendixlabs/mxcli#1596; fixed upstream in v0.29.0, ako/mxcli#1506, so this is insurance for projects on v0.27–v0.28). `exec.sh` now runs `model-scope.py restore` after the write (MDL and `--patch`) and before the mxbuild gate, so the gate checks the final model; it prints the real changes per module and puts a `scope:` note in the BUILD-LOG row. It never blocks: a failure is a warning, `MXTK_NO_SCOPE=1` skips it, and it is skipped when `FORCE_EXEC` let the write run over uncommitted model changes. No pre-commit refusal (maintainer decision on #593): `model-scope.py check --staged` stays available to run by hand. Fixture `tests/wave2/test-model-scope.sh` section F. Ported from #593 onto current master — saingge
 - learn(demo): **`skills/live-demo-autopilot.md` — run the demo live, not as a video**: Playwright drives the real app through scripted scenes, captions carry a WHY line, a control panel lets the presenter pause and take over, redo or skip; plus the traps that each broke a run (trial licence stops the runtime 2–4 h after start, 6-session cap and proving a logout freed its slot by the `System.Session` count, demo sign-in tiles kept out of any deployed build, focus-stealing panel pausing the run, SIGTERM closing the browser before sign-out). Field: a desktop+phone offline manufacturing demo (4/4 scenes) and a three-app process-hub demo (28/28 with an app killed mid-run and an 11 min pause), 2026-10 — Maurits Visser

skills/doctor-triage.md

@@ -97,13 +97,13 @@ Every mxbuild/`mx` red belongs to exactly one lane, and the fix is lane-specific
 | Lane | Where the binary comes from | Runs on | What red means |
 |---|---|---|---|
 | **Studio Pro bundled** | the install's own `modeler/mx` (`Contents/modeler/mx` on macOS, `modeler/mx.exe` on Windows) | macOS, Windows | The install is missing, or is a build that ships no bundled `mx` — list the installs and look for the file |
-| **Standalone CDN toolchain** | `mxcli setup mxbuild` / `doctor.sh --install` (add `--yes` with no terminal), cached under `~/.mxcli/mxbuild/` | **Linux only** — it is an ELF | On macOS or Windows this lane is simply unavailable; no Mendix version changes that |
+| **Standalone CDN toolchain** | `mxcli setup mxbuild` / `doctor.sh --install` (add `--yes` with no terminal), cached under `~/.mxcli/mxbuild/` | Linux; macOS only when the cached build is Mach-O | Run `file ~/.mxcli/mxbuild/<ver>/modeler/mx` first: an ELF (seen on macOS for 10.24 and 11.12) cannot run natively, a Mach-O arm64 build (seen for 11.14.0, #525) does. Windows: unverified |
 | **Container** | the same Linux toolchain, inside a container | anywhere a container runtime runs | See the limitation below before believing this one |
 
 **macOS: Mendix 11 is a platform requirement, not a toolkit preference.** macOS Studio Pro was Beta
 throughout 10.x and those builds ship **no** bundled `mx`; Mendix 11 is the first macOS build that
-carries one. So on a Mac, the bundled-`mx` lane does not exist below 11 — and the CDN lane never
-existed there at all. Verify by listing the installs and testing for the file (Step 1), **never**
+carries one. So on a Mac, the bundled-`mx` lane does not exist below 11 — and the cache lane works
+there only for a version whose cached build `file` reports as Mach-O. Verify by listing the installs and testing for the file (Step 1), **never**
 from a remembered version number: version lists rot, and two people in the 2026-09-22 thread had the
 toolkit itself checked out at two different paths.