overmind-mcp 3.1.0 → 3.1.1

package/README.md

@@ -205,6 +205,45 @@ La migration est recommandée mais pas obligatoire immédiatement.
 
 ---
 
+## ✅ Vérification post-install
+
+```bash
+overmind-verify
+```
+
+Vérifie: binaire, .env, PostgreSQL, port 3099, MCP health, Hermes CLI.
+
+---
+
+## 🌐 Webhook Tunnel (ngrok, optionnel)
+
+```bash
+# Installer ngrok (facultatif)
+npm install -g ngrok
+
+# Démarrer un tunnel vers le bridge
+overmind-ngrok                          # bridge :3100, tous providers
+overmind-ngrok --port 3149              # bt-sms :3149
+overmind-ngrok --provider telegram      # URL Telegram seulement
+```
+
+---
+
+## 🔑 Ethereum Key Generator
+
+Génère des clés EVM utilisées comme secrets pour les helpers Overmind:
+
+```bash
+# Après npm install -g overmind-mcp
+pip3 install eth-account
+overmind-keygen --cli --count 10
+```
+
+Le script `overmind-keygen` est inclus dans le package npm (`bin/overmind_keygen2000.py`).
+Dépendance Python: `eth-account` (`pip3 install eth-account`).
+
+---
+
 ![Aperçu du Terminal](assets/terminal_preview.png)
 
 _Projet propulsé par DeaMoN888 — 2026_

package/bin/install-overmind-native.sh

@@ -18,7 +18,14 @@ die()  { echo -e "${R}[FAIL]${N} $*"; exit 1; }
 
 # ---------- Constantes ----------
 OM_USER="${SUDO_USER:-$(whoami)}"
-OM_HOME="$(getent passwd "$OM_USER" | cut -d: -f6)"
+# Multi-OS home resolution (Linux: getent, macOS: dscl, fallback: eval ~)
+if command -v getent >/dev/null 2>&1; then
+  OM_HOME="$(getent passwd "$OM_USER" | cut -d: -f6)"
+elif command -v dscl >/dev/null 2>&1; then
+  OM_HOME="$(dscl . -read "/Users/$OM_USER" NFSHomeDirectory | awk '{print $2}')"
+else
+  OM_HOME="$(eval echo "~$OM_USER")"
+fi
 OM_DIR="$OM_HOME/.overmind"
 LOG_DIR="$OM_DIR/logs"
 PG_DB="overmind_memory"

package/bin/install-overmind-unix.sh

@@ -44,11 +44,25 @@ if ! command -v node &> /dev/null; then
 fi
 
 echo -e "${GREEN}[OK] Node.js détecté:${NC}"
+NODE_MAJ=$(node -p "process.versions.node.split('.')[0]")
 node --version
 echo -e "${GREEN}[OK] NPM détecté:${NC}"
 npm --version
 echo ""
 
+# Check Node version compatibility (overmind-postgres-mcp requires <25)
+if [ "$NODE_MAJ" -ge 25 ]; then
+  echo -e "${YELLOW}[WARN] Node $NODE_MAJ détecté. overmind-postgres-mcp nécessite Node < 25.${NC}"
+  if [ -d "$HOME/.nvm" ]; then
+    echo -e "${YELLOW}[INFO] Bascule vers Node 24 via nvm...${NC}"
+    \. "$HOME/.nvm/nvm.sh" 2>/dev/null
+    nvm install 24 2>/dev/null && nvm use 24 2>/dev/null && hash -r || true
+    echo -e "${GREEN}[OK] Node $(node --version) actif${NC}"
+  else
+    echo -e "${YELLOW}[INFO] Installez Node 24: nvm install 24 && nvm use 24${NC}"
+  fi
+fi
+
 # ============================================================
 # STEP 2: Installer OverMind-MCP
 # ============================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "overmind-mcp",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "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",
   "main": "dist/index.js",
@@ -12,7 +12,9 @@
     "overmind-postgres-mcp": "./scripts/postgres-manager.mjs",
     "overmind-uninstall": "./scripts/uninstall.mjs",
     "overmind-install-native": "./scripts/install-native.mjs",
-    "overmind-ngrok": "./scripts/ngrok-webhook.mjs"
+    "overmind-ngrok": "./scripts/ngrok-webhook.mjs",
+    "overmind-verify": "./scripts/verify-install.mjs",
+    "overmind-keygen": "./bin/overmind_keygen2000.py"
   },
   "exports": {
     ".": {

package/scripts/postinstall.mjs

@@ -198,6 +198,7 @@ async function setupPostgreSQL() {
       '--name', 'overmind-postgres-pgvector',
       '-p', '5432:5432',
       '-e', 'POSTGRES_PASSWORD=overmind_temp_password_change_me',
+      '-e', 'POSTGRES_DB=overmind_memory',
       '-e', 'POSTGRES_USER=postgres',
       '-v', 'overmind_postgres_data:/var/lib/postgresql/data',
       '--restart', 'unless-stopped',
@@ -307,25 +308,38 @@ function createEnvConfig() {
 
   // Créer .env minimal si n'existe pas
   if (!existsSync(envFile)) {
-    const envContent = `# OverMind-MCP Environment Configuration
+    // Generate random password for security
+    const crypto = await import('crypto');
+    const randomPassword = crypto.randomBytes(18).toString('base64url');
+
+    const envContent = `# OverMind-MCP Environment Configuration (v3.1)
 # Généré automatiquement par npm install
 
-# PostgreSQL
+# PostgreSQL + pgvector
 POSTGRES_HOST=localhost
 POSTGRES_PORT=5432
 POSTGRES_USER=postgres
-POSTGRES_PASSWORD=overmind_temp_password_change_me
-POSTGRES_DB=overmind_memory
+POSTGRES_PASSWORD=${randomPassword}
+POSTGRES_DATABASE=overmind_memory
 
 # OverMind
 OVERMIND_WORKSPACE=${INSTALL_DIR}
 OVERMIND_MEMORY_TYPE=postgres
+OVERMIND_LOG_LEVEL=info
+
+# Embeddings (Qwen 3 Embedding 8B - 4096D)
+OVERMIND_EMBEDDING_MODEL=qwen/qwen3-embedding-8b
+OVERMIND_EMBEDDING_DIMENSIONS=4096
+# OVERMIND_EMBEDDING_URL=https://openrouter.ai/api/v1
+# OVERMIND_EMBEDDING_KEY=sk-or-v1-...
 
 # OpenTelemetry (optionnel)
 OTEL_ENABLED=false
 `;
     writeFileSync(envFile, envContent);
-    log(COLORS.green, '✅ Configuration .env créée: ' + envFile);
+    log(COLORS.green, '✅ .env créé: ' + envFile);
+    log(COLORS.yellow, '⚠️  Password généré automatiquement. Sauvegardez-le!');
+    log(COLORS.cyan, '   Éditez .env pour ajouter vos clés API LLM.');
   }
 
   // Créer .env.postgres pour overmind-postgres-mcp

package/scripts/verify-install.mjs

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * OVERMIND-MCP — Post-Install Verification (Smoke Test)
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Vérifie que l'installation overmind-mcp est fonctionnelle:
+ *   1. Binaire overmind accessible dans le PATH
+ *   2. ~/.overmind/.env existe et contient les vars critiques
+ *   3. PostgreSQL est accessible (Docker ou natif)
+ *   4. Port 3099 est libre ou répond
+ *
+ * Usage:
+ *   overmind-verify          # après installation
+ *   node scripts/verify-install.mjs
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+
+import { execSync } from 'child_process';
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { createRequire } from 'module';
+
+const require = createRequire(import.meta.url);
+let PKG_VERSION = 'unknown';
+try {
+  const pkg = require('../../package.json');
+  PKG_VERSION = pkg.version;
+} catch {}
+
+const C = {
+  green:  '\x1b[32m',
+  yellow: '\x1b[33m',
+  red:    '\x1b[31m',
+  cyan:   '\x1b[36m',
+  bold:   '\x1b[1m',
+  reset:  '\x1b[0m',
+};
+
+const HOME = process.env.HOME || process.env.USERPROFILE || process.env.HOMEPATH || '';
+const OVERMIND_DIR = join(HOME, '.overmind');
+const ENV_FILE = join(OVERMIND_DIR, '.env');
+
+let passed = 0;
+let warnings = 0;
+let failed = 0;
+
+function ok(msg)   { console.log(`${C.green}  ✅${C.reset} ${msg}`); passed++; }
+function warn(msg) { console.log(`${C.yellow}  ⚠️ ${C.reset} ${msg}`); warnings++; }
+function fail(msg) { console.log(`${C.red}  ❌${C.reset} ${msg}`); failed++; }
+
+function runCmd(cmd) {
+  try { return execSync(cmd, { encoding: 'utf8', timeout: 5000, stdio: 'pipe' }).trim(); }
+  catch { return null; }
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+
+console.log(`\n${C.bold}${C.cyan}══════════════════════════════════════════════════════${C.reset}`);
+console.log(`${C.bold}${C.cyan}  🧪 Overmind Post-Install Verification v${PKG_VERSION}${C.reset}`);
+console.log(`${C.bold}${C.cyan}══════════════════════════════════════════════════════${C.reset}\n`);
+
+// 1. Binaire overmind
+console.log(`${C.bold}1. Binaire overmind${C.reset}`);
+const overmindBin = runCmd('which overmind') || runCmd('where overmind');
+if (overmindBin) {
+  ok(`overmind trouvé: ${overmindBin}`);
+} else {
+  fail('overmind non trouvé dans le PATH — rejeu: npm install -g overmind-mcp');
+}
+
+const version = runCmd('overmind --version 2>&1') || runCmd('overmind version 2>&1');
+if (version && (version.includes(PKG_VERSION) || version.length > 0)) {
+  ok(`Version: ${version.split('\n')[0]}`);
+} else {
+  warn('overmind --version ne répond pas (peut nécessiter .env configuré)');
+}
+
+// 2. .env
+console.log(`\n${C.bold}2. Configuration .env${C.reset}`);
+if (!existsSync(ENV_FILE)) {
+  fail(`${ENV_FILE} non trouvé — rejeu: overmind-setup`);
+} else {
+  ok('.env existe');
+  const envContent = readFileSync(ENV_FILE, 'utf8');
+
+  const requiredVars = [
+    'POSTGRES_HOST',
+    'POSTGRES_DATABASE',
+    'POSTGRES_PASSWORD',
+    'POSTGRES_USER',
+  ];
+
+  for (const varName of requiredVars) {
+    const re = new RegExp(`^${varName}=(.+)$`, 'm');
+    const match = envContent.match(re);
+    if (match && match[1].trim() && !match[1].includes('change_me')) {
+      ok(`${varName} = ${match[1].substring(0, 8)}...`);
+    } else if (match && match[1].includes('change_me')) {
+      warn(`${varName} contient encore le mot de passe par défaut — changez-le!`);
+    } else {
+      fail(`${varName} manquant dans .env`);
+    }
+  }
+
+  // Check for old POSTGRES_DB (v2.x compat)
+  if (envContent.match(/^POSTGRES_DB=/m) && !envContent.match(/^POSTGRES_DATABASE=/m)) {
+    warn('POSTGRES_DB détecté (v2.x) — renommez en POSTGRES_DATABASE (v3.x)');
+  }
+}
+
+// 3. PostgreSQL
+console.log(`\n${C.bold}3. PostgreSQL${C.reset}`);
+const pgDocker = runCmd('docker ps --filter "name=postgres" --format "{{.Names}}" 2>/dev/null');
+const pgNative = runCmd('pg_isready -h localhost -p 5432 2>/dev/null');
+
+if (pgDocker && pgDocker.length > 0) {
+  ok(`PostgreSQL Docker actif: ${pgDocker.split('\n')[0]}`);
+} else if (pgNative && pgNative.includes('accepting')) {
+  ok('PostgreSQL natif actif sur :5432');
+} else {
+  warn('PostgreSQL non détecté — démarrez-le: overmind-postgres-mcp up (Docker) ou sudo apt install postgresql (natif)');
+}
+
+// 4. Port 3099
+console.log(`\n${C.bold}4. Port Overmind MCP${C.reset}`);
+const portCheck = runCmd('lsof -iTCP:3099 -sTCP:LISTEN 2>/dev/null') || runCmd('ss -tlnp 2>/dev/null | grep 3099');
+if (portCheck && portCheck.length > 0) {
+  ok('Port 3099 en écoute — Overmind MCP est démarré');
+} else {
+  warn('Port 3099 libre — démarrez: overmind --transport httpStream --port 3099');
+}
+
+// 5. MCP health check
+if (portCheck) {
+  console.log(`\n${C.bold}5. MCP Health Check${C.reset}`);
+  const health = runCmd('curl -s -m 5 http://localhost:3099/mcp -X POST -H "Content-Type: application/json" -d \'{"jsonrpc":"2.0","id":1,"method":"ping","params":{}}\' 2>/dev/null');
+  if (health && (health.includes('jsonrpc') || health.includes('pong'))) {
+    ok('MCP :3099 répond au ping');
+  } else {
+    warn('MCP :3099 ne répond pas au ping (peut nécessiter auth token)');
+  }
+}
+
+// 6. Hermes (optionnel)
+console.log(`\n${C.bold}6. Hermes CLI (optionnel)${C.reset}`);
+const hermes = runCmd('which hermes 2>/dev/null');
+if (hermes) {
+  const hermesVersion = runCmd('hermes version 2>/dev/null');
+  ok(`Hermes trouvé: ${hermes} (${hermesVersion || 'version inconnue'})`);
+} else {
+  warn('Hermes non installé — requis pour les agents Hermes: pip install hermes-agent');
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+
+console.log(`\n${C.bold}${C.cyan}══════════════════════════════════════════════════════${C.reset}`);
+console.log(`${C.bold}  Résultat: ${C.green}${passed} OK${C.reset}${failed > 0 ? `, ${C.red}${failed} échec${C.reset}` : ''}${warnings > 0 ? `, ${C.yellow}${warnings} avertissement${warnings > 1 ? 's' : ''}${C.reset}` : ''}`);
+console.log(`${C.bold}${C.cyan}══════════════════════════════════════════════════════${C.reset}\n`);
+
+if (failed > 0) {
+  console.log(`${C.red}${C.bold}❌ Échec — corrigez les erreurs ci-dessus avant de continuer.${C.reset}\n`);
+  process.exit(1);
+} else if (warnings > 0) {
+  console.log(`${C.yellow}⚠️  Installation fonctionnelle avec avertissements.${C.reset}\n`);
+  process.exit(0);
+} else {
+  console.log(`${C.green}${C.bold}✅ Tout est prêt! Overmind MCP est opérationnel.${C.reset}\n`);
+  process.exit(0);
+}