feat: brain-engine start/stop/status — lifecycle visible pour les forks

- start.sh: background par défaut, PID tracké, --foreground pour debug
- stop.sh: arrêt propre avec grace period 5s + force kill
- status.sh: running/stopped, vérification port, exit code scriptable
- getting-started: docs mis à jour (plus de nohup/kill manuels)
- .gitignore: .brain-engine.pid

brain-engine/start.sh

@@ -61,14 +61,46 @@ else
     echo "   Le serveur démarre quand même (BSI, docs, endpoints basiques)."
 fi
 
-# 5. Lancer le serveur
+# 5. Vérifier si déjà en cours
+PIDFILE="$BRAIN_ROOT/.brain-engine.pid"
+if [ -f "$PIDFILE" ] && kill -0 "$(cat "$PIDFILE")" 2>/dev/null; then
+    echo ""
+    echo "⚠️  brain-engine tourne déjà (PID $(cat "$PIDFILE"))"
+    echo "   Arrêter : bash brain-engine/stop.sh"
+    echo "   Statut  : bash brain-engine/status.sh"
+    exit 0
+fi
+
+# 6. Lancer le serveur
 PORT="${BRAIN_PORT:-7700}"
+LOGFILE="$BRAIN_ROOT/brain-engine/brain-engine.log"
 echo ""
 echo "=== Lancement brain-engine sur port $PORT ==="
-echo "  Health : http://localhost:$PORT/health"
-echo "  Search : http://localhost:$PORT/search?q=comment+ca+marche"
-echo "  Agents : http://localhost:$PORT/agents"
+echo "  Health    : http://localhost:$PORT/health"
+echo "  Dashboard : http://localhost:$PORT/ui/"
+echo "  Agents    : http://localhost:$PORT/agents"
 echo ""
 
 cd "$BRAIN_ROOT"
-python3 "$SCRIPT_DIR/server.py"
+
+if [ "${1:-}" = "--foreground" ]; then
+    # Mode foreground (debug) — Ctrl+C pour arrêter
+    echo "Mode foreground — Ctrl+C pour arrêter"
+    python3 "$SCRIPT_DIR/server.py"
+else
+    # Mode background (défaut) — PID tracké, log rotatif
+    python3 "$SCRIPT_DIR/server.py" > "$LOGFILE" 2>&1 &
+    ENGINE_PID=$!
+    echo "$ENGINE_PID" > "$PIDFILE"
+    sleep 1
+
+    if kill -0 "$ENGINE_PID" 2>/dev/null; then
+        echo "✅ brain-engine démarré (PID $ENGINE_PID)"
+        echo "   Logs    : tail -f brain-engine/brain-engine.log"
+        echo "   Arrêter : bash brain-engine/stop.sh"
+    else
+        echo "❌ brain-engine n'a pas démarré — voir brain-engine/brain-engine.log"
+        rm -f "$PIDFILE"
+        exit 1
+    fi
+fi

brain-engine/status.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+# brain-engine/status.sh — Statut rapide
+# Usage : bash brain-engine/status.sh
+# Exit 0 si running, 1 si stopped — utilisable dans des scripts/briefings
+
+BRAIN_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+PIDFILE="$BRAIN_ROOT/.brain-engine.pid"
+PORT="${BRAIN_PORT:-7700}"
+
+if [ ! -f "$PIDFILE" ]; then
+    echo "brain-engine: stopped"
+    exit 1
+fi
+
+PID=$(cat "$PIDFILE")
+
+if kill -0 "$PID" 2>/dev/null; then
+    # Vérifier que le port répond
+    if curl -s --max-time 2 "http://localhost:$PORT/health" > /dev/null 2>&1; then
+        echo "brain-engine: running (PID $PID, port $PORT)"
+    else
+        echo "brain-engine: starting (PID $PID, port $PORT pas encore prêt)"
+    fi
+    exit 0
+else
+    rm -f "$PIDFILE"
+    echo "brain-engine: stopped (PID $PID stale — nettoyé)"
+    exit 1
+fi

brain-engine/stop.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+# brain-engine/stop.sh — Arrêt propre
+# Usage : bash brain-engine/stop.sh
+
+BRAIN_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+PIDFILE="$BRAIN_ROOT/.brain-engine.pid"
+
+if [ ! -f "$PIDFILE" ]; then
+    echo "brain-engine n'est pas démarré (pas de PID tracké)"
+    exit 0
+fi
+
+PID=$(cat "$PIDFILE")
+
+if kill -0 "$PID" 2>/dev/null; then
+    kill "$PID"
+    # Attendre l'arrêt propre (max 5s)
+    for i in $(seq 1 10); do
+        kill -0 "$PID" 2>/dev/null || break
+        sleep 0.5
+    done
+
+    if kill -0 "$PID" 2>/dev/null; then
+        echo "⚠️  brain-engine ne répond pas — force kill"
+        kill -9 "$PID" 2>/dev/null
+    fi
+
+    rm -f "$PIDFILE"
+    echo "✅ brain-engine arrêté (PID $PID)"
+else
+    rm -f "$PIDFILE"
+    echo "brain-engine n'était plus actif (PID $PID stale — nettoyé)"
+fi