Summary

Create C++20 module files for thread_system as part of the Tier 1 core libraries.

Parent Epic

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

Prerequisites

• Queue Implementation Reduction ([REFACTOR] Consolidate queue implementations from 8 to 2 - Kent Beck Simple Design #358) - COMPLETED
• Fix Misleading lockfree_queue Naming ([REFACTOR] Fix misleading lockfree_queue naming - Kent Beck Reveals Intention #359) - COMPLETED
• [MODULE] Create C++20 module files for kcenon.common common_system#269 - common_system module (Tier 0)

Proposed Module Structure

// Primary module interface
export module kcenon.thread;

import kcenon.common;  // Tier 0 dependency

export import kcenon.thread.core;
export import kcenon.thread.queue;  // Consolidated queue

Module Partitions

File Structure

src/modules/
├── thread.cppm              # Primary module interface
├── core.cppm                # Core partition
└── queue.cppm               # Queue partition

CMake Configuration

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

add_library(kcenon_thread)
target_sources(kcenon_thread
    PRIVATE FILE_SET CXX_MODULES
    FILES
        src/modules/thread.cppm
        src/modules/core.cppm
        src/modules/queue.cppm
)

Tasks

• Wait for common_system module (Tier 0) completion
• Create module directory structure
• Create thread.cppm primary interface
• Create core.cppm partition
• Create queue.cppm partition
• Update CMakeLists.txt for module support
• Verify no circular module dependencies
• Update all tests to use modules
• Performance benchmark (compile time)
• Update documentation

Acceptance Criteria

• Module builds successfully with CMake 3.28+
• Successfully imports kcenon.common module
• 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+3) per EPIC:

• Blocked by: common_system module completion

Related

• C++20 Module Migration Epic ([EPIC] C++20 Module Migration - Cross-System Preparation common_system#256)
• Queue consolidation ([REFACTOR] Consolidate queue implementations from 8 to 2 - Kent Beck Simple Design #358) - prerequisite completed
• lockfree_queue naming fix ([REFACTOR] Fix misleading lockfree_queue naming - Kent Beck Reveals Intention #359) - prerequisite completed