StillHammer
d17ee5fbdc
- Renamed project from Celuna to AISSIA - Updated all documentation and configuration files - Codebase improvements and fixes 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
70 lines
2.4 KiB
Markdown
70 lines
2.4 KiB
Markdown
# 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 |
|