From c97277b991bb3740a20e824bd9474f36b59c6592 Mon Sep 17 00:00:00 2001 From: Shay Date: Wed, 24 Jun 2026 13:44:11 -0700 Subject: [PATCH] docs(bench): record MLX experiment integration status --- .../apple-uma-mlx-exact-recall-status.md | 32 +++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 docs/benchmarks/apple-uma-mlx-exact-recall-status.md diff --git a/docs/benchmarks/apple-uma-mlx-exact-recall-status.md b/docs/benchmarks/apple-uma-mlx-exact-recall-status.md new file mode 100644 index 00000000..93ea65f2 --- /dev/null +++ b/docs/benchmarks/apple-uma-mlx-exact-recall-status.md @@ -0,0 +1,32 @@ +# Apple UMA MLX Exact Recall Status + +This branch intentionally lands the MLX exact CGA recall lane as an isolated benchmark module first. + +## Implemented + +- `benchmarks/apple_uma_mlx_exact_recall.py` +- `tests/test_apple_uma_mlx_exact_recall.py` +- `docs/benchmarks/apple-uma-mlx-exact-recall.md` + +## Not yet integrated + +The main `benchmarks/apple_uma_mechanical_sympathy.py` report has not yet been modified on this branch. + +Reason: the isolated module is the safest first landing surface for local Apple Silicon validation. After MLX is verified locally, the module can be integrated into the main Apple UMA report as the `mlx_exact_cga_recall` track. + +## Local validation request + +Run: + +```bash +uv run python -m pytest -q tests/test_apple_uma_mlx_exact_recall.py +uv run python -m benchmarks.apple_uma_mlx_exact_recall --json +``` + +When MLX is installed: + +```bash +CORE_BACKEND=rust uv run python -m benchmarks.apple_uma_mlx_exact_recall --json +``` + +All emitted cases must show `parity.parity_pass: true` before the results are used in Apple-facing material.