Clean up documentation and workflows

Author: glynos

.clang-format

@@ -103,8 +103,8 @@ IncludeCategories:
   - Regex:           '^<[^/]+>$'
     Priority:        2
     SortPriority:    2
-  # 3. Third-party libraries (uni-algo, catch2, nlohmann)
-  - Regex:           '^<(uni|catch2|nlohmann)/'
+  # 3. Third-party libraries (catch2, nlohmann)
+  - Regex:           '^<(catch2|nlohmann)/'
     Priority:        3
     SortPriority:    3
   # 4. Project headers (skyr/...)

.github/workflows/clang-tidy.yml

@@ -28,7 +28,7 @@ jobs:
           ./bootstrap-vcpkg.sh
           export CXXFLAGS="-stdlib=libc++"
           export LDFLAGS="-stdlib=libc++ -lc++abi"
-          ./vcpkg install uni-algo nlohmann-json
+          ./vcpkg install nlohmann-json
 
       - name: Install Catch2
         run: |

.github/workflows/sanitizers.yml

@@ -115,17 +115,6 @@ jobs:
           git checkout -b master origin/master
           ./bootstrap-vcpkg.sh
 
-          # For Clang builds, use custom triplet with libc++ and set compiler
-          if [[ "${{ matrix.config.use_libcxx }}" == "true" ]]; then
-            export CC=${{ matrix.config.cc }}
-            export CXX=${{ matrix.config.cxx }}
-            ./vcpkg install uni-algo \
-              --triplet x64-linux-libcxx \
-              --overlay-triplets=${GITHUB_WORKSPACE}/cmake/vcpkg-triplets
-          else
-            ./vcpkg install uni-algo
-          fi
-
       - name: Configure
         shell: cmake -P {0}
         run: |

.github/workflows/skyr-url-ci.yml

@@ -298,11 +298,11 @@ jobs:
           if [[ "${{ matrix.config.cxx }}" == clang++* ]]; then
             export CC=${{ matrix.config.cc }}
             export CXX=${{ matrix.config.cxx }}
-            ./vcpkg install catch2 uni-algo nlohmann-json \
+            ./vcpkg install catch2 nlohmann-json \
               --triplet x64-linux-libcxx \
               --overlay-triplets=${GITHUB_WORKSPACE}/cmake/vcpkg-triplets
           else
-            ./vcpkg install catch2 uni-algo nlohmann-json
+            ./vcpkg install catch2 nlohmann-json
           fi
 
       - name: Install LLVM Clang on macOS
@@ -338,7 +338,7 @@ jobs:
           git checkout -b master origin/master
           export
           ./bootstrap-vcpkg.sh
-          ./vcpkg install catch2 uni-algo nlohmann-json
+          ./vcpkg install catch2 nlohmann-json
 
       - name: Install vcpkg (Windows)
         id: vcpkg_windows
@@ -348,7 +348,7 @@ jobs:
           git clone https://github.com/microsoft/vcpkg.git ${Env:GITHUB_WORKSPACE}\vcpkg
           cd ${Env:GITHUB_WORKSPACE}\vcpkg
           .\bootstrap-vcpkg.bat
-          vcpkg install catch2 uni-algo nlohmann-json --triplet x64-windows
+          vcpkg install catch2 nlohmann-json --triplet x64-windows
           
 
       - name: Configure

.github/workflows/wpt.yml

@@ -61,7 +61,7 @@ jobs:
           git fetch origin master
           git checkout -b master origin/master
           ./bootstrap-vcpkg.sh
-          ./vcpkg install uni-algo nlohmann-json
+          ./vcpkg install nlohmann-json
 
       - name: Configure
         shell: cmake -P {0}

CLAUDE.md

@@ -295,14 +295,32 @@ Performance:
 
 To find actual performance bottlenecks, use profiling tools:
 
-**macOS (Instruments):**
+**macOS (Instruments - requires Xcode):**
 ```bash
+# First, install Xcode from App Store or https://developer.apple.com/download/
+# Verify: xctrace version
+
 cmake -B _build -G Ninja -Dskyr_BUILD_BENCHMARKS=ON -DCMAKE_BUILD_TYPE=RelWithDebInfo
 cmake --build _build --target url_parsing_bench
-instruments -t "Time Profiler" -D /tmp/url_bench.trace ./_build/benchmark/url_parsing_bench 50000
+
+# Profile with xctrace (modern replacement for 'instruments' command)
+xctrace record --template 'Time Profiler' \
+  --output /tmp/url_bench.trace \
+  --launch ./_build/benchmark/url_parsing_bench 50000
+
+# Open results in Instruments GUI
 open /tmp/url_bench.trace
 ```
 
+**macOS (sample - built-in, no Xcode needed):**
+```bash
+cmake -B _build -G Ninja -Dskyr_BUILD_BENCHMARKS=ON -DCMAKE_BUILD_TYPE=RelWithDebInfo
+cmake --build _build --target url_parsing_bench
+sample url_parsing_bench 10 -file /tmp/profile.txt &
+./_build/benchmark/url_parsing_bench 50000
+open /tmp/profile.txt
+```
+
 **Linux (perf):**
 ```bash
 cmake -B _build -G Ninja -Dskyr_BUILD_BENCHMARKS=ON -DCMAKE_BUILD_TYPE=RelWithDebInfo
@@ -313,8 +331,11 @@ perf report
 
 **All platforms (Valgrind):**
 ```bash
+cmake -B _build -G Ninja -Dskyr_BUILD_BENCHMARKS=ON -DCMAKE_BUILD_TYPE=RelWithDebInfo
+cmake --build _build --target url_parsing_bench
 valgrind --tool=callgrind ./_build/benchmark/url_parsing_bench 1000
-qcachegrind callgrind.out  # or kcachegrind on Linux
+qcachegrind callgrind.out  # macOS: brew install qcachegrind
+                           # Linux: kcachegrind
 ```
 
 ### Test Coverage

benchmark/README.md

@@ -35,23 +35,48 @@ Default: 10,000 iterations × 34 URLs = 340,000 parses
 
 ### macOS (with Xcode Instruments)
 
+**Requires Xcode** - Install from App Store or https://developer.apple.com/download/
+
 ```bash
+# Verify Xcode tools are installed
+xctrace version
+
 # Build with debug symbols
 cmake -B _build -G Ninja \
   -Dskyr_BUILD_BENCHMARKS=ON \
   -DCMAKE_BUILD_TYPE=RelWithDebInfo
 
 cmake --build _build --target url_parsing_bench
 
-# Profile with Instruments
-instruments -t "Time Profiler" \
-  -D /tmp/url_bench.trace \
-  ./_build/benchmark/url_parsing_bench 50000
+# Profile with xctrace (modern replacement for 'instruments' command)
+xctrace record --template 'Time Profiler' \
+  --output /tmp/url_bench.trace \
+  --launch ./_build/benchmark/url_parsing_bench 50000
 
-# Open results
+# Open results in Instruments GUI
 open /tmp/url_bench.trace
 ```
 
+### macOS (with sample - no Xcode needed)
+
+**Built-in** - No installation required
+
+```bash
+# Build with debug symbols
+cmake -B _build -G Ninja \
+  -Dskyr_BUILD_BENCHMARKS=ON \
+  -DCMAKE_BUILD_TYPE=RelWithDebInfo
+
+cmake --build _build --target url_parsing_bench
+
+# Profile with sample (10 second sample)
+sample url_parsing_bench 10 -file /tmp/profile.txt &
+./_build/benchmark/url_parsing_bench 50000
+
+# View results
+open /tmp/profile.txt
+```
+
 ### Linux (with perf)
 
 ```bash