overmind-mcp 3.4.2 → 3.5.0

package/scripts/postinstall.mjs

@@ -13,8 +13,18 @@
  */
 
 import { execSync, spawn } from 'child_process';
-import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
-import { join } from 'path';
+import {
+  existsSync,
+  mkdirSync,
+  writeFileSync,
+  readFileSync,
+  lstatSync,
+  renameSync,
+  symlinkSync,
+  unlinkSync,
+  cpSync,
+} from 'fs';
+import { join, basename } from 'path';
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
 import { randomBytes } from 'crypto';
@@ -294,6 +304,108 @@ async function installPostgresMCP() {
   }
 }
 
+function copyIfMissing(src, dest) {
+  try {
+    if (!existsSync(src) || existsSync(dest)) return false;
+    cpSync(src, dest, { recursive: true, preserveTimestamps: true });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function alignHermesHome() {
+  logSection('ALIGNEMENT HERMES_HOME');
+
+  // Windows Desktop utilise %LOCALAPPDATA%\\hermes. Ne pas symlinker ~/.hermes sur Windows.
+  if (process.platform === 'win32') {
+    log(COLORS.cyan, 'Windows détecté: Hermes Desktop utilise %LOCALAPPDATA%\\hermes. Symlink ~/.hermes ignoré.');
+    return true;
+  }
+
+  const home = process.env.HOME || process.env.USERPROFILE || process.env.HOMEPATH;
+  const overmindHermes = join(INSTALL_DIR, 'hermes');
+  const nativeHermes = join(home, '.hermes');
+  const profilesDir = join(overmindHermes, 'profiles');
+
+  mkdirSync(profilesDir, { recursive: true });
+  mkdirSync(join(overmindHermes, 'distributions'), { recursive: true });
+
+  try {
+    if (!existsSync(nativeHermes)) {
+      symlinkSync(overmindHermes, nativeHermes, 'dir');
+      log(COLORS.green, `✅ Symlink créé: ~/.hermes → ${overmindHermes}`);
+      return true;
+    }
+
+    const stat = lstatSync(nativeHermes);
+
+    if (stat.isSymbolicLink()) {
+      const target = runCommand(`readlink "${nativeHermes}"`)?.trim();
+      if (target === overmindHermes) {
+        log(COLORS.green, '✅ ~/.hermes pointe déjà vers ~/.overmind/hermes');
+        return true;
+      }
+      log(COLORS.yellow, `⚠️ ~/.hermes pointe vers ${target || '(inconnu)'} — correction`);
+      unlinkSync(nativeHermes);
+      symlinkSync(overmindHermes, nativeHermes, 'dir');
+      log(COLORS.green, '✅ Symlink ~/.hermes corrigé');
+      return true;
+    }
+
+    if (!stat.isDirectory()) {
+      log(COLORS.yellow, '⚠️ ~/.hermes existe mais n’est pas un dossier — backup + symlink');
+    } else {
+      log(COLORS.yellow, '⚠️ Dual-path détecté: ~/.hermes est un vrai dossier — migration non destructive');
+    }
+
+    // Copier les profils de ~/.hermes/profiles vers ~/.overmind/hermes/profiles sans écraser.
+    const nativeProfiles = join(nativeHermes, 'profiles');
+    if (existsSync(nativeProfiles)) {
+      for (const entry of runCommand(`find "${nativeProfiles}" -mindepth 1 -maxdepth 1 -type d 2>/dev/null`)?.split('\n') || []) {
+        if (!entry.trim()) continue;
+        const name = basename(entry.trim());
+        const destProfile = join(profilesDir, name);
+        mkdirSync(destProfile, { recursive: true });
+        for (const file of ['config.yaml', 'SOUL.md', '.env', '.mcp.json', 'profile.yaml', 'workspace.yaml', 'auth.json', 'state.db']) {
+          if (copyIfMissing(join(entry.trim(), file), join(destProfile, file))) {
+            log(COLORS.cyan, `   Copie profil ${name}/${file}`);
+          }
+        }
+        for (const dir of ['skills', 'memories', 'cron', 'hooks', 'sessions']) {
+          if (copyIfMissing(join(entry.trim(), dir), join(destProfile, dir))) {
+            log(COLORS.cyan, `   Copie profil ${name}/${dir}/`);
+          }
+        }
+      }
+    }
+
+    // Copier les fichiers globaux sans écraser.
+    for (const file of ['config.yaml', 'auth.json', '.env', '.mcp.json', 'SOUL.md', 'state.db']) {
+      if (copyIfMissing(join(nativeHermes, file), join(overmindHermes, file))) {
+        log(COLORS.cyan, `   Copie global ${file}`);
+      }
+    }
+    for (const dir of ['skills', 'memories', 'cron', 'hooks', 'sessions']) {
+      if (copyIfMissing(join(nativeHermes, dir), join(overmindHermes, dir))) {
+        log(COLORS.cyan, `   Copie global ${dir}/`);
+      }
+    }
+
+    const backup = `${nativeHermes}.backup.${new Date().toISOString().replace(/[-:T.Z]/g, '').slice(0, 14)}`;
+    renameSync(nativeHermes, backup);
+    symlinkSync(overmindHermes, nativeHermes, 'dir');
+    log(COLORS.green, `✅ Symlink créé: ~/.hermes → ${overmindHermes}`);
+    log(COLORS.green, `✅ Backup conservé: ${backup}`);
+    log(COLORS.green, '✅ Aucune donnée effacée');
+    return true;
+  } catch (error) {
+    log(COLORS.yellow, `⚠️ Alignement ~/.hermes échoué: ${error.message}`);
+    log(COLORS.cyan, '   Fix manuel: mv ~/.hermes ~/.hermes.backup.$(date +%Y%m%d%H%M%S) && ln -s ~/.overmind/hermes ~/.hermes');
+    return false;
+  }
+}
+
 function createEnvConfig() {
   logSection('CRÉATION CONFIGURATION');
 
@@ -531,6 +643,7 @@ async function main() {
   console.log('  ✓ Démarrer PostgreSQL + pgvector');
   console.log('  ✓ Copier .env.example → .env');
   console.log('  ✓ Copier .mcp.json.example → .mcp.json');
+  console.log('  ✓ Aligner Hermes: ~/.hermes → ~/.overmind/hermes (Linux/macOS)');
   console.log('  ✓ Valider PostgreSQL');
   console.log('');
 
@@ -553,6 +666,9 @@ async function main() {
   // Step 2: Setup .env and .mcp.json (BEFORE Docker so password is shared)
   createEnvConfig();
 
+  // Step 2b: Align Hermes roots (Linux/macOS npm -g path hygiene)
+  alignHermesHome();
+
   // Step 3: Setup PostgreSQL (uses PG_PASSWORD)
   await setupPostgreSQL();
 

package/scripts/setup-windows.js

@@ -234,7 +234,7 @@ async function main() {
 🌐 CONNEXION:
    🗄️  PostgreSQL:    localhost:5432
    👤 User:         postgres
-   🔑 Password:     overmind_temp_password_change_me (À CHANGER !)
+   🔑 Password:     (généré automatiquement — voir ~/.overmind/.env)
 
 🚀 POUR DÉMARRER OVERMIND:
    pnpm run dev      # Mode développement

package/scripts/setup.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 /**
  * ═══════════════════════════════════════════════════════════════════════════════
  * SETUP SCRIPT - Installation Automatique OverMind
@@ -18,6 +18,7 @@
 import { execSync, spawn } from 'child_process';
 import { copyFileSync, existsSync, mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
+import { randomBytes } from 'crypto';
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
 import { createInterface } from 'readline';
@@ -175,10 +176,12 @@ async function installPostgreSQL() {
     execSync('docker pull pgvector/pgvector:pg16', { stdio: 'inherit' });
 
     console.log('🚀 Démarrage container PostgreSQL...');
+    const pgPwd = randomBytes(18).toString('base64url');
     const runCommand = `docker run -d --name overmind-postgres-pgvector \\
       -p 5432:5432 \\
-      -e POSTGRES_PASSWORD=overmind_temp_password_change_me \\
+      -e POSTGRES_PASSWORD=${pgPwd} \\
       -e POSTGRES_USER=postgres \\
+      -e POSTGRES_DB=overmind_memory \\
       -v overmind_postgres_data:/var/lib/postgresql/data \\
       --restart unless-stopped \\
       pgvector/pgvector:pg16`;

package/scripts/verify-install.mjs

@@ -39,6 +39,8 @@ const C = {
 
 const HOME = process.env.HOME || process.env.USERPROFILE || process.env.HOMEPATH || '';
 const OVERMIND_DIR = join(HOME, '.overmind');
+const OVERMIND_HERMES_DIR = join(OVERMIND_DIR, 'hermes');
+const NATIVE_HERMES_DIR = join(HOME, '.hermes');
 const ENV_FILE = join(OVERMIND_DIR, '.env');
 
 let passed = 0;
@@ -142,8 +144,31 @@ if (portCheck) {
   }
 }
 
-// 6. Hermes (optionnel)
-console.log(`\n${C.bold}6. Hermes CLI (optionnel)${C.reset}`);
+// 6. Hermes root alignment
+console.log(`\n${C.bold}6. Hermes root alignment${C.reset}`);
+if (process.platform === 'win32') {
+  ok('Windows Desktop: racine attendue = %LOCALAPPDATA%\\hermes (pas de symlink ~/.hermes)');
+} else if (!existsSync(OVERMIND_HERMES_DIR)) {
+  warn('~/.overmind/hermes absent — sera créé par overmind-install-native ou postinstall');
+} else if (!existsSync(NATIVE_HERMES_DIR)) {
+  warn('~/.hermes absent — postinstall devrait créer le symlink vers ~/.overmind/hermes');
+} else {
+  const linkTarget = runCmd(`readlink "${NATIVE_HERMES_DIR}" 2>/dev/null`);
+  if (linkTarget === OVERMIND_HERMES_DIR) {
+    ok('~/.hermes → ~/.overmind/hermes (symlink complet OK)');
+  } else {
+    const nativeProfilesTarget = runCmd(`readlink "${NATIVE_HERMES_DIR}/profiles" 2>/dev/null`);
+    const nativeConfigTarget = runCmd(`readlink "${NATIVE_HERMES_DIR}/config.yaml" 2>/dev/null`);
+    if (nativeProfilesTarget && nativeConfigTarget) {
+      warn('Mode hybride détecté: ~/.hermes est un vrai dossier mais profiles/config.yaml sont symlinkés. Rejeu recommandé: npm i -g overmind-mcp@latest ou overmind-install-native');
+    } else {
+      warn('Dual-path détecté: ~/.hermes n’est pas symlinké vers ~/.overmind/hermes. Risque de config divergente.');
+    }
+  }
+}
+
+// 7. Hermes (optionnel)
+console.log(`\n${C.bold}7. Hermes CLI (optionnel)${C.reset}`);
 const hermes = runCmd('which hermes 2>/dev/null');
 if (hermes) {
   const hermesVersion = runCmd('hermes version 2>/dev/null');

package/scripts/migrate-hermes-home.mjs

@@ -1,133 +0,0 @@
-#!/usr/bin/env node
-/**
- * migrate-hermes-home.js — One-shot migration for HERMES_HOME path change.
- *
- * Background: HERMES_HOME was previously computed from process.cwd() which
- * produced different paths depending on where the runner was launched from.
- * Starting with Overmind 2.8.27, HERMES_HOME is resolved from
- * OVERMIND_AGENT_HOME or $HOME/.overmind/hermes/agent_<name>/.hermes.
- *
- * This script migrates any existing state from the legacy workspace-relative
- * paths (e.g. <workflow>/.overmind/hermes/agent_<name>/) to the new canonical
- * HOME-based path. Safe to run multiple times.
- *
- * Usage:  node scripts/migrate-hermes-home.js [--dry-run]
- */
-
-import fs from 'fs';
-import path from 'path';
-import os from 'os';
-
-const args = process.argv.slice(2);
-const dryRun = args.includes('--dry-run');
-
-function log(msg) {
-  process.stdout.write(`[migrate-hermes-home] ${msg}\n`);
-}
-
-function findLegacyBases(workspaceDir) {
-  const legacy = [];
-  for (const sub of ['.overmind/hermes', '.overmind/hermes/agent_*']) {
-    const full = path.join(workspaceDir, sub);
-    if (fs.existsSync(full)) {
-      try {
-        const entries = fs.readdirSync(full, { withFileTypes: true });
-        for (const e of entries) {
-          if (e.isDirectory() && e.name.startsWith('agent_')) {
-            legacy.push(path.join(full, e.name));
-          } else if (e.isDirectory() && e.name === 'central') {
-            legacy.push(path.join(full, e.name));
-          }
-        }
-      } catch { /* ignore */ }
-    }
-  }
-  return legacy;
-}
-
-function getCanonicalBase(platform) {
-  const homeBase = process.env.LOCALAPPDATA
-    || process.env.USERPROFILE
-    || os.homedir();
-  return platform === 'win32'
-    ? path.join(homeBase, 'overmind', 'hermes')
-    : path.join(homeBase, '.overmind', 'hermes');
-}
-
-function migrateOne(src, dst) {
-  // src = legacy agent dir (e.g. <workspace>/.overmind/hermes/agent_foo)
-  // dst = canonical agent dir (e.g. ~/.overmind/hermes/agent_foo)
-  if (fs.existsSync(dst)) {
-    log(`  SKIP: destination already exists: ${dst}`);
-    return false;
-  }
-  if (dryRun) {
-    log(`  DRY-RUN: would move ${src} -> ${dst}`);
-    return true;
-  }
-  // Make parent if missing
-  fs.mkdirSync(path.dirname(dst), { recursive: true });
-  // Use rename for atomicity (works on same-filesystem; cross-fs would need copy+delete)
-  try {
-    fs.renameSync(src, dst);
-    log(`  MOVED: ${src} -> ${dst}`);
-    return true;
-  } catch (e) {
-    if (e.code === 'EXDEV') {
-      // Cross-device: copy + delete
-      log(`  CROSS-FS: copying ${src} -> ${dst}`);
-      copyDirSync(src, dst);
-      fs.rmSync(src, { recursive: true, force: true });
-      return true;
-    }
-    throw e;
-  }
-}
-
-function copyDirSync(src, dst) {
-  fs.mkdirSync(dst, { recursive: true });
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    const s = path.join(src, entry.name);
-    const d = path.join(dst, entry.name);
-    if (entry.isDirectory()) {
-      copyDirSync(s, d);
-    } else if (entry.isFile()) {
-      fs.copyFileSync(s, d);
-    }
-  }
-}
-
-function main() {
-  const workspaceDir = process.env.OVERMIND_WORKSPACE
-    || process.cwd();
-  const platform = process.platform;
-  const canonicalBase = getCanonicalBase(platform);
-
-  log(`workspace:  ${workspaceDir}`);
-  log(`platform:   ${platform}`);
-  log(`canonical:  ${canonicalBase}`);
-  log(`mode:       ${dryRun ? 'DRY-RUN' : 'LIVE'}`);
-  log('');
-
-  const legacy = findLegacyBases(workspaceDir);
-  if (legacy.length === 0) {
-    log('No legacy .overmind directories found. Nothing to migrate.');
-    return;
-  }
-
-  let moved = 0;
-  for (const src of legacy) {
-    const name = path.basename(src);
-    const dst = path.join(canonicalBase, name);
-    log(`Migrating ${name}:`);
-    if (migrateOne(src, dst)) moved++;
-  }
-
-  log('');
-  log(`Done. ${moved}/${legacy.length} agent directories migrated.`);
-  if (dryRun) {
-    log('Re-run without --dry-run to actually perform the migration.');
-  }
-}
-
-main();

package/scripts/migrate-to-profiles.mjs

@@ -1,205 +0,0 @@
-#!/usr/bin/env node
-/**
- * migrate-to-profiles.mjs — Migrate old Hermes agents to native profiles.
- *
- * Scans the old Overmind Hermes layout (<HERMES_HOME>/agents/<name>/settings.json)
- * and creates a native Hermes profile for each, preserving:
- *   - SOUL.md (system prompt)
- *   - credentials (.env)
- *   - model + provider (config.yaml)
- *   - MCP servers
- *
- * Usage:
- *   node scripts/migrate-to-profiles.mjs [--dry-run]
- */
-
-import { exec } from 'child_process';
-import { promisify } from 'util';
-import fs from 'fs';
-import path from 'path';
-import os from 'os';
-
-const execAsync = promisify(exec);
-
-// ─── Resolve old HERMES_HOME ──────────────────────────────────────────────────
-
-function resolveOldHermesHome() {
-  if (process.env.OVERMIND_HERMES_HOME) return process.env.OVERMIND_HERMES_HOME;
-
-  // Workspace fallback
-  const wsHome = path.join(process.cwd(), '.overmind', 'hermes');
-  if (fs.existsSync(wsHome)) return wsHome;
-
-  // HOME-based
-  const homeBase = process.env.LOCALAPPDATA || os.homedir();
-  return process.platform === 'win32'
-    ? path.join(homeBase, 'overmind', 'hermes')
-    : path.join(homeBase, '.overmind', 'hermes');
-}
-
-function resolveOldAgentsDir() {
-  const home = resolveOldHermesHome();
-  const agentsDir = path.join(home, 'agents');
-  if (fs.existsSync(agentsDir)) return agentsDir;
-  return null;
-}
-
-// ─── Detect provider from credentials ─────────────────────────────────────────
-
-function detectProvider(token, baseUrl) {
-  if (!token) return 'openrouter';
-  const url = (baseUrl || '').toLowerCase();
-  const t = token.toLowerCase();
-
-  if (url.includes('minimaxi') || url.includes('minimax') || t.startsWith('sk-cp-') || t.startsWith('sk-mm-')) {
-    return url.includes('minimaxi') ? 'minimax-cn' : 'minimax';
-  }
-  if (url.includes('z.ai') || url.includes('bigmodel') || /^[0-9a-f]{32}/i.test(token)) {
-    return 'zai';
-  }
-  if (url.includes('anthropic') || t.startsWith('sk-ant-')) {
-    return 'anthropic';
-  }
-  if (url.includes('openai') || t.startsWith('sk-')) {
-    return 'openai';
-  }
-  return 'openrouter';
-}
-
-function buildCredentialsMap(provider, authToken) {
-  const creds = {};
-  if (!authToken) return creds;
-
-  switch (provider) {
-    case 'minimax-cn':
-      creds['MINIMAX_CN_API_KEY'] = authToken;
-      break;
-    case 'minimax':
-      creds['MINIMAX_API_KEY'] = authToken;
-      break;
-    case 'zai':
-      creds['GLM_API_KEY'] = authToken;
-      creds['ZAI_ANTHROPIC_FALLBACK_KEY'] = authToken;
-      break;
-    case 'anthropic':
-      creds['ANTHROPIC_API_KEY'] = authToken;
-      break;
-    case 'openai':
-      creds['OPENAI_API_KEY'] = authToken;
-      break;
-    default:
-      creds['OPENROUTER_API_KEY'] = authToken;
-  }
-  return creds;
-}
-
-// ─── Migration ────────────────────────────────────────────────────────────────
-
-async function migrate(dryRun = false) {
-  const agentsDir = resolveOldAgentsDir();
-  if (!agentsDir) {
-    console.log('ℹ️  No old Hermes agents directory found. Nothing to migrate.');
-    return;
-  }
-
-  const agentDirs = fs.readdirSync(agentsDir)
-    .filter(d => fs.statSync(path.join(agentsDir, d)).isDirectory());
-
-  if (agentDirs.length === 0) {
-    console.log('ℹ️  No old Hermes agents found. Nothing to migrate.');
-    return;
-  }
-
-  console.log(`Found ${agentDirs.length} old Hermes agent(s) to migrate:\n`);
-
-  let migrated = 0;
-  let skipped = 0;
-  let failed = 0;
-
-  for (const agentName of agentDirs) {
-    const agentDir = path.join(agentsDir, agentName);
-    const settingsPath = path.join(agentDir, 'settings.json');
-    const soulPath = path.join(agentDir, 'SOUL.md');
-
-    console.log(`  📦 ${agentName}`);
-
-    // Read settings.json
-    if (!fs.existsSync(settingsPath)) {
-      console.log(`     ⚠️  No settings.json found — skipping.`);
-      skipped++;
-      continue;
-    }
-
-    let settings;
-    try {
-      settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
-    } catch (e) {
-      console.log(`     ❌ Failed to parse settings.json: ${e.message}`);
-      failed++;
-      continue;
-    }
-
-    const env = settings.env || {};
-    const authToken = env.ANTHROPIC_AUTH_TOKEN || env.ANTHROPIC_API_KEY || '';
-    const baseUrl = env.ANTHROPIC_BASE_URL || '';
-    const model = env.ANTHROPIC_MODEL || env.MODEL || 'MiniMax-M3';
-    const provider = env.ANTHROPIC_PROVIDER || detectProvider(authToken, baseUrl);
-    const mcpServers = settings.enabledMcpjsonServers || [];
-
-    // Read SOUL.md
-    let soulContent = '';
-    if (fs.existsSync(soulPath)) {
-      soulContent = fs.readFileSync(soulPath, 'utf-8');
-    }
-
-    console.log(`     Model: ${model} (${provider})`);
-    console.log(`     MCPs:  ${mcpServers.length} server(s)`);
-    console.log(`     Auth:  ${authToken ? `***${authToken.slice(-4)}` : '(none)'}`);
-
-    if (dryRun) {
-      console.log(`     🔄 [DRY-RUN] Would create profile: hermes profile create ${agentName}`);
-      migrated++;
-      continue;
-    }
-
-    try {
-      // 1. Create profile
-      const { HermesProfileManager } = await import('../dist/services/HermesProfileManager.js');
-      const credentials = buildCredentialsMap(provider, authToken);
-
-      const { profilePath } = await HermesProfileManager.create({
-        name: agentName,
-        prompt: soulContent || `You are ${agentName}, an AI assistant.`,
-        model,
-        provider,
-        credentials,
-        mcpServers,
-        description: `Migrated agent: ${agentName}`,
-      });
-
-      console.log(`     ✅ Profile created: ${profilePath}`);
-      migrated++;
-    } catch (e) {
-      console.log(`     ❌ Migration failed: ${e.message}`);
-      failed++;
-    }
-  }
-
-  console.log(`\n📊 Migration complete: ${migrated} migrated, ${skipped} skipped, ${failed} failed.`);
-
-  if (!dryRun && migrated > 0) {
-    console.log(`\n💡 Next steps:`);
-    console.log(`   • Verify profiles: hermes profile list`);
-    console.log(`   • Test an agent:   hermes -p <name> chat "test"`);
-    console.log(`   • Old layout preserved at: ${agentsDir}`);
-    console.log(`   • Delete old layout when ready: rm -rf ${agentsDir}`);
-  }
-}
-
-// ─── CLI ──────────────────────────────────────────────────────────────────────
-
-const dryRun = process.argv.includes('--dry-run');
-migrate(dryRun).catch(e => {
-  console.error('Migration error:', e);
-  process.exit(1);
-});