aissia/CLAUDE.md
StillHammer ac230b195d feat: Add MCP server mode (--mcp-server)
AISSIA can now run as an MCP server, exposing tools via JSON-RPC over stdio.
This allows external clients (like Claude Code) to use AISSIA's tools.

- Add MCPServer.hpp/cpp implementing MCP protocol
- Add --mcp-server flag to main.cpp
- Currently exposes 6 FileSystem tools
- Update documentation (CLAUDE.md, SUCCESSION.md)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 19:38:32 +08:00

68 lines
2.2 KiB
Markdown

# AISSIA - Assistant Personnel Intelligent
Assistant 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 |
| AIAssistantModule | TODO | Intégration LLM (Claude API) |
| LanguageLearningModule | TODO | Pratique langue cible |
| DataModule | TODO | SQLite persistence |
## 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
```
Aissia/
├── 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/aissia
# Hot-reload: rebuild modules seulement
cmake --build build --target modules
# Mode MCP Server (expose tools via JSON-RPC stdio)
./build/aissia --mcp-server
```
## Documentation
| Doc | Contenu |
|-----|---------|
| `docs/GROVEENGINE_GUIDE.md` | API complète IModule, IIO, IDataNode, hot-reload |
| `docs/project-overview.md` | Architecture AISSIA, phases dev |
| `docs/architecture/intelligent-document-retrieval.md` | AIAssistantModule: retrieval agentique, multi-provider LLM |
| `README.md` | Quick start, roadmap |