overmind-mcp 2.0.6 → 2.0.8

package/README.md

@@ -1,145 +1,244 @@
-# OverMind-MCP
+<p align="center">
+  <img src="assets/overmind.png" alt="OverMind-MCP Banner" width="293" height="253">
+</p>
 
-Orchestrateur universel d'agents IA multi-modèles via MCP (Model Context Protocol).
+<div align="center">
 
-## 🚀 Démarrage Rapide
+# 🧠 OverMind-MCP
 
-```bash
-# Installation
-npm install -g 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.
 
-# Setup initial (interactif)
-overmind-setup
+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.
+
+---
 
-# Lancer un agent
-overmind run-agent --runner claude --agent-name mon-agent --prompt "Explique ce code"
+## 🚀 Commencer (Guide Facile)
+
+### Option 1 : Installation Globale NPM (Recommandé)
+
+```bash
+npm install -g overmind-mcp@latest
 ```
 
-## 📚 Documentation
+**🎯 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 :
 
-Toute la documentation est centralisée dans le dossier [`docs/`](./docs/) :
+```bash
+# Créer un agent simple
+overmind create-agent --name expert-python --runner claude --prompt "Tu es un expert Python..."
 
-### 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
+# Lancer une analyse
+overmind run-agent --runner claude --prompt "Analyse ce code..."
+```
 
-### 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
+**✅ Avantages :**
+- Installation immédiate
+- Pas de Docker requis
+- Fonctionne tout de suite
+- Idéal pour tester et utiliser les features de base
 
-### API & Référence
-- **[Prompts](./docs/api/prompt/)** - Documentation des prompts système
-- **[Tools](./docs/tools.md)** - Référence des outils MCP
+#### B. Mode Avancé (Avec Docker - Recommandé pour Production)
 
-### Changelog
-- **[CHANGELOG](./docs/changelog/CHANGELOG.md)** - Historique des versions
-- **[CHANGELOG.add](./docs/changelog/CHANGELOG.add.md)** - Notes de version v2.0.0
+Pour utiliser les **fonctionnalités avancées** (Swarm, Workflows long-running, Observabilité), vous avez besoin de l'infrastructure Docker.
 
-## 🎯 Fonctionnalités Principales
+**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)
 
-- **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)
+**🚀 Installation Docker Automatique :**
 
-## 📦 Scripts NPM
+L'installation **100% automatique** installe et configure **tout** pour vous :
 
 ```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
+npm install -g overmind-mcp@latest
 ```
 
-## 🔧 Configuration
+**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)
 
-Le fichier `.env` à la racine du projet contient toute la configuration :
+Si vous souhaitez contribuer ou avoir la toute dernière version :
 
 ```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
+# 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
 ```
 
-## 🏗️ Architecture
+---
+
+## 🎯 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,
+});
 ```
-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
+
+---
+      "args": ["-y", "overmind-mcp@latest"]
+    }
+  }
+}
 ```
 
-## 📖 Aide
+---
+
+### Option 2 : Installation Locale (Développement ou hébergement précis)
 
 ```bash
-# Aide générale
-overmind --help
+# 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
 
-# Aide sur une commande spécifique
-overmind run-agent --help
+# 3. Build le projet
+pnpm run build
+```
 
-# Lister les agents disponibles
-overmind list-agents
+Pour que l'agent puisse voir vos autres serveurs MCP locaux, copiez le fichier d'exemple :
 
-# Voir la config d'un agent
-overmind get-config --name mon-agent
+```bash
+cp .mcp.json.example .mcp.json
 ```
 
-## 🤝 Contribution
+**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"]
+    }
+  }
+}
+```
 
-Ce projet utilise Changesets pour la gestion des versions :
+---
 
-```bash
-# Créer un changeset
-pnpm changeset
+## 📦 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';
 
-# Versionner (après changesets)
-pnpm changeset version
+// 1. Initialisation
+updateConfig('./settings.json', './mcp.local.json');
 
-# Publier
-pnpm release
+// 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);
+}
 ```
 
-## 📄 Licence
+---
+
+## 📂 Structure du Projet
 
-MIT
+- `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`).
 
 ---
 
-**Documentation complète :** [`docs/`](./docs/)
+![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/dist/server.js

@@ -61,36 +61,36 @@ export function createServer(name = 'OverMind-MCP') {
     // ─── 1. run_agent ─────────────────────────────────────────────────────────────
     server.addTool({
         name: 'run_agent',
-        description: `Exécute une commande sur un agent IA via le runner spécifié.
-
-**Runners disponibles:**
- - claude: Claude Code (Nécessite 'create_agent' au préalable)
- - gemini: Gemini CLI
- - kilo: Kilocode (modes: code, architect, ask, debug, orchestrator)
- - qwencli: Qwen Code CLI (qwen -p)
- - openclaw: OpenClaw (openclaw message send)
- - cline: Cline (modes: plan, act)
- - opencode: OpenCode (opencode run)
- - hermes: Nous Hermes Agent (Nécessite 'create_agent' au préalable)
-
-**Modèles recommandés :**
-| Fournisseur | Modèle recommandé | Usage |
-| :--- | :--- | :--- |
-| **Mistral** | **Devstral 2** (\`codestral-latest\`) | Expert Coding & Développement |
-| **Mistral** | **Mistral Large 3** (\`mistral-large-latest\`) | Raisonnement & Architecture |
-| **Kilo** | **step 3.5 flash** | Polyvalent (262K context) |
-| **Kilo** | **free** | Modèle par défaut gratuit |
-
-**Parameters:**
-- runner: Type de runner (claude, gemini, etc.)
-- prompt: Instruction à envoyer à l'agent
-- agentName: Nom de l'agent (optionnel)
-- path: Répertoire de travail (CWD). Par défaut: dossier Overmind.
-- config: Répertoire racine de l'Overmind. Par défaut: dossier Overmind.
-
-**Exemples:**
-run_agent(runner: "claude", agentName: "expert_python", prompt: "Analyse ce code")
-run_agent(runner: "kilo", agentName: "architect", mode: "architect", prompt: "Conçois une API REST", path: "./my-project")
+        description: `Exécute une commande sur un agent IA via le runner spécifié.
+
+**Runners disponibles:**
+ - claude: Claude Code (Nécessite 'create_agent' au préalable)
+ - gemini: Gemini CLI
+ - kilo: Kilocode (modes: code, architect, ask, debug, orchestrator)
+ - qwencli: Qwen Code CLI (qwen -p)
+ - openclaw: OpenClaw (openclaw message send)
+ - cline: Cline (modes: plan, act)
+ - opencode: OpenCode (opencode run)
+ - hermes: Nous Hermes Agent (Nécessite 'create_agent' au préalable)
+
+**Modèles recommandés :**
+| Fournisseur | Modèle recommandé | Usage |
+| :--- | :--- | :--- |
+| **Mistral** | **Devstral 2** (\`codestral-latest\`) | Expert Coding & Développement |
+| **Mistral** | **Mistral Large 3** (\`mistral-large-latest\`) | Raisonnement & Architecture |
+| **Kilo** | **step 3.5 flash** | Polyvalent (262K context) |
+| **Kilo** | **free** | Modèle par défaut gratuit |
+
+**Parameters:**
+- runner: Type de runner (claude, gemini, etc.)
+- prompt: Instruction à envoyer à l'agent
+- agentName: Nom de l'agent (optionnel)
+- path: Répertoire de travail (CWD). Par défaut: dossier Overmind.
+- config: Répertoire racine de l'Overmind. Par défaut: dossier Overmind.
+
+**Exemples:**
+run_agent(runner: "claude", agentName: "expert_python", prompt: "Analyse ce code")
+run_agent(runner: "kilo", agentName: "architect", mode: "architect", prompt: "Conçois une API REST", path: "./my-project")
 run_agent(runner: "cline", agentName: "planner", mode: "plan", prompt: "Planifie l'implémentation")`,
         parameters: runAgentSchema,
         execute: wrapExecute('run_agent', runAgent),
@@ -98,20 +98,20 @@ run_agent(runner: "cline", agentName: "planner", mode: "plan", prompt: "Planifie
     // ─── 2. run_agents_parallel ─────────────────────────────────────────────────
     server.addTool({
         name: 'run_agents_parallel',
-        description: `🚀 Lance plusieurs agents IA EN PARALLÈLE depuis un seul appel MCP. Polyglotte (mixe runners/modèles). Retourne les résultats consolidés une fois tous terminés.
-
-**Cas d'usage :** Orchestration de flotte, rotation de tokens, tâches indépendantes simultanées.
-
-**Exemple :**
-run_agents_parallel(agents: [
-  { taskId: "build",  runner: "kilo", agentName: "mistral_1", prompt: "npm run build", path: "./project" },
-  { taskId: "lint",   runner: "kilo", agentName: "mistral_2", prompt: "npm run lint",  path: "./project" },
-  { taskId: "test",   runner: "kilo", agentName: "mistral_3", prompt: "npm test",      path: "./project" },
-  { taskId: "audit",  runner: "kilo", agentName: "mistral_4", prompt: "Analyse le fichier audit.md", path: "./project" },
-])
-
-**Options :**
-- waitAll (défaut: true) : attend tous les agents avant de retourner.
+        description: `🚀 Lance plusieurs agents IA EN PARALLÈLE depuis un seul appel MCP. Polyglotte (mixe runners/modèles). Retourne les résultats consolidés une fois tous terminés.
+
+**Cas d'usage :** Orchestration de flotte, rotation de tokens, tâches indépendantes simultanées.
+
+**Exemple :**
+run_agents_parallel(agents: [
+  { taskId: "build",  runner: "kilo", agentName: "mistral_1", prompt: "npm run build", path: "./project" },
+  { taskId: "lint",   runner: "kilo", agentName: "mistral_2", prompt: "npm run lint",  path: "./project" },
+  { taskId: "test",   runner: "kilo", agentName: "mistral_3", prompt: "npm test",      path: "./project" },
+  { taskId: "audit",  runner: "kilo", agentName: "mistral_4", prompt: "Analyse le fichier audit.md", path: "./project" },
+])
+
+**Options :**
+- waitAll (défaut: true) : attend tous les agents avant de retourner.
 - waitAll: false : retourne dès que le premier agent réussit (race mode).`,
         parameters: runAgentsParallelSchema,
         execute: wrapExecute('run_agents_parallel', runAgentsParallel),
@@ -119,13 +119,13 @@ run_agents_parallel(agents: [
     // ─── 3. create_agent ────────────────────────────────────────────────────────
     server.addTool({
         name: 'create_agent',
-        description: `Crée un nouvel agent (Prompt + Config) compatible avec tous les runners.
-
-**Runners supportés:** claude, gemini, kilo, qwencli, openclaw, cline, opencode, hermes
-
-**Exemples:**
-create_agent(name: "expert_python", runner: "claude", prompt: "Tu es un expert Python...")
-create_agent(name: "architecte", runner: "kilo", mode: "architect", prompt: "Tu es un architecte logiciel...")
+        description: `Crée un nouvel agent (Prompt + Config) compatible avec tous les runners.
+
+**Runners supportés:** claude, gemini, kilo, qwencli, openclaw, cline, opencode, hermes
+
+**Exemples:**
+create_agent(name: "expert_python", runner: "claude", prompt: "Tu es un expert Python...")
+create_agent(name: "architecte", runner: "kilo", mode: "architect", prompt: "Tu es un architecte logiciel...")
 create_agent(name: "planner", runner: "cline", mode: "plan", prompt: "Tu es un planificateur de tâches...")`,
         parameters: createAgentSchema,
         execute: createAgent,