trail-mate/modules/core_sys

modules/core_sys

Home for cross-platform system abstractions and generic utilities.

Migrated now

• include/sys/ringbuf.h
• include/sys/clock.h
• include/app/app_facade_access.h
• include/app/app_context_platform_bindings.h
• src/sys/clock.cpp
• src/app/app_facade_access.cpp

Moved to platform layer

• event_bus now lives at platform/esp/arduino_common/include/sys/event_bus.h because it depends on chat/team event payloads plus FreeRTOS runtime details

Expected future contents

• timer abstraction
• storage and file-system interfaces
• shared utility code that is not tied to ESP or Linux runtime APIs

Transitional note

• sys/ringbuf.h and sys/clock.h are now consumed directly from modules/core_sys/include/sys/*
• clock.cpp provides portable fallbacks based on the C++ standard library and can be overridden by platform-specific providers
• the active app shell should register runtime providers through sys::set_millis_provider() and sys::set_epoch_seconds_provider() during startup