overmind-mcp 2.0.5 → 2.0.7

package/README.md

@@ -1,145 +1,145 @@
-# 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/)
+# 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/)

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,