aissia/CLAUDE.md

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

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