overmind-mcp 2.5.0 → 2.5.1

package/package.json

@@ -1,83 +1,114 @@
-{
-  "name": "overmind-mcp",
-  "version": "2.5.0",
-  "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.) et l'isolation mémoire (Private Memory Context).",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "overmind": "dist/bin/cli.js"
-  },
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    },
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "dist",
-    "assets",
-    "README.md"
-  ],
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "claude-code",
-    "ai-agent",
-    "llm",
-    "orchestration",
-    "automation"
-  ],
-  "author": "DeaMoN888",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/DeamonDev888/overmind-mcp.git"
-  },
-  "bugs": {
-    "url": "https://discord.gg/4AR82phtBz"
-  },
-  "homepage": "https://deamondev888.github.io/overmind-mcp/",
-  "engines": {
-    "node": ">=20.0.0 <25"
-  },
-  "devDependencies": {
-    "@changesets/cli": "^2.31.0",
-    "@eslint/js": "^9.39.2",
-    "@types/node": "^22.15.0",
-    "@types/pg": "^8.16.0",
-    "eslint": "^9.39.2",
-    "eslint-config-prettier": "^10.1.8",
-    "globals": "^17.1.0",
-    "prettier": "^3.8.1",
-    "rimraf": "^6.0.1",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.53.1",
-    "vitest": "^4.0.18"
-  },
-  "dependencies": {
-    "dotenv": "^17.3.1",
-    "fastmcp": "^3.33.0",
-    "overmind-postgres-mcp": "^1.2.4",
-    "pg": "^8.18.0",
-    "zod": "^4.2.1"
-  },
-  "scripts": {
-    "build": "tsc",
-    "rebuild": "rimraf dist && tsc",
-    "clean": "rimraf dist",
-    "start": "node --env-file=.env dist/bin/cli.js",
-    "dev": "node --watch --env-file=.env dist/bin/cli.js",
-    "build:fix": "pnpm run clean && pnpm install && pnpm run build",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "format": "prettier --write .",
-    "check-types": "tsc --noEmit",
-    "test": "vitest run",
-    "changeset": "changeset",
-    "version": "changeset version",
-    "release": "changeset publish",
-    "changelog": "changeset version && git add CHANGELOG.md"
-  }
-}
+{
+  "name": "overmind-mcp",
+  "version": "2.5.1",
+  "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",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "overmind": "./dist/bin/cli.js",
+    "overmind-setup": "./scripts/setup.mjs",
+    "overmind-postgres": "./scripts/postgres-manager.mjs",
+    "overmind-uninstall": "./scripts/uninstall.mjs"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "assets",
+    "README.md",
+    "docs",
+    "scripts",
+    "bin",
+    ".mcp.json.example"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "rebuild": "rimraf dist && tsc",
+    "clean": "rimraf dist",
+    "start": "node --no-warnings --env-file=.env dist/bin/cli.js",
+    "dev": "node --no-warnings --watch --env-file=.env dist/bin/cli.js",
+    "build:fix": "pnpm run clean && pnpm install && pnpm run build",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:install": "node scripts/test-installation.mjs",
+    "changeset": "changeset",
+    "version": "changeset version && node scripts/auto-changelog.mjs",
+    "release": "pnpm run build && changeset publish",
+    "prepublishOnly": "pnpm run rebuild",
+    "postinstall": "node scripts/postinstall.mjs",
+    "setup": "overmind-setup",
+    "setup:deps": "node scripts/install-dependencies.mjs",
+    "postgres:up": "overmind-postgres up",
+    "postgres:down": "overmind-postgres down",
+    "postgres:status": "overmind-postgres status",
+    "postgres:logs": "overmind-postgres logs",
+    "postgres:reset": "overmind-postgres reset"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude-code",
+    "ai-agent",
+    "llm",
+    "orchestration",
+    "automation",
+    "pgvector",
+    "docker",
+    "auto-installation"
+  ],
+  "author": "DeaMoN888",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DeamonDev888/overmind-mcp.git"
+  },
+  "bugs": {
+    "url": "https://discord.gg/4AR82phtBz"
+  },
+  "homepage": "https://deamondev888.github.io/overmind-mcp/",
+  "engines": {
+    "node": ">=20.0.0 <25"
+  },
+  "packageManager": "pnpm@10.18.0",
+  "devDependencies": {
+    "@changesets/cli": "^2.31.0",
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.6.2",
+    "@types/pg": "^8.20.0",
+    "@types/pino": "^7.0.5",
+    "eslint": "^10.3.0",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^17.6.0",
+    "prettier": "^3.8.3",
+    "rimraf": "^6.1.3",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.2",
+    "vitest": "^4.1.5"
+  },
+  "dependencies": {
+    "async-mutex": "^0.5.0",
+    "dotenv": "^17.4.2",
+    "fastmcp": "^4.0.1",
+    "overmind-postgres-mcp": "^1.2.0",
+    "pg": "^8.20.0",
+    "pino": "^10.3.1",
+    "pino-pretty": "^13.1.3",
+    "pino-roll": "^4.0.0",
+    "tinyglobby": "^0.2.16",
+    "tslib": "^2.8.1",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "tslib": "^2.0.0"
+  }
+}

package/scripts/auto-changelog.mjs

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+/**
+ * Auto-update CHANGELOG.md when version bumps
+ * Runs after `pnpm run version`
+ */
+
+import { readFileSync, writeFileSync } from 'fs';
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const rootDir = join(__dirname, '..');
+
+function getCurrentVersion() {
+  const pkg = JSON.parse(readFileSync(join(rootDir, 'package.json'), 'utf8'));
+  return pkg.version;
+}
+
+function getCommitsSinceLastTag() {
+  try {
+    const output = execSync('git describe --tags --abbrev=0 HEAD~1 2>/dev/null', {
+      encoding: 'utf8',
+      cwd: rootDir,
+    }).trim();
+
+    const commits = execSync(`git log ${output}..HEAD --oneline --no-merges`, {
+      encoding: 'utf8',
+      cwd: rootDir,
+    });
+
+    return commits.split('\n').filter(Boolean);
+  } catch {
+    return [];
+  }
+}
+
+function categorizeCommits(commits) {
+  const features = [];
+  const fixes = [];
+  const docs = [];
+  const infra = [];
+  const deps = [];
+
+  for (const commit of commits) {
+    const msg = commit.replace(/^[a-f0-9]+ /, '');
+    if (msg.startsWith('feat') || msg.startsWith('feat:')) {
+      features.push(msg);
+    } else if (msg.startsWith('fix') || msg.startsWith('fix:')) {
+      fixes.push(msg);
+    } else if (msg.startsWith('docs') || msg.startsWith('doc:')) {
+      docs.push(msg);
+    } else if (msg.startsWith('chore') || msg.startsWith('refactor') || msg.startsWith('infra')) {
+      infra.push(msg);
+    } else if (msg.startsWith('deps')) {
+      deps.push(msg);
+    } else {
+      infra.push(msg);
+    }
+  }
+
+  return { features, fixes, docs, infra, deps };
+}
+
+function formatChangelogSection(version, commits) {
+  const date = new Date().toISOString().split('T')[0];
+  const { features, fixes, docs, infra, deps } = categorizeCommits(commits);
+
+  let section = `## [${version}] - ${date}\n\n`;
+
+  if (features.length > 0) {
+    section += '### 🚀 Features\n\n';
+    for (const f of features) section += `- ${f}\n`;
+    section += '\n';
+  }
+
+  if (fixes.length > 0) {
+    section += '### 🐛 Fixes\n\n';
+    for (const f of fixes) section += `- ${f}\n`;
+    section += '\n';
+  }
+
+  if (docs.length > 0) {
+    section += '### 📝 Documentation\n\n';
+    for (const d of docs) section += `- ${d}\n`;
+    section += '\n';
+  }
+
+  if (infra.length > 0) {
+    section += '### 🔧 Infrastructure\n\n';
+    for (const i of infra) section += `- ${i}\n`;
+    section += '\n';
+  }
+
+  if (deps.length > 0) {
+    section += '### 📦 Dependencies\n\n';
+    for (const d of deps) section += `- ${d}\n`;
+    section += '\n';
+  }
+
+  return section;
+}
+
+function updateChangelog() {
+  const version = getCurrentVersion();
+  const commits = getCommitsSinceLastTag();
+
+  if (commits.length === 0) {
+    console.log('No commits to add to changelog');
+    return;
+  }
+
+  const changelogPath = join(rootDir, 'CHANGELOG.md');
+  let changelog = readFileSync(changelogPath, 'utf8');
+
+  // Remove existing placeholder if present
+  changelog = changelog.replace(`## [${version}] - YYYY-MM-DD\n\n---\n\n`, '');
+
+  const newSection = formatChangelogSection(version, commits);
+
+  // Insert after the header comment block
+  const insertPoint = changelog.indexOf('---\n\n## ');
+  if (insertPoint !== -1) {
+    changelog = changelog.slice(0, insertPoint + 5) + newSection + changelog.slice(insertPoint + 5);
+  }
+
+  writeFileSync(changelogPath, changelog);
+  console.log(`✅ CHANGELOG.md updated with v${version}`);
+}
+
+updateChangelog();

package/scripts/auto-install.mjs

@@ -0,0 +1,322 @@
+#!/usr/bin/env node
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * OVERMIND-MCP - INSTALLATION AUTOMATIQUE (POST-INSTALL)
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * Ce script est exécuté automatiquement après npm install -g
+ * Il installe et configure TOUT :
+ * - Docker Desktop (vérification)
+ * - PostgreSQL + pgvector (si absent)
+ * - Infrastructure complète
+ * - Invite l'utilisateur à voir les services dans Docker Desktop
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+
+import { execSync, spawn } from 'child_process';
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import { createInterface } from 'readline';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// CONFIG
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const INSTALL_DIR = join(
+  process.env.HOME || process.env.USERPROFILE || process.env.HOMEPATH,
+  '.overmind'
+);
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// UTILS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function logSection(title) {
+  console.log('\n╔══════════════════════════════════════════════════════════════════╗');
+  console.log(`║  ${title.padEnd(64)} ║`);
+  console.log('╚══════════════════════════════════════════════════════════════════╝');
+}
+
+function runCommand(cmd, options = {}) {
+  try {
+    return execSync(cmd, { stdio: 'pipe', encoding: 'utf8', ...options });
+  } catch {
+    return null;
+  }
+}
+
+async function promptYesNo(question) {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise((resolve) => {
+    rl.question(`${question} (y/N): `, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase().startsWith('y'));
+    });
+  });
+}
+
+async function runCommandAsync(cmd, description) {
+  return new Promise((resolve, reject) => {
+    console.log(`🔧 ${description}`);
+    console.log(`   $ ${cmd}`);
+
+    const child = spawn(cmd, { shell: true, stdio: 'inherit' });
+
+    child.on('close', (code) => {
+      if (code === 0) {
+        console.log(`✅ ${description} terminé`);
+        resolve(true);
+      } else {
+        console.error(`❌ Erreur (code ${code})`);
+        reject(new Error(`Command failed with code ${code}`));
+      }
+    });
+
+    child.on('error', (err) => {
+      console.error('❌ Erreur:', err.message);
+      reject(err);
+    });
+  });
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// INSTALLATION STEPS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+async function checkDocker() {
+  logSection('VÉRIFICATION DOCKER');
+
+  const version = runCommand('docker --version');
+  if (!version) {
+    console.log('❌ Docker non trouvé');
+    console.log('');
+    console.log('📥 Installation Docker requise:');
+
+    const platform = process.platform;
+    if (platform === 'win32') {
+      console.log('   Windows: https://www.docker.com/products/docker-desktop/');
+    } else if (platform === 'darwin') {
+      console.log('   macOS: https://www.docker.com/products/docker-desktop/');
+    } else {
+      console.log('   Linux: https://docs.docker.com/engine/install/');
+    }
+
+    const answer = await promptYesNo('Voulez-vous ouvrir le site de téléchargement ?');
+    if (answer) {
+      const url = 'https://www.docker.com/products/docker-desktop/';
+      const openCmd = process.platform === 'win32' ? 'start' :
+                      process.platform === 'darwin' ? 'open' : 'xdg-open';
+      runCommand(`${openCmd} ${url}`, { stdio: 'ignore' });
+      console.log('✅ Navigateur ouvert. Installez Docker, puis relancez: npm install -g overmind-mcp');
+    }
+
+    return false;
+  }
+
+  console.log('✅ Docker détecté:', version.trim());
+  return true;
+}
+
+async function setupInfrastructure() {
+  logSection('TÉLÉCHARGEMENT INFRASTRUCTURE');
+
+  mkdirSync(INSTALL_DIR, { recursive: true });
+
+  console.log('📥 Téléchargement docker-compose.yml...');
+
+  const composeUrl = 'https://raw.githubusercontent.com/DeamonDev888/overmind-mcp/main/docker-compose.yml';
+  const exportersUrl = 'https://raw.githubusercontent.com/DeamonDev888/overmind-mcp/main/docker-compose.exporters.yml';
+
+  try {
+    const composeData = runCommand(`curl -sL --max-time 30 ${composeUrl}`);
+    if (composeData) {
+      writeFileSync(join(INSTALL_DIR, 'docker-compose.yml'), composeData);
+      console.log('✅ docker-compose.yml téléchargé');
+    }
+
+    const exportersData = runCommand(`curl -sL --max-time 30 ${exportersUrl}`);
+    if (exportersData) {
+      writeFileSync(join(INSTALL_DIR, 'docker-compose.exporters.yml'), exportersData);
+      console.log('✅ docker-compose.exporters.yml téléchargé');
+    }
+
+    return true;
+  } catch (error) {
+    console.error('❌ Erreur téléchargement:', error.message);
+    return false;
+  }
+}
+
+async function startInfrastructure() {
+  logSection('DÉMARRAGE INFRASTRUCTURE DOCKER');
+
+  const composeFile = join(INSTALL_DIR, 'docker-compose.yml');
+
+  if (!existsSync(composeFile)) {
+    console.log('⚠️  docker-compose.yml non trouvé. Installation infrastructure skippée.');
+    return false;
+  }
+
+  try {
+    console.log('🚀 Démarrage des services...');
+    await runCommandAsync(
+      `cd "${INSTALL_DIR}" && docker-compose -f docker-compose.yml up -d`,
+      'Démarrage infrastructure'
+    );
+
+    console.log('');
+    console.log('⏳ Attente démarrage des services (15s)...');
+    await new Promise(resolve => setTimeout(resolve, 15000));
+
+    return true;
+  } catch (error) {
+    console.error('❌ Erreur démarrage:', error.message);
+    return false;
+  }
+}
+
+async function validateServices() {
+  logSection('VALIDATION DES SERVICES');
+
+  console.log('🔍 Vérification des containers...');
+  console.log('');
+
+  const services = [
+    { name: 'PostgreSQL', filter: 'overmind-postgres-pgvector', check: 'pg_isready' },
+  ];
+
+  let allRunning = true;
+
+  for (const service of services) {
+    const containerName = runCommand(
+      `docker ps --filter "name=${service.filter}" --format "{{.Names}}"`,
+      { stdio: 'pipe' }
+    );
+
+    if (containerName) {
+      const name = containerName.trim();
+      console.log(`✅ ${service.name}: ${name}`);
+    } else {
+      console.log(`❌ ${service.name}: Non trouvé`);
+      allRunning = false;
+    }
+  }
+
+  return allRunning;
+}
+
+async function createEnvConfig() {
+  const envFile = join(INSTALL_DIR, '.env');
+
+  if (!existsSync(envFile)) {
+    logSection('CRÉATION CONFIGURATION');
+
+    const envContent = `# OverMind-MCP Environment Configuration
+# Généré automatiquement par npm install
+
+# PostgreSQL
+POSTGRES_HOST=localhost
+POSTGRES_PORT=5432
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=overmind_temp_password_change_me
+POSTGRES_DB=overmind
+
+# OpenTelemetry (optionnel)
+OTEL_ENABLED=false
+
+# Workspace
+OVERMIND_WORKSPACE=${INSTALL_DIR}
+`;
+
+    writeFileSync(envFile, envContent);
+    console.log('✅ Configuration créée:', envFile);
+  }
+}
+
+function showSummary() {
+  console.log('\n╔══════════════════════════════════════════════════════════════════╗');
+  console.log('║              ✅ INSTALLATION TERMINÉE !                            ║');
+  console.log('╚══════════════════════════════════════════════════════════════════╝');
+  console.log('');
+  console.log('📋 SERVICES DISPONIBLES:');
+  console.log('');
+  console.log('┌─────────────────────────────────────────────────────────────────┐');
+  console.log('│ Ouvrez Docker Desktop pour voir tous les containers             │');
+  console.log('│                                                                 │');
+  console.log('│ URLs utiles:                                                   │');
+  console.log('│   • Prometheus: http://localhost:9090                          │');
+  console.log('│   • Grafana:      http://localhost:3000 (admin/admin)          │');
+  console.log('│   • Jaeger:       http://localhost:16686                         │');
+  console.log('│   • RabbitMQ:    http://localhost:15672 (guest/guest)         │');
+  console.log('│   • Temporal:     http://localhost:8233                         │');
+  console.log('└─────────────────────────────────────────────────────────────────┘');
+  console.log('');
+  console.log('📚 DOCUMENTATION:');
+  console.log('   • https://github.com/DeamonDev888/overmind-mcp');
+  console.log('   • https://www.npmjs.com/package/overmind-mcp');
+  console.log('');
+  console.log('🎉 PROCHAINE ÉTAPE:');
+  console.log('   • Créez votre premier agent: overmind create-agent');
+  console.log('   • Ou utilisez: overmind-setup --full');
+  console.log('');
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// MAIN
+// ═══════════════════════════════════════════════════════════════════════════════
+
+async function main() {
+  console.log('╔══════════════════════════════════════════════════════════════════╗');
+  console.log('║                                                                ║');
+  console.log('║     🚀 OVERMIND-MCP - INSTALLATION AUTOMATIQUE                     ║');
+  console.log('║     npm install -g overmind-mcp                                   ║');
+  console.log('║                                                                ║');
+  console.log('╚══════════════════════════════════════════════════════════════════╝');
+  console.log('');
+
+  // Step 1: Check Docker
+  const dockerOk = await checkDocker();
+  if (!dockerOk) {
+    console.log('\n⚠️  Relancez après installation de Docker: npm install -g overmind-mcp');
+    return;
+  }
+
+  // Step 2: Setup .env
+  await createEnvConfig();
+
+  // Step 3: Download docker-compose files
+  const downloaded = await setupInfrastructure();
+  if (!downloaded) {
+    console.log('\n⚠️  Impossible de télécharger l\'infrastructure. Continue en mode minimal.');
+    showSummary();
+    return;
+  }
+
+  // Step 4: Start infrastructure
+  const started = await startInfrastructure();
+  if (!started) {
+    console.log('\n⚠️  Infrastructure non démarrée. Continue en mode minimal.');
+    showSummary();
+    return;
+  }
+
+  // Step 5: Validate services
+  await validateServices();
+
+  // Show summary
+  showSummary();
+}
+
+// Run main
+main().catch((error) => {
+  console.error('\n❌ ERREUR FATALE:', error.message);
+  process.exit(1);
+});