AIOS Core

Version: 1.0.0
Author: PoorKingz
License: MIT
Compatibility: Retail, Classic Era, Mists of Pandaria Classic

AIOS Core is a deterministic, service-oriented kernel framework for World of Warcraft addon development.

It provides a structured foundation for building modular addons with:

• Lazy service resolution (ServiceRegistry)
• Reactive event handling (EventBus)
• Structured logging
• Timer scheduling (debounce/throttle support)
• Namespaced saved variables with schema support
• Cross-flavor normalization across supported WoW clients

AIOS Core is dependency-free and written in pure Lua 5.1.

The goal of AIOS is to provide a stable, cross-flavor-safe foundation where public APIs behave consistently across Retail and Classic clients.

Architecture Overview

AIOS is built around a central ServiceRegistry that provides dependency-safe initialization and lazy instantiation of services.

Core systems include:

• ServiceRegistry — Dependency container and service resolver
• EventBus — Reactive and async event system
• Timers — Deterministic scheduling layer
• Saved — Versioned persistence layer
• Logger — Structured logging with adjustable verbosity
• Lean — Optional memory pooling utilities

Optional modules (not required by core execution path):

• Codec — Compression / encoding utilities
• Locale — Localization system (currently being finalized)
• Debug tools — Internal diagnostics scaffolding

Project Status

AIOS Core is stable and production-ready as a kernel framework.

Some subsystems such as Locale translation flow are still being refined, but core services are fully functional.

Feedback and architectural review are welcome.