overmind-mcp 2.0.7 → 2.0.8

package/README.md

@@ -1,145 +1,244 @@
-# OverMind-MCP
-
-Orchestrateur universel d'agents IA multi-modèles via MCP (Model Context Protocol).
-
-## 🚀 Démarrage Rapide
-
-```bash
-# Installation
-npm install -g overmind-mcp
-
-# Setup initial (interactif)
-overmind-setup
-
-# Lancer un agent
-overmind run-agent --runner claude --agent-name mon-agent --prompt "Explique ce code"
-```
-
-## 📚 Documentation
-
-Toute la documentation est centralisée dans le dossier [`docs/`](./docs/) :
-
-### Guides Utilisateur
-- **[README](./docs/guides/README.md)** - Guide principal
-- **[DEPLOYMENT](./docs/guides/DEPLOYMENT.md)** - Guide de déploiement complet
-- **[SWARM_USAGE](./docs/guides/SWARM_USAGE.md)** - Guide d'orchestration Swarm
-
-### Infrastructure
-- **[`docker-compose.yml`](./docker-compose.yml)** - Stack principale (9 services)
-- **[`docker-compose.exporters.yml`](./docker-compose.exporters.yml)** - Exporters de métriques
-- **[`scripts/`](./scripts/)** - Scripts d'installation et gestion
-
-### API & Référence
-- **[Prompts](./docs/api/prompt/)** - Documentation des prompts système
-- **[Tools](./docs/tools.md)** - Référence des outils MCP
-
-### Changelog
-- **[CHANGELOG](./docs/changelog/CHANGELOG.md)** - Historique des versions
-- **[CHANGELOG.add](./docs/changelog/CHANGELOG.add.md)** - Notes de version v2.0.0
-
-## 🎯 Fonctionnalités Principales
-
-- **Multi-Runners** : Claude, Gemini, Kilo, Hermes, OpenClaw, Cline, OpenCode, QwenCLI
-- **Fallback Tokens** : Rotation automatique sur quota exhausted (AUTH_FALLBACK_1/2/3)
-- **Swarm Orchestration** : Allocation dynamique de tâches aux agents spécialisés
-- **Long-Running Workflows** : Workflows Temporal jusqu'à 7 jours
-- **Observabilité** : OpenTelemetry, Prometheus, Grafana, Jaeger
-- **Vector DB** : PostgreSQL + pgvector (4096D)
-
-## 📦 Scripts NPM
-
-```bash
-# Build
-npm run build
-npm run rebuild
-
-# Qualité
-npm run lint
-npm run format
-npm run check-types
-npm run test
-
-# Infrastructure
-npm run deploy:infra      # Docker Compose stack principale
-npm run deploy:exporters  # Exporters de métriques
-npm run deploy:all        # Tout démarrer
-npm run deploy:logs       # Logs des services
-npm run deploy:status     # État des services
-
-# Setup
-npm run setup             # Setup interactif complet
-npm run setup:full        # Setup avec toutes les dépendances
-npm run setup:deps        # Installation dépendances Docker uniquement
-```
-
-## 🔧 Configuration
-
-Le fichier `.env` à la racine du projet contient toute la configuration :
-
-```bash
-# Modèles AI
-ANTHROPIC_MODEL=claude-sonnet-4-6
-ANTHROPIC_AUTH_TOKEN=sk-ant-...
-AUTH_FALLBACK_1=sk-ant-...
-AUTH_FALLBACK_2=sk-ant-...
-
-# OverMind
-OVERMIND_WORKSPACE=/chemin/vers/workspace
-
-# OpenTelemetry (optionnel)
-OTEL_ENABLED=true
-OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
-```
-
-## 🏗️ Architecture
-
-```
-Workflow/
-├── src/
-│   ├── services/       # Runners (Claude, Gemini, Kilo, etc.)
-│   ├── tools/          # Outils MCP (run_agent, create_agent, etc.)
-│   ├── lib/            # Bibliothèques internes
-│   └── bin/            # Binaires CLI
-├── docs/               # Documentation centralisée
-├── scripts/            # Scripts NPM (lien vers docs/infrastructure/scripts)
-└── dist/               # Build output
-```
-
-## 📖 Aide
-
-```bash
-# Aide générale
-overmind --help
-
-# Aide sur une commande spécifique
-overmind run-agent --help
-
-# Lister les agents disponibles
-overmind list-agents
-
-# Voir la config d'un agent
-overmind get-config --name mon-agent
-```
-
-## 🤝 Contribution
-
-Ce projet utilise Changesets pour la gestion des versions :
-
-```bash
-# Créer un changeset
-pnpm changeset
-
-# Versionner (après changesets)
-pnpm changeset version
-
-# Publier
-pnpm release
-```
-
-## 📄 Licence
-
-MIT
-
----
-
-**Documentation complète :** [`docs/`](./docs/)
+<p align="center">
+  <img src="assets/overmind.png" alt="OverMind-MCP Banner" width="293" height="253">
+</p>
+
+<div align="center">
+
+# 🧠 OverMind-MCP
+
+</div>
+
+_Orchestrateur universel agents IA multi-modeles via MCP pour piloter Claude-Code, Gemini-cli, QwenCli, Nous Hermes, Kilo/Cline, OpenClaw, GLM, Minimax, Kimi, Ollama et plus sans limite._
+
+<p align="center">
+  <a href="https://discord.gg/4AR82phtBz"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
+  <a href="https://deamondev888.github.io/overmind-mcp/"><img src="https://img.shields.io/badge/Documentation-Live-00fff5?style=for-the-badge&logo=google-chrome&logoColor=white" alt="Live Doc"></a>
+</p>
+
+**OverMind-MCP** est une conscience supérieure conçue pour orchestrer, commander et automatiser une flotte illimitée d'agents IA. Compatible avec **Claude-Code, Gemini-cli, QwenCli, Nous Hermes, Kilo/Cline, OpenClaw**, et prêt pour **GLM, Minimax, Kimi, Ollama** et bien d'autres. Plus qu'un simple runner, c'est le **Cortex Central** de votre infrastructure IA.
+
+Il transforme les outils CLI isolés en une force coordonnée, pilotable par API ou par MCP, capable d'exécuter des missions complexes en 2 secondes chrono. de creer et d orchestrer des pipeline de plusieurs agent. il est expert en outils MCP et peu etre scripté pour les faire fonctionner ensemble et les mettre en productions
+
+- 🔌 **Contrôle Total** : Lancez des missions complexes via MCP ou directement via le code (Claude, Gemini, QwenCli, Hermes).
+- 🏗️ **Architecture Pro** : Basé sur des services (`AgentManager`, `ClaudeRunner`, `PromptManager`) pour une stabilité maximale.
+- 🧠 **Mémoire Haute-Performance (4096D)** : Système RAG intégré via PostgreSQL + `pgvector` supportant les embeddings SOTA (Qwen 8B).
+- 🕵️ **Auto-Diagnostic CLI** : Détecte automatiquement les runners manquants et fournit les instructions/liens officiels pour l'installation.
+- 🛡️ **Mémoire Ségréguée** : Chaque agent peut posséder ses propres souvenirs isolés tout en ayant accès au socle de connaissances global.
+- 🛠️ **Capacités Étendues** : L'agent piloté peut utiliser VOS outils (Base de données, Scrapers, etc.).
+- 🤖 **Multi-Agents** : Créez, configurez et gérez des personnalités d'agents isolées (Prompts & Settings dédiés).
+- 📦 **Prêt pour l'Intégration** : Importable comme un module NPM dans vos autres projets.
+
+---
+
+## 🚀 Commencer (Guide Facile)
+
+### Option 1 : Installation Globale NPM (Recommandé)
+
+```bash
+npm install -g overmind-mcp@latest
+```
+
+**🎯 Après Installation NPM :**
+
+Une fois installé, vous avez 2 options :
+
+#### A. Mode Simple (Sans Docker - Recommandé pour débuter)
+
+OverMind fonctionne **immédiatement** sans infrastructure Docker :
+
+```bash
+# Créer un agent simple
+overmind create-agent --name expert-python --runner claude --prompt "Tu es un expert Python..."
+
+# Lancer une analyse
+overmind run-agent --runner claude --prompt "Analyse ce code..."
+```
+
+**✅ Avantages :**
+- Installation immédiate
+- Pas de Docker requis
+- Fonctionne tout de suite
+- Idéal pour tester et utiliser les features de base
+
+#### B. Mode Avancé (Avec Docker - Recommandé pour Production)
+
+Pour utiliser les **fonctionnalités avancées** (Swarm, Workflows long-running, Observabilité), vous avez besoin de l'infrastructure Docker.
+
+**Suivez le guide d'installation :**
+- 📄 [Guide d'installation rapide](https://github.com/DeamonDev888/overmind-mcp/blob/main/INSTALL.md)
+- 📄 [Guide de déploiement complet](https://github.com/DeamonDev888/overmind-mcp/blob/main/docs/guides/DEPLOYMENT.md)
+
+**🚀 Installation Docker Automatique :**
+
+L'installation **100% automatique** installe et configure **tout** pour vous :
+
+```bash
+npm install -g overmind-mcp@latest
+```
+
+**Ce qui est installé automatiquement :**
+- ✅ Docker Desktop (vérification)
+- ✅ PostgreSQL + pgvector (si absent)
+- ✅ **Toute** l'infrastructure Docker (RabbitMQ, Temporal, Prometheus, Grafana, Jaeger, Redis)
+- ✅ Configuration (.env, .mcp.json)
+- ✅ Validation de tous les services
+
+**Après installation, ouvrez Docker Desktop → onglet "Containers" pour voir tous les services.**
+
+**✅ Avantages du Mode Avancé :**
+- 🐳 RabbitMQ (Message Broker)
+- ⏱️ Temporal (Workflows long-running)
+- 📊 Observabilité (Prometheus, Grafana, Jaeger)
+- 🧠 Vector DB (PostgreSQL + pgvector)
+
+---
+
+### Option 2 : Installation Locale (Développement)
+
+Si vous souhaitez contribuer ou avoir la toute dernière version :
+
+```bash
+# 1. Cloner le repo
+git clone https://github.com/DeamonDev888/overmind-mcp.git
+cd overmind-mcp
+
+# 2. Installer les dépendances
+pnpm install
+
+# 3. Build le projet
+pnpm run build
+
+# 4. Optionnel : Setup Windows automatique
+node scripts/setup-windows.js
+```
+
+---
+
+## 🎯 Mode d'Emploi
+
+| Mode | Installation | Infrastructure | Features |
+|------|-------------|----------------|----------|
+| **Simple** | `npm install -g` | Aucune | OverMind base (agents, mémoire locale) |
+| **Avancé** | `npm install -g` + Docker | Docker Desktop | Toutes les features (Swarm, Workflows, Observabilité) |
+| **Dév** | Clone repo + `pnpm install` | Docker + PostgreSQL local | Toutes les features + accès au code source |
+
+**Recommandation :** Commencez par le **Mode Simple**, puis passez au **Mode Avancé** quand vous avez besoin des fonctionnalités avancées !
+
+---
+
+### Option 3 : Utilisation comme Bibliothèque
+
+Vous pouvez utiliser OverMind-MCP comme un module dans vos propres projets :
+
+```typescript
+import { runAgent, AgentManager, createSwarmOrchestrator } from 'overmind-mcp';
+
+// 1. Initialisation
+const manager = new AgentManager();
+await manager.createAgent('expert-seo', 'Tu es un expert SEO...', 'claude');
+
+// 2. Lancer une analyse
+const { content, isError } = await runAgent({
+  runner: 'claude',
+  agentName: 'expert-seo',
+  prompt: 'Analyse le site example.com',
+});
+
+// 3. Swarm Orchestration (mode avancé avec Docker)
+const swarm = createSwarmOrchestrator({
+  agents: [...],
+  tasks: [...],
+  maxParallelTasks: 5,
+});
+```
+
+---
+      "args": ["-y", "overmind-mcp@latest"]
+    }
+  }
+}
+```
+
+---
+
+### Option 2 : Installation Locale (Développement ou hébergement précis)
+
+```bash
+# 1. Cloner le repo localement
+git clone https://github.com/DeamonDev888/overmind-mcp overmind-mcp
+cd overmind-mcp
+
+# 2. Installer les dépendances
+pnpm install
+
+# 3. Build le projet
+pnpm run build
+```
+
+Pour que l'agent puisse voir vos autres serveurs MCP locaux, copiez le fichier d'exemple :
+
+```bash
+cp .mcp.json.example .mcp.json
+```
+
+**Configuration MCP (Client) pour l'Option 2 :**
+Pour connecter ce runner à un client en pointant vers votre version locale compilée :
+
+```json
+{
+  "mcpServers": {
+    "overmind": {
+      "command": "node",
+      "args": ["/LE_CHEMIN_ABSOLU_VERS_LE_DOSSIER_CLONE/dist/bin/cli.js"]
+    }
+  }
+}
+```
+
+---
+
+## 📦 Utilisation comme Bibliothèque
+
+Vous pouvez désormais importer le moteur du runner dans vos propres scripts :
+
+```typescript
+import { runAgent, AgentManager, updateConfig } from 'overmind-mcp';
+
+// 1. Initialisation
+updateConfig('./settings.json', './mcp.local.json');
+
+// 2. Gestion des agents
+const manager = new AgentManager();
+await manager.createAgent('expert-seo', 'Tu es un expert SEO...', 'claude-4-6-sonnet');
+
+// 3. Lancer une exécution via l'Orchestrateur Unifié
+const { content, isError } = await runAgent({
+  runner: 'claude',
+  agentName: 'expert-seo',
+  prompt: 'Analyse le site example.com',
+  autoResume: true,
+});
+
+if (!isError) {
+  console.log('🤖 Résultat:', content[0].text);
+}
+```
+
+---
+
+## 📂 Structure du Projet
+
+- `src/services/` : Le cœur du système (Logique métier isolée en services).
+- `src/tools/` : Les outils MCP qui appellent les services.
+- `src/bin/cli.ts` : Le point d'entrée exécutable pour le terminal.
+- `src/server.ts` : La définition du serveur FastMCP.
+- `src/index.ts` : Les exports publics (API de la bibliothèque).
+- `.claude/` : Stockage des agents (Prompts `.md` et Settings `.json`).
+
+---
+
+![Aperçu du Terminal](https://cdn.jsdelivr.net/npm/overmind-mcp@1.0.8/assets/terminal_preview.png)
+
+_Note : L'**OverMind** punit et martyrise les **OpenClaw** qui n'écoutent pas._ 😈
+
+_Projet propulsé par DeaMoN888 - 2026_

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "overmind-mcp",
-  "version": "2.0.7",
+  "version": "2.0.8",
   "preferGlobal": true,
   "description": "Orchestrateur universel agents IA multi-modeles via MCP. Inclut le protocole 'Custom-Nickname' pour identifier vos agents avec des surnoms originaux (The Chaos Prophet, Shadow Sniper, etc.), l'isolation mémoire (Private Memory Context) et le support pour QwenCli et Nous Hermes. Installation automatique des dépendances Docker (PostgreSQL, pgvector) inclus.",
   "type": "module",