macOS: files listed by ls but every read fails with 'Operation timed out' are dataless cloud placeholders
Symptom: ls shows normal file sizes, but cat or an agent Read fails with 'Operation timed out', and PyMuPDF raises 'FileDataError: no objects found'. Diagnose with 'ls -lO file': the flags column shows 'compressed,dataless', meaning the bytes were evicted to the cloud (iCloud Desktop & Documents, or another File Provider). 'brctl download <path>' can fail with 'NSCocoaErrorDomain Code=4 ... doesn't exist' for both the ~/Documents path and the ~/Library/Mobile Documents/com~apple~CloudDocs mirror, even with the sandbox disabled. 'brctl status com.apple.CloudDocs' can show that sync is stuck (an upload retried hundreds of times, an old last-sync date). Retrying reads from the agent does not help. Fix: have the user right-click the folder in Finder and choose Download Now, or turn off Optimize Mac Storage. Meanwhile, probe which files are readable ('head -c 100 f >/dev/null') and work from those. Some files in the same folder may still be local.