apple-silicon

# Apple Silicon ## Contract | Field | Bound contract | |---|---| | Trigger | Code runs on an M-series Mac and needs to be checked for page-size assumptions, moved onto Accelerate or Metal for matrix work, profiled with Instruments or the command-line memory tools, or diagnosed for Rosetta 2 translation. | | Authority | Read-only: reads the host through `sysctl`, `arch`, `lipo`, `file`, `xctrace`, `vmmap`, `heap`, `leaks`, and `sample`, and writes traces only under the output path the user names; rollback is deleting those trace files. No remote mutation. | | Side effect | Trace and sample files in the named output directory. Profiling attaches to the target process. | | Done | The report names the chip and its features from `sysctl`, states whether the binary runs native or translated, lists every page-size assumption found in the code with its fix, and points each hotspot at the Accelerate, Metal, or threading change that addresses it. | ## Inputs - The binary or source under review, and how it is launched. - Whether the workload is matrix or convolution heavy (Accelerate and Metal candidates) or general CPU work. - Output directory for traces. - Xcode command-line tools installed (`xcode-select -p` prints the path). ## Procedure 1. Read the hardware. All CPU cores, the GPU, and the Neural Engine share one DRAM pool, so a Metal buffer in shared storage mode needs no copy to reach the GPU, and one process's memory total includes its GPU allocations. Done when: chip name...