refactor: reorganize examples and fix compiler warnings

- Reorganize example files into logical subdirectories
- Fix unused parameter warnings across multiple modules
- Remove obsolete example and test files
- Update CMakeLists.txt to reflect new structure
- Fix MSVC compatibility issues in various modules
- Fix markdown linting issues in README files

Author: AstroAir

.claude/settings.local.json

@@ -97,7 +97,10 @@
       "Bash(then cp -v build/atom/error/libatom-error.dll build/atom/log/libatom-log.dll build/atom/log/libloguru.dll build/atom/components/libatom-component.dll \"$dir\")",
       "Bash(./test_abi.exe:*)",
       "Bash(pkill:*)",
-      "Bash(test:*)"
+      "Bash(test:*)",
+      "Bash(dir /s /b atomsystem*.hpp atomsystem*.h atomsystem*.cpp 2)",
+      "Bash(nul)",
+      "Bash(powershell:*)"
     ],
     "deny": [],
     "ask": []

atom/async/core/async.hpp

@@ -1246,6 +1246,20 @@ void AsyncWorker<void>::startAsync(Func&& func, Args&&... args) {
     }
 }
 
+inline void AsyncWorker<void>::getResult(std::chrono::milliseconds timeout) {
+    if (!task_.valid()) {
+        throw std::invalid_argument("Task is not valid");
+    }
+
+    if (timeout.count() > 0) {
+        if (task_.wait_for(timeout) != std::future_status::ready) {
+            THROW_TIMEOUT_EXCEPTION("Task result retrieval timed out");
+        }
+    }
+
+    task_.get();
+}
+
 inline void AsyncWorker<void>::cancel() noexcept {
     try {
         if (task_.valid()) {
@@ -1292,6 +1306,41 @@ inline auto AsyncWorker<void>::isActive() const noexcept -> bool {
     return state_.load(std::memory_order_acquire) == State::RUNNING;
 }
 
+inline auto AsyncWorker<void>::validate(
+    std::function<bool()> validator) noexcept -> bool {
+    try {
+        if (!validator) {
+            return false;
+        }
+
+        if (!isDone()) {
+            return false;
+        }
+
+        if (task_.valid()) {
+            task_.get();
+        }
+
+        return validator();
+    } catch (...) {
+        return false;
+    }
+}
+
+inline void AsyncWorker<void>::setCallback(std::function<void()> callback) {
+    if (!callback) {
+        throw std::invalid_argument("Callback function cannot be null");
+    }
+    callback_ = std::move(callback);
+}
+
+inline void AsyncWorker<void>::setTimeout(std::chrono::seconds timeout) {
+    if (timeout < std::chrono::seconds(0)) {
+        throw std::invalid_argument("Timeout cannot be negative");
+    }
+    timeout_ = timeout;
+}
+
 // Implementation of AsyncWorker methods
 template <typename ResultType>
 template <typename Func, typename... Args>

atom/async/utils/timer.cpp

@@ -68,12 +68,16 @@ void TimerTask::run() noexcept(false) {
         THROW_RUNTIME_ERROR("Failed to run timer task: Unknown error");
     }
 
+    const auto nextExecution =
+        std::chrono::steady_clock::now() + std::chrono::milliseconds(m_delay);
+
     if (m_repeatCount > 0) {
         --m_repeatCount;
         if (m_repeatCount > 0) {
-            m_nextExecutionTime = std::chrono::steady_clock::now() +
-                                  std::chrono::milliseconds(m_delay);
+            m_nextExecutionTime = nextExecution;
         }
+    } else if (m_repeatCount == -1) {
+        m_nextExecutionTime = nextExecution;
     }
 }
 
@@ -247,7 +251,8 @@ void Timer::run() noexcept {
                     try {
                         m_currentTask.run();
 
-                        if (m_currentTask.m_repeatCount > 0) {
+                        if (m_currentTask.m_repeatCount > 0 ||
+                            m_currentTask.m_repeatCount == -1) {
                             m_taskContainer.push(m_currentTask);
                         }
 
@@ -338,7 +343,7 @@ void Timer::run() noexcept {
                 try {
                     task.run();
 
-                    if (task.m_repeatCount > 0) {
+                    if (task.m_repeatCount > 0 || task.m_repeatCount == -1) {
                         std::scoped_lock innerLock(m_mutex);
                         m_taskQueue.emplace(task.m_func, task.m_delay,
                                             task.m_repeatCount,