Summary

Create C++20 module files for monitoring_system as part of the Tier 3 libraries.

Parent Epic

Part of kcenon/common_system#256 (C++20 Module Migration - Cross-System Preparation)

Prerequisites

• Consolidate buffering layer ([REFACTOR] Consolidate buffering layer - C++20 Module preparation #309)
• [MODULE] Create C++20 module files for kcenon.common common_system#269 - common_system module (Tier 0)
• [MODULE] Create C++20 module files for kcenon.thread thread_system#371 - thread_system module (Tier 1)
• [MODULE] Create C++20 module files for kcenon.logger logger_system#275 - logger_system module (Tier 2, optional)

Proposed Module Structure

// Primary module interface
export module kcenon.monitoring;

import kcenon.common;           // Required
import kcenon.thread;           // Required
import kcenon.logger;           // Optional

export import kcenon.monitoring.core;
export import kcenon.monitoring.collectors;
export import kcenon.monitoring.adaptive;

Module Partitions

File Structure

src/modules/
├── monitoring.cppm          # Primary module interface
├── core.cppm                # Core partition
├── collectors.cppm          # Collectors partition
└── adaptive.cppm            # Adaptive partition

CMake Configuration

cmake_minimum_required(VERSION 3.28)
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_SCAN_FOR_MODULES ON)

add_library(kcenon_monitoring)
target_sources(kcenon_monitoring
    PRIVATE FILE_SET CXX_MODULES
    FILES
        src/modules/monitoring.cppm
        src/modules/core.cppm
        src/modules/collectors.cppm
        src/modules/adaptive.cppm
)

Tasks

• Complete buffering consolidation ([REFACTOR] Consolidate buffering layer - C++20 Module preparation #309) first
• Wait for Tier 0/1 module completion
• Create module directory structure
• Create module files
• Update CMakeLists.txt for module support
• Verify no circular module dependencies
• Update all tests to use modules
• Update documentation

Acceptance Criteria

• Module builds successfully with CMake 3.28+
• Successfully imports dependent modules
• All existing tests pass with module
• No circular dependencies
• Header-based build still works (transition period)

Migration Timeline

This is Phase 2 work (Release N+4) per EPIC:

• Blocked by: Tier 0/1/2 modules, buffering consolidation

Related

• C++20 Module Migration Epic ([EPIC] C++20 Module Migration - Cross-System Preparation common_system#256)
• Consolidate buffering layer ([REFACTOR] Consolidate buffering layer - C++20 Module preparation #309) - prerequisite