feat: implement Spore framework class as main orchestration layer

- Add Spore class as unified interface for all core framework functionality
- Implement setup() and begin() methods for flexible initialization pattern
- Add service registration with addService() for both raw and smart pointers
- Provide accessor methods for core components (getTaskManager, getContext, etc.)
- Automatically include core services (Node, Network, Cluster, Task)
- Update all examples to use simplified Spore framework approach
- Fix circular dependency issues in include structure
- Remove setHostname and setApiPort configuration methods
- Add comprehensive documentation and usage examples

The Spore class encapsulates all core functionality from the base example
and provides a clean, unified API for the entire framework. Examples now
use just spore.setup() -> add services -> spore.begin() -> spore.loop().

examples/relay/README.md

@@ -1,10 +1,48 @@
 # Relay Service Example
 
-A minimal example that uses the framework's `NodeContext`, `NetworkManager`, `TaskManager`, and `ApiServer` to control a relay via REST and log status periodically as a task.
+A minimal example that demonstrates the Spore framework with a custom RelayService. The Spore framework automatically handles all core functionality (WiFi, clustering, API server, task management) while allowing easy registration of custom services.
 
 - Default relay pin: `GPIO0` (ESP-01). Override with `-DRELAY_PIN=<pin>`.
 - WiFi and API port are configured in `src/Config.cpp`.
 
+## Spore Framework Usage
+
+This example demonstrates the simplified Spore framework approach:
+
+```cpp
+#include <Arduino.h>
+#include "Spore.h"
+#include "RelayService.h"
+
+Spore spore({
+    {"app", "relay"},
+    {"device", "actuator"},
+    {"pin", String(RELAY_PIN)}
+});
+
+RelayService* relayService = nullptr;
+
+void setup() {
+    spore.setup();
+    
+    relayService = new RelayService(spore.getTaskManager(), RELAY_PIN);
+    spore.addService(relayService);
+    
+    spore.begin();
+}
+
+void loop() {
+    spore.loop();
+}
+```
+
+The Spore framework automatically provides:
+- WiFi connectivity management
+- Cluster discovery and management  
+- REST API server with core endpoints
+- Task scheduling and execution
+- Node status monitoring
+
 ## Build & Upload
 
 - ESP‑01S:
@@ -32,17 +70,17 @@ curl http://192.168.1.50/api/relay/status
 
 - Turn relay ON
 ```bash
-curl -X POST http://192.168.1.50/api/relay/set -d state=on
+curl -X POST http://192.168.1.50/api/relay -d state=on
 ```
 
 - Turn relay OFF
 ```bash
-curl -X POST http://192.168.1.50/api/relay/set -d state=off
+curl -X POST http://192.168.1.50/api/relay -d state=off
 ```
 
 - Toggle relay
 ```bash
-curl -X POST http://192.168.1.50/api/relay/set -d state=toggle
+curl -X POST http://192.168.1.50/api/relay -d state=toggle
 ```
 
 Notes: