Introduction

Architecture Overview

EntropyCore provides the fundamental building blocks for the framework, focusing on high-performance concurrency and platform abstraction.

graph TD
    App["Application Loop"] --> WorkService["WorkService<br/>(Execution Environment)"]
    WorkService --> Scheduler["IWorkScheduler<br/>(Task Distribution)"]
    Scheduler --> WorkerPool["Worker Threads"]
    
    WorkService -.->|Executes| WorkGraph["WorkGraph<br/>(DAG Dependency Model)"]
    WorkGraph -- Contains --> Contract["WorkContract<br/>(Data Pipes)"]

Subsystems

Concurrency

The core work execution model.

• Work Contracts: Lock-free producer-consumer communication protocol.
• Work Graphs: DAG-based task scheduling with automatic parallelism.
• Work Service: The engine’s main loop, thread pool management, and execution environment.

Memory Model

Hybrid memory management strategy.

• Intrusive RefCounting: Minimizing allocation overhead.
• Weak References: Cycle breaking and safe observation.

Virtual File System

Unified I/O abstraction.

• Mount Points: Virtual-to-physical path mapping.
• Async I/O: Non-blocking integration with WorkScheduler.

Type System

Static reflection and runtime introspection.

• Reflection: Macro-based metadata generation.
• Serialization: Zero-boilerplate data persistence.