StillHammer
fad105afb2
Major feature: Unified config/data/runtime tree system
**New System Architecture:**
- Unified data tree for config, persistent data, and runtime state
- Three separate roots: config/ (read-only + hot-reload), data/ (read-write + save), runtime/ (temporary)
- Support for modding, saves, and hot-reload in single system
**Interfaces:**
- IDataValue: Abstract data value interface (type-safe access)
- IDataNode: Tree node with navigation, search, and modification
- IDataTree: Root container with config/data/runtime management
**Concrete Implementations:**
- JsonDataValue: nlohmann::json backed value
- JsonDataNode: Full tree navigation with pattern matching & queries
- JsonDataTree: File-based JSON storage with hot-reload
**Features:**
- Pattern matching search (wildcards support)
- Property-based queries with predicates
- SHA256 hashing for validation/sync
- Hot-reload for config/ directory
- Save operations for data/ persistence
- Read-only enforcement for config/
**API Changes:**
- All namespaces changed from 'warfactory' to 'grove'
- IDataTree: Added getConfigRoot(), getDataRoot(), getRuntimeRoot()
- IDataTree: Added saveData(), saveNode() for persistence
- IDataNode: Added setChild(), removeChild(), clearChildren()
- CMakeLists.txt: Added OpenSSL dependency for hashing
**Usage:**
```cpp
auto tree = DataTreeFactory::create("json", "./gamedata");
auto config = tree->getConfigRoot(); // Read-only game config
auto data = tree->getDataRoot(); // Player saves
auto runtime = tree->getRuntimeRoot(); // Temporary state
// Hot-reload config on file changes
if (tree->reloadIfChanged()) { /* refresh modules */ }
// Save player progress
data->setChild("progress", progressNode);
tree->saveData();
```
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
92 lines
3.1 KiB
C++
92 lines
3.1 KiB
C++
#pragma once
|
|
|
|
#include <string>
|
|
#include <memory>
|
|
#include "ITaskScheduler.h"
|
|
|
|
// Forward declarations to avoid circular dependencies
|
|
namespace grove {
|
|
class IModule;
|
|
class IIO;
|
|
}
|
|
|
|
namespace grove {
|
|
|
|
enum class ModuleSystemType {
|
|
SEQUENTIAL = 0,
|
|
THREADED = 1,
|
|
THREAD_POOL = 2,
|
|
CLUSTER = 3
|
|
};
|
|
|
|
|
|
/**
|
|
* @brief Module execution strategy interface - swappable performance architecture
|
|
*
|
|
* The module system manages module lifecycle and execution strategy.
|
|
* Different implementations provide different performance characteristics:
|
|
*
|
|
* - SequentialModuleSystem: Debug/test mode, processes modules one at a time
|
|
* - ThreadedModuleSystem: Each module in its own thread
|
|
* - MultithreadedModuleSystem: Module tasks distributed across thread pool
|
|
* - ClusterModuleSystem: Modules distributed across multiple machines
|
|
*
|
|
* This enables progressive evolution from debug to production to MMO scale
|
|
* without changing any module business logic code.
|
|
*
|
|
* Inherits from ITaskScheduler to provide task delegation capabilities.
|
|
*/
|
|
class IModuleSystem : public ITaskScheduler {
|
|
public:
|
|
virtual ~IModuleSystem() = default;
|
|
|
|
/**
|
|
* @brief Register a module with the system
|
|
* @param name Unique identifier for the module
|
|
* @param module Module implementation (unique ownership)
|
|
*
|
|
* The module system takes ownership of the module and manages its lifecycle.
|
|
* Modules can be registered at any time and will participate in the next
|
|
* processing cycle.
|
|
*/
|
|
virtual void registerModule(const std::string& name, std::unique_ptr<IModule> module) = 0;
|
|
|
|
/**
|
|
* @brief Process all registered modules
|
|
* @param deltaTime Time elapsed since last processing cycle in seconds
|
|
*
|
|
* This is the core execution method that coordinates all modules according
|
|
* to the implemented strategy. Each module's process() method will be called
|
|
* with appropriate timing and coordination.
|
|
*/
|
|
virtual void processModules(float deltaTime) = 0;
|
|
|
|
/**
|
|
* @brief Set the IO layer for inter-module communication
|
|
* @param ioLayer Communication transport implementation (unique ownership)
|
|
*
|
|
* The module system takes ownership of the IO layer and uses it to
|
|
* facilitate communication between modules.
|
|
*/
|
|
virtual void setIOLayer(std::unique_ptr<IIO> ioLayer) = 0;
|
|
|
|
/**
|
|
* @brief Query a specific module directly
|
|
* @param name Name of the module to query
|
|
* @param input Input data to send to the module
|
|
* @return Response data from the module
|
|
*
|
|
* This provides direct access to module functionality for debugging,
|
|
* testing, or administrative purposes. The query bypasses normal
|
|
* execution flow and calls the module's process() method directly.
|
|
*/
|
|
virtual std::unique_ptr<IDataNode> queryModule(const std::string& name, const IDataNode& input) = 0;
|
|
|
|
/**
|
|
* @brief Get module system type identifier
|
|
* @return Module system type enum value for identification
|
|
*/
|
|
virtual ModuleSystemType getType() const = 0;
|
|
};
|
|
|
|
} // namespace grove
|