Project State Manager (PSM)

Project State Manager est un serveur Model Context Protocol (MCP) couplé à une GUI de supervision conçue pour sécuriser et structurer le travail des agents IA (comme Cursor ou Windsurf) sur des fonctionnalités complexes.

🚀 Installation & Utilisation Rapide

Vous pouvez lancer PSM directement sans installation globale via npx :

npx project-state-manager

Une fois lancé, PSM :

1. Démarre un serveur MCP sur stdio.
2. Lance automatiquement une interface graphique de supervision.
3. Se synchronise avec vos fichiers YAML locaux dans le dossier .psm/.

🛠️ Configuration MCP (Cursor)

Ajoutez la configuration suivante dans le fichier .cursor/mcp.json de votre projet :

{
  "mcpServers": {
    "project-state-manager": {
      "command": "npx",
      "args": ["-y", "project-state-manager"],
      "env": {
        "FIXED_GUI_PORT": "4000",
        "PROXY_URL": "",
        "PSM_CONFIG_DIR": "",
        "PSM_BASE_DIR": ""
      }
    }
  }
}

Variables d'environnement

| Variable | Description | Défaut | |----------|-------------|---------| | FIXED_GUI_PORT | Port utilisé pour l'interface graphique en mode local | 4000 | | PROXY_URL | URL du Dynamic Proxy pour l'exposition de la GUI | undefined | | PSM_CONFIG_DIR | Dossier où est enregistré le fichier de configuration .psm-config.json | cwd (répertoire courant) | | PSM_BASE_DIR | Dossier parent pour le stockage des données YAML (le sous-dossier .psm/ est créé automatiquement à l'intérieur) | . (répertoire courant) |

Priorité de résolution du dossier de données : .psm-config.json > PSM_BASE_DIR > . (cwd)

Ces variables peuvent aussi être définies dans un fichier .env à la racine de votre projet.

📋 Fonctionnement

L'agent IA interagit avec PSM via les outils MCP fournis :

• discover_process : Identifie le processus métier.
• define_process : Crée une nouvelle cartographie.
• scan_node : Guide l'analyse technique (Entrée, Flux, Sortie).
• submit_node_data : Soumet les découvertes avec validation.
• check_readiness : Vérifie si le signal is_executable est au vert.

L'utilisateur peut superviser l'avancement sur le Dashboard et corriger manuellement le YAML si l'agent fait fausse route.

🏗️ Structure du Projet

• .psm/ : Stockage des états de processus au format YAML.
• shared/ : Schémas Zod partagés pour une intégrité totale des données.
• gui/ : Interface de supervision React.
• src/ : Cœur du serveur MCP (Node.js).

📄 Licence

ISC