# Celuna AI by Etheryale 🌙✨

Assistant céleste pour gérer le temps, l'hyperfocus et l'apprentissage de langues. Basé sur **GroveEngine** (C++17 hot-reload module system).

## Statut

| Module | Status | Description |
|--------|--------|-------------|
| SchedulerModule | ✅ Fait | Détection hyperfocus, rappels pauses |
| NotificationModule | ✅ Fait | Alertes système, TTS, priorités |
| MonitoringModule | ✅ Fait | Suivi activité utilisateur, classification apps |
| AIModule | ✅ Fait | Agent LLM conversationnel (Claude Sonnet 4) |
| VoiceModule | ✅ Fait | TTS/STT via services |
| StorageModule | ✅ Fait | Persistence SQLite via service |
| WebModule | ✅ Fait | Requêtes HTTP via IIO pub/sub |

## Règles de Développement

### Contraintes Modules
- **200-300 lignes max** par module
- **Logique métier pure** (pas de threading/network dans les modules)
- **Communication JSON** via IIO pub/sub
- **Hot-reload ready** : sérialiser tout l'état dans `getState()`

### NEVER
- `cmake ..` ou `#include "../"` (dépendances parent)
- Modules > 300 lignes
- Infrastructure dans les modules

### ALWAYS
- Build autonome depuis le module
- JSON pour toute communication inter-modules
- Topics pub/sub : `module:event` (ex: `scheduler:hyperfocus_detected`)

## Structure

```
Celuna/
├── src/
│   ├── main.cpp                    # Main loop 10Hz + hot-reload
│   └── modules/                    # Modules implémentés
│       ├── SchedulerModule.*
│       └── NotificationModule.*
├── config/                         # JSON config par module
├── external/GroveEngine/           # Engine (symlink)
└── docs/                           # Documentation détaillée
```

## Build

```bash
cmake -B build && cmake --build build -j4
./build/celuna

# Hot-reload: rebuild modules seulement
cmake --build build --target modules

# Mode MCP Server (expose tools via JSON-RPC stdio)
./build/celuna --mcp-server
```

## Documentation

| Doc | Contenu |
|-----|---------|
| `docs/GROVEENGINE_GUIDE.md` | API complète IModule, IIO, IDataNode, hot-reload |
| `docs/project-overview.md` | Architecture Celuna, phases dev |
| `docs/architecture/intelligent-document-retrieval.md` | AIAssistantModule: retrieval agentique, multi-provider LLM |
| `README.md` | Quick start, roadmap |
