overmind-mcp 2.0.0 → 2.0.1

package/scripts/postinstall.mjs

@@ -0,0 +1,223 @@
+#!/usr/bin/env node
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * POSTINSTALL SCRIPT
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * Script exécuté automatiquement après `npm install -g overmind-mcp`
+ * Détecte l'environnement et guide l'utilisateur selon son setup
+ *
+ * Usage: (exécuté automatiquement par NPM)
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+
+import { execSync } from 'child_process';
+import { existsSync } from 'fs';
+import { platform } from 'os';
+import { join, resolve } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// DETECTION FUNCTIONS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function detectDocker() {
+  try {
+    const version = execSync('docker --version', { encoding: 'utf8', stdio: 'pipe' }).trim();
+    console.log('✅ Docker détecté:', version.split(',')[0]);
+    return true;
+  } catch {
+    console.log('❌ Docker non trouvé');
+    console.log('   → Installez Docker Desktop: https://www.docker.com/products/docker-desktop/');
+    return false;
+  }
+}
+
+function detectPostgreSQL() {
+  // Check PostgreSQL dans Docker
+  try {
+    const containers = execSync(
+      'docker ps --filter "name=postgres" --format "{{.Names}}"',
+      { encoding: 'utf8', stdio: 'pipe' }
+    ).trim();
+
+    if (containers) {
+      console.log('✅ PostgreSQL détecté (Docker):', containers);
+      return { hasPG: true, type: 'docker', name: containers };
+    }
+  } catch {}
+
+  // Check PostgreSQL natif
+  try {
+    execSync('psql --version', { stdio: 'pipe' });
+    console.log('✅ PostgreSQL détecté (natif)');
+    return { hasPG: true, type: 'native' };
+  } catch {}
+
+  console.log('❌ PostgreSQL non trouvé');
+  console.log('   → Will be installed by: overmind-setup --full');
+  return { hasPG: false };
+}
+
+function detectPgVector() {
+  try {
+    if (platform() === 'win32') {
+      // Check via Docker
+      const result = execSync(
+        'docker exec postgres pgvector -- pg_config --version',
+        { encoding: 'utf8', stdio: 'pipe' }
+      ).trim();
+      if (result.includes('pgvector')) {
+        console.log('✅ pgvector installé (Docker)');
+        return true;
+      }
+    } else {
+      // Check natif
+      const result = execSync('pg_config --version', { encoding: 'utf8', stdio: 'pipe' }).trim();
+      if (result.includes('pgvector')) {
+        console.log('✅ pgvector installé (natif)');
+        return true;
+      }
+    }
+  } catch {}
+
+  console.log('❌ pgvector non trouvé');
+  console.log('   → Will be installed by: overmind-setup --full');
+  return false;
+}
+
+function detectNodeVersion() {
+  try {
+    const version = execSync('node --version', { encoding: 'utf8' }).trim();
+    console.log('✅ Node.js:', version);
+    return true;
+  } catch {
+    console.log('❌ Node.js non trouvé');
+    return false;
+  }
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// MAIN
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function main() {
+  console.log('╔══════════════════════════════════════════════════════════════════╗');
+  console.log('║                                                                ║');
+  console.log('║        🧠 OVERMIND-MCP v2.0.0 - INSTALLATION                     ║');
+  console.log('║                                                                ║');
+  console.log('╚══════════════════════════════════════════════════════════════════╝');
+  console.log('');
+
+  console.log('🔍 Détection de votre environnement...');
+  console.log('');
+
+  // Detect components
+  const hasDocker = detectDocker();
+  const pgInfo = detectPostgreSQL();
+  const hasPgVector = detectPgVector();
+  const hasNode = detectNodeVersion();
+
+  console.log('');
+  console.log('╔══════════════════════════════════════════════════════════════════╗');
+  console.log('║  🎯 MODE DÉTECTÉ                                                ║');
+  console.log('╠══════════════════════════════════════════════════════════════════╣');
+
+  if (hasDocker && pgInfo.hasPG && hasPgVector) {
+    console.log('║  🚀 MODE COMPLET (Docker + PostgreSQL + pgvector)                   ║');
+    console.log('║                                                                ║');
+    console.log('║  OverMind fonctionne avec TOUTES les features:                    ║');
+    console.log('║  ✅ Swarm Orchestration                                            ║');
+    console.log('║  ✅ Workflows Long-Running                                        ║');
+    console.log('║  ✅ Vector DB (4096D)                                                 ║');
+    console.log('║  ✅ Observabilité complète                                           ║');
+    console.log('║                                                                ║');
+    console.log('║  Commande:                                                       ║');
+    console.log('║    overmind-setup --full                                          ║');
+  } else if (hasDocker) {
+    console.log('║  ⚡ MODE PARTIEL (Docker uniquement)                                ║');
+    console.log('║                                                                ║');
+    console.log('║  OverMind installera automatiquement:                         ║');
+    console.log('║  ✅ PostgreSQL + pgvector (Docker)                                ║');
+    console.log('║  ✅ RabbitMQ (Message Broker)                                     ║');
+    console.log('║  ✅ Temporal (Workflow Orchestrator)                                 ║');
+    console.log('║                                                                ║');
+    console.log('║  Commande:                                                       ║');
+    console.log('║    overmind-setup --full                                          ║');
+  } else {
+    console.log('║  ✅ MODE SIMPLE (sans dépendances Docker)                           ║');
+    console.log('║                                                                ║');
+    console.log('║  OverMind fonctionne immédiatement avec:                       ║');
+    console.log('║  ✅ Agents IA (Claude, Gemini, Kilo, etc.)                          ║');
+    console.log('║  ✅ Création/Configuration d'agents                                 ║');
+    console.log('║  ✅ Exécution de tâches complexes                                   ║');
+    console.log('║  ❌ Vector DB (nécessite Docker)                                    ║');
+    console.log('║  ❌ Workflows Long-Running (nécessite Docker)                        ║');
+    console.log('║                                                                ║');
+    console.log('║  Pour ACTIVER TOUTES les features:                              ║');
+    console.log('║  1. Installez Docker Desktop                                       ║');
+    console.log('║  2. Relancez: overmind-setup --full                                ║');
+  }
+
+  console.log('╚══════════════════════════════════════════════════════════════════╝');
+  console.log('');
+
+  // Show next steps
+  console.log('📋 PROCHAINES ÉTAPES:');
+  console.log('');
+
+  if (!pgInfo.hasPG || !hasPgVector) {
+    console.log('🔧 Étape 1: Installer les dépendances manquantes');
+    console.log('   → overmind-setup --full');
+    console.log('');
+    console.log('   Cette commande va:');
+    console.log('   - Installer PostgreSQL + pgvector en Docker (si absent)');
+    console.log('   - Créer la base de données OverMind');
+    console.log('   - Démarrer RabbitMQ + Temporal');
+    console.log('   - Configurer les fichiers nécessaires');
+  }
+
+  console.log('📚 DOCUMENTATION:');
+  console.log('   → Site: https://deamondev888.github.io/overmind-mcp/');
+  console.log('   → GitHub: https://github.com/DeamonDev888/overmind-mcp');
+  console.log('   → Discord: https://discord.gg/4AR82phtBz');
+  console.log('');
+
+  // Show basic usage examples
+  console.log('🚀 UTILISATION RAPIDE:');
+  console.log('');
+
+  if (!hasDocker) {
+    console.log('   Mode Simple (sans Docker):');
+    console.log('   ┌─────────────────────────────────────────────────────┐');
+    console.log('   │ overmind create-agent --name expert --runner claude \\ │');
+    console.log('   │   --prompt "Tu es un expert Python..."            │');
+    console.log('   │                                                      │');
+    console.log('   │ overmind run-agent --runner claude \\                │');
+    console.log('   │   --prompt "Analyse ce code..."                  │');
+    console.log('   └─────────────────────────────────────────────────────┘');
+  } else {
+    console.log('   Mode Avancé (avec Docker):');
+    console.log('   ┌─────────────────────────────────────────────────────┐');
+    console.log('   │ overmind-setup --full                                 │');
+    console.log('   │                                                      │');
+    console.log('   │ # Après setup complet:                               │');
+    console.log('   │ overmind create-agent ...                             │');
+    console.log('   │ overmind run-agent ...                                │');
+    console.log('   │                                                      │');
+    console.log('   │ # Gérer Docker:                                       │');
+    console.log('   │ overmind-infra up                                     │');
+    console.log('   │ overmind-infra down                                   │');
+    console.log('   │ overmind-infra status                                 │');
+    console.log('   └─────────────────────────────────────────────────────┘');
+  }
+
+  console.log('');
+  console.log('═════════════════════════════════════════════════════════════════');
+  console.log('');
+}
+
+// Run main
+main();

package/scripts/setup-overmind-db.mjs

@@ -0,0 +1,199 @@
+#!/usr/bin/env node
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * SETUP OVERMIND DATABASE (PostgreSQL Existant)
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * Script qui initialise la base de données OverMind dans votre PostgreSQL existant
+ *
+ * Prérequis:
+ *   - PostgreSQL + pgvector déjà en Docker (container: postgres-pgvector)
+ *   - Node.js installé
+ *
+ * Usage:
+ *   node scripts/setup-overmind-db.js
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+
+import { Client } from 'pg';
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// CONFIGURATION
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const DB_CONFIG = {
+  host: process.env.POSTGRES_HOST || 'localhost',
+  port: parseInt(process.env.POSTGRES_PORT || '5432', 10),
+  user: process.env.POSTGRES_USER || 'postgres',
+  password: process.env.POSTGRES_PASSWORD || 'postgres',
+  database: 'postgres', // Se connecter à postgres pour créer la DB
+};
+
+const OVERMIND_DB_NAME = 'overmind_memory';
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// FUNCTIONS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+async function checkPgVectorExtension(client) {
+  console.log('🔍 Vérification extension pgvector...');
+
+  try {
+    const res = await client.query(`
+      SELECT 1 FROM pg_available_extensions
+      WHERE name = 'vector'
+    `);
+
+    if (res.rows.length === 0) {
+      console.error('❌ pgvector n\'est pas installé !');
+      console.error('   Installez-le avec: CREATE EXTENSION vector;');
+      throw new Error('pgvector extension not found');
+    }
+
+    console.log('✅ Extension pgvector trouvée');
+  } catch (error) {
+    console.error('❌ Erreur vérification pgvector:', error.message);
+    throw error;
+  }
+}
+
+async function createDatabase(client) {
+  console.log(`🔍 Vérification base de données ${OVERMIND_DB_NAME}...`);
+
+  try {
+    // Vérifier si la DB existe déjà
+    const checkRes = await client.query(
+      'SELECT 1 FROM pg_database WHERE datname = $1',
+      [OVERMIND_DB_NAME]
+    );
+
+    if (checkRes.rows.length > 0) {
+      console.log(`ℹ️  Base de données ${OVERMIND_DB_NAME} existe déjà`);
+      return;
+    }
+
+    // Créer la DB
+    console.log(`🏗️  Création base de données ${OVERMIND_DB_NAME}...`);
+    await client.query(`CREATE DATABASE "${OVERMIND_DB_NAME}"`);
+    console.log(`✅ Base de données ${OVERMIND_DB_NAME} créée`);
+
+  } catch (error) {
+    if (error.code === '42P04') {
+      // Duplicate database - c'est ok
+      console.log(`ℹ️  Base de données ${OVERMIND_DB_NAME} existe déjà`);
+      return;
+    }
+    console.error('❌ Erreur création DB:', error.message);
+    throw error;
+  }
+}
+
+async function initializeOvermindDb() {
+  console.log(`🔍 Initialisation base de données ${OVERMIND_DB_NAME}...`);
+
+  const client = new Client({
+    ...DB_CONFIG,
+    database: OVERMIND_DB_NAME,
+  });
+
+  try {
+    await client.connect();
+    console.log(`✅ Connecté à ${OVERMIND_DB_NAME}`);
+
+    // Activer pgvector
+    console.log('🔧 Activation extension pgvector...');
+    await client.query('CREATE EXTENSION IF NOT EXISTS vector');
+    console.log('✅ Extension pgvector activée');
+
+    // Créer les tables (via init-db.sql)
+    const initSqlPath = join(__dirname, '../init-db.sql');
+    try {
+      const initSql = readFileSync(initSqlPath, 'utf8');
+      console.log('🔧 Exécution init-db.sql...');
+      await client.query(initSql);
+      console.log('✅ Tables initialisées');
+    } catch (error) {
+      console.warn('⚠️  Erreur init-db.sql (peut-être déjà exécuté):', error.message);
+    }
+
+  } finally {
+    await client.end();
+    console.log(`✅ Déconnecté de ${OVERMIND_DB_NAME}`);
+  }
+}
+
+async function main() {
+  console.log('╔══════════════════════════════════════════════════════════════════╗');
+  console.log('║  SETUP OVERMIND DATABASE (PostgreSQL Existant)                   ║');
+  console.log('╚══════════════════════════════════════════════════════════════════╝');
+  console.log('');
+
+  const client = new Client(DB_CONFIG);
+
+  try {
+    // Se connecter à postgres
+    console.log('🔌 Connexion à PostgreSQL...');
+    await client.connect();
+    console.log(`✅ Connecté à PostgreSQL (${DB_CONFIG.host}:${DB_CONFIG.port})`);
+    console.log('');
+
+    // Étape 1: Vérifier pgvector
+    await checkPgVectorExtension(client);
+    console.log('');
+
+    // Étape 2: Créer la DB
+    await createDatabase(client);
+    console.log('');
+
+    // Fermer la connexion postgres
+    await client.end();
+
+    // Étape 3: Initialiser la DB OverMind
+    await initializeOvermindDb();
+
+    console.log('');
+    console.log('╔══════════════════════════════════════════════════════════════════╗');
+    console.log('║  ✅ SETUP TERMINÉ AVEC SUCCÈS                                   ║');
+    console.log('║                                                                ║');
+    console.log('║  Prochaine étape:                                               ║');
+    console.log('║  1. docker-compose -f docker-compose.overmind.yml up -d      ║');
+    console.log('║  2. pnpm run build                                            ║');
+    console.log('║  3. pnpm run dev                                              ║');
+    console.log('╚══════════════════════════════════════════════════════════════════╝');
+
+  } catch (error) {
+    console.error('');
+    console.error('╔══════════════════════════════════════════════════════════════════╗');
+    console.error('║  ❌ ERREUR SETUP                                                  ║');
+    console.error('╚══════════════════════════════════════════════════════════════════╝');
+    console.error('');
+    console.error('Erreur:', error.message);
+
+    if (error.code === 'ECONNREFUSED') {
+      console.error('');
+      console.error('💡 Assurez-vous que PostgreSQL est démarré:');
+      console.error('   docker ps | grep postgres-pgvector');
+      console.error('');
+      console.error('💡 Vérifiez les credentials dans .env:');
+      console.error('   POSTGRES_HOST=' + DB_CONFIG.host);
+      console.error('   POSTGRES_PORT=' + DB_CONFIG.port);
+      console.error('   POSTGRES_USER=' + DB_CONFIG.user);
+      console.error('   POSTGRES_PASSWORD=*** (votre mot de passe)');
+    }
+
+    process.exit(1);
+  }
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// MAIN
+// ═══════════════════════════════════════════════════════════════════════════════
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main();
+}