test: add readme and fix examples on macos

flake.nix

@@ -60,6 +60,14 @@
               mkdir -p lib
               cp -r ${cbind}/lib/* lib/ 2>/dev/null || true
 
+              ${lib.optionalString (lib.hasSuffix "darwin" system) ''
+              for f in lib/*.dylib; do
+                [ -f "$f" ] || continue
+                chmod +w "$f"
+                install_name_tool -id "@rpath/$(basename "$f")" "$f"
+              done
+              ''}
+
               mkdir -p include
               cp -r ${cbind}/include/* include/ 2>/dev/null || true
             '';

tests/README.md

@@ -0,0 +1,29 @@
+# Tests
+
+This directory contains Qt-based tests for the `logos-libp2p-module`.
+
+## Running tests
+
+Run all tests:
+```bash
+ctest --test-dir build
+```
+
+Run with full output (useful for debugging failures):
+```bash
+ctest --test-dir build -V
+```
+
+Run a specific test by name:
+```bash
+ctest --test-dir build -R async
+ctest --test-dir build -R sync
+ctest --test-dir build -R integration
+```
+
+Or run the test executables directly:
+```bash
+./build/async
+./build/sync
+./build/integration
+```