chore(build): align vcpkg configuration with registry baseline (#246)

* chore(vcpkg): align ecosystem configuration with registry baseline

Update kcenon vcpkg-registry baseline to latest commit (afdfab7)
which includes 18 commits of portfile fixes for cmake config paths,
dependency declarations, and FETCHCONTENT flags.

Add CONFIG hint to find_package calls in UnifiedDependencies.cmake
to ensure vcpkg-installed config-mode packages are found reliably.

Add vcpkg manifest mode preset to CMakePresets.json referencing
$env{VCPKG_ROOT} toolchain file for standardized local builds.

Refs: #245

* docs(build): update documentation for vcpkg preset and baseline alignment

- README.md: add vcpkg preset as build option alongside manual toolchain
- BUILD_TROUBLESHOOTING.md: add section on stale vcpkg baseline issues
- DEVELOPER_GUIDE.md: add vcpkg preset option to build instructions

---------

Co-authored-by: Developer <developer@local>

Author: kcenon

CMakePresets.json

@@ -6,6 +6,18 @@
     "patch": 0
   },
   "configurePresets": [
+    {
+      "name": "vcpkg",
+      "displayName": "vcpkg Manifest Mode",
+      "description": "Build using vcpkg manifest mode with ecosystem dependencies",
+      "binaryDir": "${sourceDir}/build-vcpkg",
+      "cacheVariables": {
+        "CMAKE_BUILD_TYPE": "Release",
+        "CMAKE_TOOLCHAIN_FILE": "$env{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake",
+        "MESSAGING_USE_EXTERNAL_SYSTEMS": "ON",
+        "MESSAGING_USE_FETCHCONTENT": "OFF"
+      }
+    },
     {
       "name": "default",
       "displayName": "Default Config",
@@ -165,6 +177,10 @@
     }
   ],
   "buildPresets": [
+    {
+      "name": "vcpkg",
+      "configurePreset": "vcpkg"
+    },
     {
       "name": "default",
       "configurePreset": "default"

README.md

@@ -200,7 +200,11 @@ cd messaging_system
 cmake -B build -DMESSAGING_USE_LOCAL_SYSTEMS=ON
 cmake --build build -j
 
-# Alternative: Build with vcpkg
+# Alternative: Build with vcpkg (using preset)
+cmake --preset vcpkg
+cmake --build --preset vcpkg
+
+# Alternative: Build with vcpkg (manual toolchain)
 cmake -B build -DCMAKE_TOOLCHAIN_FILE=/path/to/vcpkg/scripts/buildsystems/vcpkg.cmake
 cmake --build build -j
 ```

cmake/UnifiedDependencies.cmake

@@ -518,11 +518,11 @@ macro(_unified_resolve_find_package DEP_NAME VERSION IS_REQUIRED)
         set(_pkg_name "${DEP_NAME}")
     endif()
 
-    # Try find_package
+    # Try find_package (CONFIG mode preferred for vcpkg-installed packages)
     if(VERSION)
-        find_package(${_pkg_name} ${VERSION} QUIET)
+        find_package(${_pkg_name} ${VERSION} CONFIG QUIET)
     else()
-        find_package(${_pkg_name} QUIET)
+        find_package(${_pkg_name} CONFIG QUIET)
     endif()
 
     if(${_pkg_name}_FOUND)

docs/guides/BUILD_TROUBLESHOOTING.md

@@ -215,6 +215,20 @@ If you encounter issues not covered here:
 
 ---
 
+## vcpkg Baseline Issues
+
+If dependencies fail to resolve or you see unexpected version mismatches, ensure `vcpkg-configuration.json` has a current baseline. An outdated baseline can cause missing or incompatible packages.
+
+**Quick check**:
+```bash
+# View current baseline
+cat vcpkg-configuration.json | grep baseline
+```
+
+If the baseline is stale, update it to the latest vcpkg commit hash from the [vcpkg repository](https://github.com/microsoft/vcpkg).
+
+---
+
 ## Known Limitations
 
 1. **FetchContent + Local Systems**: Cannot coexist due to CMake target name conflicts

docs/guides/DEVELOPER_GUIDE.md

@@ -41,6 +41,10 @@ mkdir build && cd build
 cmake .. -DCMAKE_BUILD_TYPE=Release \
          -DCMAKE_TOOLCHAIN_FILE=../vcpkg/scripts/buildsystems/vcpkg.cmake
 cmake --build . --parallel
+
+# Or use the vcpkg preset (requires VCPKG_ROOT environment variable)
+cmake --preset vcpkg
+cmake --build --preset vcpkg
 ```
 
 ### 3. Your First Application

vcpkg-configuration.json

@@ -7,7 +7,7 @@
     {
       "kind": "git",
       "repository": "https://github.com/kcenon/vcpkg-registry.git",
-      "baseline": "77cc46d5ba5e2aef1581f2ec674f83e1ac906b43",
+      "baseline": "afdfab7fbc642bd71fd4764c970a91334794021c",
       "packages": ["kcenon-*"]
     }
   ]