Add multithreaded logging infrastructure for preparation for future designs (#225)

* Update class diagrams

* Implement BoundedChannel and multithreaded logging infra

* Integrate logging channel system

* Update string concatenations to use std::format

* Add pretty print log

tooling/pipeline/src/services/enrichment/wikipedia/fetch_extract.cc

@@ -2,8 +2,6 @@
  * @file wikipedia/fetch_extract.cc
  */
 
-#include <spdlog/spdlog.h>
-
 #include <boost/json.hpp>
 #include <chrono>
 #include <format>
@@ -16,13 +14,16 @@
 using namespace boost;
 
 std::string WikipediaEnrichmentService::FetchExtract(std::string_view query) {
-
   const std::string cache_key(query);
 
   // 1. Cache Lookup
   if (const auto cache_it = this->extract_cache_.find(cache_key);
       cache_it != this->extract_cache_.end()) {
-    spdlog::debug("Wikipedia: Cache hit for {}!", cache_key);
+    if (logger_) {
+      logger_->Log({.level = LogLevel::Debug,
+                    .phase = PipelinePhase::UserGeneration,
+                    .message = std::format("Wikipedia: Cache hit for {}!", cache_key)});
+    }
     return cache_it->second;
   }
 
@@ -32,7 +33,6 @@ std::string WikipediaEnrichmentService::FetchExtract(std::string_view query) {
       "api.php?action=query&titles={}&prop=extracts&explaintext=1&format=json",
       encoded);
 
-
   const std::string body = this->client_->Get(url);
   {
     using namespace std::literals::chrono_literals;
@@ -44,15 +44,27 @@ std::string WikipediaEnrichmentService::FetchExtract(std::string_view query) {
   json::value doc = json::parse(body, ec);
 
   if (ec) {
-    spdlog::warn("WikipediaService: JSON parse error for '{}': {}", query,
-                 ec.message());
+    if (logger_) {
+      logger_->Log(
+          {.level = LogLevel::Warn,
+           .phase = PipelinePhase::UserGeneration,
+           .message = std::format("WikipediaService: JSON parse error for '{}': {}",
+                      std::string(query), ec.message())});
+    }
     return {};
   }
 
   // 3. Safe Extraction
   const json::object* obj = doc.if_object();
   if (obj == nullptr) {
-    spdlog::warn("WikipediaService: Expected root object for '{}'", query);
+    if (logger_) {
+      logger_->Log(
+          {.level = LogLevel::Warn,
+           .phase = PipelinePhase::UserGeneration,
+           .message =
+               std::format("WikipediaService: Expected root object for '{}'",
+               std::string(query))});
+    }
     return {};
   }
 
@@ -63,14 +75,27 @@ std::string WikipediaEnrichmentService::FetchExtract(std::string_view query) {
           : nullptr;
 
   if ((pages_ptr == nullptr) || !pages_ptr->is_object()) {
-    spdlog::warn("WikipediaService: Missing query.pages for '{}'", query);
+    if (logger_) {
+      logger_->Log(
+          {.level = LogLevel::Warn,
+           .phase = PipelinePhase::UserGeneration,
+           .message =
+               std::format("WikipediaService: Missing query.pages for '{}'",
+               std::string(query))});
+    }
     return {};
   }
 
   const json::object& pages = pages_ptr->get_object();
 
   if (pages.empty()) {
-    spdlog::warn("WikipediaService: No pages returned for '{}'", query);
+    if (logger_) {
+      logger_->Log(
+          {.level = LogLevel::Warn,
+           .phase = PipelinePhase::UserGeneration,
+           .message = std::format("WikipediaService: No pages returned for '{}'",
+                      std::string(query))});
+    }
     this->extract_cache_.emplace(cache_key, "");
     return {};
   }
@@ -80,7 +105,14 @@ std::string WikipediaEnrichmentService::FetchExtract(std::string_view query) {
   const json::value& page_val = pages.begin()->value();
 
   if (!page_val.is_object()) {
-    spdlog::warn("WikipediaService: Unexpected page format for '{}'", query);
+    if (logger_) {
+      logger_->Log(
+          {.level = LogLevel::Warn,
+           .phase = PipelinePhase::UserGeneration,
+           .message =
+               std::format("WikipediaService: Unexpected page format for '{}'",
+               std::string(query))});
+    }
     return {};
   }
 
@@ -88,7 +120,12 @@ std::string WikipediaEnrichmentService::FetchExtract(std::string_view query) {
 
   // Handle 404/Missing status
   if (page.contains("missing")) {
-    spdlog::warn("WikipediaService: Page '{}' does not exist", query);
+    if (logger_) {
+      logger_->Log({.level = LogLevel::Warn,
+                    .phase = PipelinePhase::UserGeneration,
+                    .message = std::format("WikipediaService: Page '{}' does not exist",
+                               std::string(query))});
+    }
     this->extract_cache_.emplace(cache_key, "");
     return {};
   }
@@ -96,17 +133,28 @@ std::string WikipediaEnrichmentService::FetchExtract(std::string_view query) {
   const json::value* extract_ptr = page.if_contains("extract");
 
   if ((extract_ptr == nullptr) || !extract_ptr->is_string()) {
-    spdlog::warn("WikipediaService: No extract string found for '{}'", query);
+    if (logger_) {
+      logger_->Log(
+          {.level = LogLevel::Warn,
+           .phase = PipelinePhase::UserGeneration,
+           .message =
+               std::format("WikipediaService: No extract string found for '{}'",
+               std::string(query))});
+    }
     this->extract_cache_.emplace(cache_key, "");
     return {};
   }
 
   // 4. Success
   std::string extract(extract_ptr->as_string());
-  spdlog::info("WikipediaService: Fetched {} chars for '{}'", extract.size(),
-                query);
+  if (logger_) {
+    logger_->Log({.level = LogLevel::Info,
+                  .phase = PipelinePhase::UserGeneration,
+                  .message = std::format("WikipediaService: Fetched {} chars for '{}'",
+                             extract.size(), std::string(query))});
+  }
 
   this->extract_cache_.insert_or_assign(cache_key, extract);
 
   return extract;
-}
+}

tooling/pipeline/src/services/enrichment/wikipedia/get_summary.cc

@@ -3,8 +3,6 @@
  * @brief WikipediaService::GetLocationContext() implementation.
  */
 
-#include <spdlog/spdlog.h>
-
 #include <chrono>
 #include <format>
 #include <string>
@@ -12,10 +10,15 @@
 
 #include "services/enrichment/wikipedia_service.h"
 
-std::string WikipediaEnrichmentService::GetLocationContext(const Location& loc) {
+std::string WikipediaEnrichmentService::GetLocationContext(
+    const Location& loc) {
   using namespace std::literals::chrono_literals;
   if (!this->client_) {
-    spdlog::warn("Client is nullptr.");
+    if (logger_) {
+      logger_->Log({.level = LogLevel::Warn,
+                    .phase = PipelinePhase::UserGeneration,
+                    .message = "Wikipedia client is nullptr."});
+    }
     return {};
   }
 
@@ -46,13 +49,22 @@ std::string WikipediaEnrichmentService::GetLocationContext(const Location& loc)
   try {
     append_extract(FetchExtract(brewing_query));
     append_extract(FetchExtract(beer_query));
-    spdlog::info("Done fetching for {}. Sleeping for 10 seconds.",
-                 location_query);
+    if (logger_) {
+      logger_->Log({.level = LogLevel::Info,
+                    .phase = PipelinePhase::UserGeneration,
+                    .message = std::format("Done fetching for {}. Sleeping for 10 seconds.",
+                               location_query)});
+    }
     std::this_thread::sleep_for(10s);
 
   } catch (const std::runtime_error& e) {
-    spdlog::debug("WikipediaService lookup failed for '{}': {}", location_query,
-                  e.what());
+    if (logger_) {
+      logger_->Log(
+          {.level = LogLevel::Debug,
+           .phase = PipelinePhase::UserGeneration,
+           .message = std::format("WikipediaService lookup failed for '{}': {}",
+                      location_query, e.what())});
+    }
   }
   return result;
 }

tooling/pipeline/src/services/enrichment/wikipedia/wikipedia_service.cc

@@ -8,5 +8,5 @@
 #include <utility>
 
 WikipediaEnrichmentService::WikipediaEnrichmentService(
-    std::unique_ptr<WebClient> client)
-    : client_(std::move(client)) {}
+    std::unique_ptr<WebClient> client, std::shared_ptr<ILogger> logger)
+    : client_(std::move(client)), logger_(std::move(logger)) {}