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

2.2 KiB

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

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