update readme for macos sqlite3 .load issue

Author: mddelk

README.md

@@ -74,6 +74,55 @@ It then exposes a method, `SqliteExtensions::UUID.to_path`, which returns the lo
 
 This can be passed to [sqlite3](https://github.com/sparklemotion/sqlite3-ruby) in `Database.new(extensions: [])` or `Database#load_extension`.
 
+## Issues
+
+### Missing `.load` command
+
+The default `sqlite3` on MacOS doesn't allow loading runtime extensions, so you'll need to use the version from `brew` instead (`brew install sqlite3`).
+
+```console
+% /usr/bin/sqlite3
+SQLite version 3.43.2 2023-10-10 13:08:14
+Enter ".help" for usage hints.
+Connected to a transient in-memory database.
+Use ".open FILENAME" to reopen on a persistent database.
+sqlite> .load
+Error: unknown command or invalid arguments:  "load". Enter ".help" for help
+```
+
+You can do so by following the suggestions from `brew info sqlite3`:
+
+```console
+% brew info sqlite3
+...
+==> Caveats
+sqlite is keg-only, which means it was not symlinked into /opt/homebrew,
+because macOS already provides this software and installing another version in
+parallel can cause all kinds of trouble.
+
+If you need to have sqlite first in your PATH, run:
+  echo 'export PATH="/opt/homebrew/opt/sqlite/bin:$PATH"' >> ~/.zshrc
+
+For compilers to find sqlite you may need to set:
+  export LDFLAGS="-L/opt/homebrew/opt/sqlite/lib"
+  export CPPFLAGS="-I/opt/homebrew/opt/sqlite/include"
+
+For pkg-config to find sqlite you may need to set:
+  export PKG_CONFIG_PATH="/opt/homebrew/opt/sqlite/lib/pkgconfig"
+```
+
+Afterwards, to check that `.load` support works:
+
+```console
+% sqlite3
+SQLite version 3.50.1 2025-06-06 14:52:32
+Enter ".help" for usage hints.
+Connected to a transient in-memory database.
+Use ".open FILENAME" to reopen on a persistent database.
+(ins)sqlite> .load
+Usage: .load FILE ?ENTRYPOINT?
+```
+
 ## Development
 
 ```shell