Fix systematic testing issues and improve MSVC compatibility

- Standardize test infrastructure across all modules
- Fix MSVC-specific compilation issues
- Improve CMake build configuration
- Add comprehensive testing documentation
- Update clang-format configuration
- Add MSVC build scripts and documentation

Author: AstroAir

.clang-format

@@ -91,9 +91,3 @@ SpacesInSquareBrackets: false
 Standard: Auto
 TabWidth: 8
 UseTab: Never
----
-Language: JavaScript
-DisableFormat: true
----
-Language: Json
-DisableFormat: true

.gitignore

@@ -53,6 +53,7 @@
 
 # Build directories
 build/
+build-msvc/
 cmake-build-*/
 out/
 _build/
@@ -70,6 +71,7 @@ CPackSourceConfig.cmake
 
 # CMake temporary files
 .cmake/
+cmake_config*.log
 
 # -----------------------------------------------------------------------------
 # Package Managers
@@ -142,7 +144,6 @@ coverage.xml
 cover/
 
 # Virtual environments
-.env
 .venv
 env/
 venv/
@@ -278,7 +279,6 @@ tramp
 # Sphinx documentation
 docs/_build/
 docs/build/
-_build/
 
 # Doxygen
 doc/html/
@@ -299,7 +299,6 @@ doxygen_warnings.txt
 
 # Xmake
 .xmake/
-build/
 
 # Bazel
 bazel-*
@@ -313,8 +312,6 @@ Thumbs.db
 Thumbs.db:encryptable
 ehthumbs.db
 ehthumbs_vista.db
-*.tmp
-*.temp
 Desktop.ini
 $RECYCLE.BIN/
 *.cab
@@ -459,6 +456,18 @@ nlohmann/
 *SUMMARY.md
 *_SUMMARY.md
 
+# Build output and logs
+build_output.txt
+test_results.txt
+preset_list.txt
+vcpkg_location.txt
+
+# Generated distribution files
+dist/
+
+# LLM documentation (generated)
+llmdoc/
+
 # -----------------------------------------------------------------------------
 # End of .gitignore
 # -----------------------------------------------------------------------------

.markdownlint.json

@@ -0,0 +1,4 @@
+{
+  "MD013": false,
+  "MD029": { "style": "ordered" }
+}

AGENTS.md

@@ -1,13 +1,15 @@
 # Repository Guidelines
 
 ## Project Structure & Module Organization
+
 - `atom/` — C++ core library, organized by domain (algorithm, async, io, etc.).
 - `python/` — Pybind11 bindings and the `atom` Python package.
 - `tests/` — C++ test suite (GoogleTest via CMake/CTest). Python tests, if any, also live here.
 - `docs/` — Sphinx docs; `doc/` — Doxygen configuration (`Doxyfile`).
 - `cmake/`, `scripts/`, `example/`, `build/` (generated).
 
 ## Build, Test, and Development Commands
+
 - C++ build (Ninja default): `cmake --preset release && cmake --build --preset release -j`
 - C++ tests: `cmake --preset debug && cmake --build --preset debug -j && ctest --preset default --output-on-failure`
 - Cross‑platform scripts: `./build.sh` (Unix) or `build.bat` (Windows) - wrapper scripts for backward compatibility
@@ -17,17 +19,21 @@
 - Docs: Sphinx `sphinx-build -b html docs docs/_build`; Doxygen `doxygen Doxyfile`
 
 ## Coding Style & Naming Conventions
+
 - C++: 4‑space indent, 80‑column guide; format with `clang-format` (see `.clang-format`).
 - Naming (C++): camelCase for variables/functions, PascalCase for classes/namespaces, UPPER_SNAKE_CASE for constants, files `lower_snake_case.[cpp|hpp]` (see `STYLE_OF_CODE.md`). Prefer Doxygen comments.
 - Python: Black (88 cols), isort, Ruff, MyPy (configured in `pyproject.toml`). Run: `pre-commit run -a`.
 
 ## Testing Guidelines
+
 - C++: Use GoogleTest; place tests under `tests/<module>/` and register targets in the local `CMakeLists.txt`. Run via CTest; include edge cases and failure paths.
 - Python: pytest patterns `test_*.py`, marks available (`unit`, `integration`, `slow`). Aim to keep coverage healthy; prefer small, focused tests.
 
 ## Commit & Pull Request Guidelines
+
 - Commits: short imperative subject (≤72 chars), descriptive body when needed. Reference issues (`#123`). Conventional commit prefixes are optional.
 - PRs: clear description, rationale, linked issues, tests added/updated, and doc changes if behavior/user‑facing APIs change. Ensure `pre-commit` passes and CI is green.
 
 ## Security & Configuration Tips
+
 - Don’t commit secrets; prefer env vars. Build requires CMake ≥3.21 and a modern compiler (MSVC 2022/GCC/Clang). C/C++ deps via vcpkg/Conan; Python ≥3.8.

CLAUDE.md

@@ -22,6 +22,7 @@ The project uses CMake as the primary build system with enhanced build scripts:
 ### Build System Features
 
 The enhanced build scripts support:
+
 - Multiple build types (debug, release, relwithdebinfo)
 - Parallel compilation with automatic CPU detection
 - System dependency installation
@@ -32,6 +33,7 @@ The enhanced build scripts support:
 ### Module-Based Building
 
 You can selectively build modules using CMake options:
+
 - `ATOM_BUILD_ALGORITHM=ON/OFF` - Algorithm and mathematical operations
 - `ATOM_BUILD_IMAGE=ON/OFF` - Image processing and computer vision
 - `ATOM_BUILD_ASYNC=ON/OFF` - Asynchronous operations
@@ -74,6 +76,7 @@ Atom is organized into modular components under `atom/`:
 ### Python Bindings
 
 Python bindings are available for most modules using pybind11:
+
 - Enable with `--python` flag or `ATOM_BUILD_PYTHON_BINDINGS=ON`
 - Bindings are located in `python/` directory
 - Each module has corresponding Python binding files
@@ -107,18 +110,21 @@ Atom uses a comprehensive error handling system centered in the `error` module.
 ## Common Development Tasks
 
 ### Building a Single Module
+
 ```bash
 cmake -B build -DATOM_BUILD_ALGORITHM=ON -DATOM_BUILD_TESTS=ON
 cmake --build build
 ```
 
 ### Running Specific Tests
+
 ```bash
 cd build
 ctest -R "algorithm_*" --output-on-failure
 ```
 
 ### Building with All Features
+
 ```bash
 ./scripts/build.sh --release --python --examples --tests --docs --package
-```
+```

CMakeLists.txt

@@ -48,9 +48,12 @@ endforeach()
 # -----------------------------------------------------------------------------
 # Options
 # -----------------------------------------------------------------------------
-option(USE_VCPKG "Use vcpkg package manager" ON)
-if(WIN32 AND CMAKE_CXX_COMPILER_ID MATCHES "MSVC")
-  # Ensure vcpkg is enabled for MSVC builds
+option(USE_VCPKG "Use vcpkg package manager" OFF)
+# Force vcpkg ON for MSVC builds (but not MSYS2/MinGW)
+if(WIN32
+   AND CMAKE_CXX_COMPILER_ID MATCHES "MSVC"
+   AND NOT DEFINED ENV{MSYSTEM})
+  # Ensure vcpkg is enabled for MSVC builds only (not MSYS2)
   set(USE_VCPKG
       ON
       CACHE BOOL "Enable vcpkg for MSVC" FORCE)
@@ -132,6 +135,8 @@ set(CMAKE_CXX_EXTENSIONS OFF)
 # Setup compiler-specific options based on build type and compiler
 if(CMAKE_CXX_COMPILER_ID MATCHES "MSVC")
   message(STATUS "Configuring for MSVC compiler")
+  # Work around Windows SDK winnt.h arch detection under some environments
+  add_compile_definitions(ATOM_DISABLE_DBGHELP _AMD64_)
   # Call compiler configuration from compiler_options.cmake
   setup_project_defaults(
     CXX_STANDARD
@@ -159,8 +164,13 @@ add_compile_definitions(ATOM_VERSION="${PROJECT_VERSION}"
 
 # Windows API version definitions
 if(WIN32)
-  add_compile_definitions(_WIN32_WINNT=0x0A00 # Windows 10
-                          WINVER=0x0A00 _WIN32_WINDOWS=0x0A00)
+  add_compile_definitions(
+    _WIN32_WINNT=0x0A00 # Windows 10
+    WINVER=0x0A00
+    _WIN32_WINDOWS=0x0A00
+    NOMINMAX # Prevent Windows.h from defining min/max macros
+    WIN32_LEAN_AND_MEAN # Exclude rarely-used stuff from Windows headers
+  )
 endif()
 
 # -----------------------------------------------------------------------------

CMakePresets.json

@@ -83,6 +83,28 @@
             "name": "base-msys2",
             "hidden": true,
             "inherits": "base-mingw",
+            "cacheVariables": {
+                "USE_VCPKG": "OFF"
+            },
+            "condition": {
+                "type": "matches",
+                "string": "$env{PATH}",
+                "regex": ".*msys64.*|.*msys2.*"
+            }
+        },
+        {
+            "name": "base-msys2-vcpkg",
+            "hidden": true,
+            "inherits": "base-mingw",
+            "toolchainFile": "$env{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake",
+            "cacheVariables": {
+                "USE_VCPKG": "ON",
+                "VCPKG_TARGET_TRIPLET": "x64-mingw-dynamic",
+                "VCPKG_HOST_TRIPLET": "x64-mingw-dynamic"
+            },
+            "environment": {
+                "VCPKG_ROOT": "$penv{VCPKG_ROOT}"
+            },
             "condition": {
                 "type": "matches",
                 "string": "$env{PATH}",
@@ -183,6 +205,30 @@
                 "_common-relwithdebinfo-config"
             ]
         },
+        {
+            "name": "debug-msys2-vcpkg",
+            "displayName": "Debug (MSYS2 with vcpkg)",
+            "inherits": [
+                "base-msys2-vcpkg",
+                "_common-debug-config"
+            ]
+        },
+        {
+            "name": "release-msys2-vcpkg",
+            "displayName": "Release (MSYS2 with vcpkg)",
+            "inherits": [
+                "base-msys2-vcpkg",
+                "_common-release-config"
+            ]
+        },
+        {
+            "name": "relwithdebinfo-msys2-vcpkg",
+            "displayName": "RelWithDebInfo (MSYS2 with vcpkg)",
+            "inherits": [
+                "base-msys2-vcpkg",
+                "_common-relwithdebinfo-config"
+            ]
+        },
         {
             "name": "debug-make",
             "displayName": "Debug (Makefile)",
@@ -287,6 +333,21 @@
             "configurePreset": "relwithdebinfo-msys2",
             "jobs": 8
         },
+        {
+            "name": "debug-msys2-vcpkg",
+            "configurePreset": "debug-msys2-vcpkg",
+            "jobs": 8
+        },
+        {
+            "name": "release-msys2-vcpkg",
+            "configurePreset": "release-msys2-vcpkg",
+            "jobs": 8
+        },
+        {
+            "name": "relwithdebinfo-msys2-vcpkg",
+            "configurePreset": "relwithdebinfo-msys2-vcpkg",
+            "jobs": 8
+        },
         {
             "name": "debug-make",
             "configurePreset": "debug-make",