project-state-manager 1.0.1

package/dist/src/tools/discover-process.js

@@ -0,0 +1,41 @@
+import { DiscoverProcessArgsSchema } from '../../shared/schemas/process.schema.js';
+export async function discoverProcess(yamlEngine, args) {
+    const { context } = DiscoverProcessArgsSchema.parse(args);
+    const processes = await yamlEngine.listProcesses();
+    const matches = [];
+    for (const id of processes) {
+        const p = await yamlEngine.loadProcess(id);
+        if (p) {
+            const searchTerm = context.toLowerCase();
+            const inName = p.name.toLowerCase().includes(searchTerm);
+            const inId = id.toLowerCase().includes(searchTerm);
+            const inEntry = p.entryPoint.toLowerCase().includes(searchTerm);
+            // Extended search in node content
+            const inInput = p.nodes.input.content.toLowerCase().includes(searchTerm);
+            const inFlow = p.nodes.flow.content.toLowerCase().includes(searchTerm);
+            const inOutput = p.nodes.output.content.toLowerCase().includes(searchTerm);
+            if (inName || inId || inEntry || inInput || inFlow || inOutput) {
+                matches.push(p);
+            }
+        }
+    }
+    if (matches.length === 0) {
+        return {
+            content: [{ type: 'text', text: `No process found matching context: "${context}"` }]
+        };
+    }
+    const results = matches.map(p => {
+        const manualFlags = [];
+        if (p.nodes.input.manuallyModified)
+            manualFlags.push('Input');
+        if (p.nodes.flow.manuallyModified)
+            manualFlags.push('Flow');
+        if (p.nodes.output.manuallyModified)
+            manualFlags.push('Output');
+        const manualSuffix = manualFlags.length > 0 ? ` [MODIFIÉ MANUELLEMENT: ${manualFlags.join(', ')}]` : '';
+        return `- ${p.name} (ID: ${p.id}) [Entry: ${p.entryPoint}]${manualSuffix}`;
+    });
+    return {
+        content: [{ type: 'text', text: `Found relevant processes for "${context}":\n${results.join('\n')}` }]
+    };
+}

package/dist/src/tools/get-health-status.d.ts

@@ -0,0 +1,11 @@
+import { IpcHub } from '../infra/ipc-hub.js';
+/**
+ * MCP Tool to get health status of Master and Worker processes.
+ */
+export declare function getHealthStatus(ipcHub: IpcHub): Promise<{
+    isError: boolean;
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;

package/dist/src/tools/get-health-status.js

@@ -0,0 +1,62 @@
+/**
+ * MCP Tool to get health status of Master and Worker processes.
+ */
+export async function getHealthStatus(ipcHub) {
+    const masterMemory = process.memoryUsage();
+    const health = {
+        master: {
+            status: 'ok',
+            uptime: process.uptime(),
+            memory: {
+                rss: masterMemory.rss,
+                heapUsed: masterMemory.heapUsed,
+            },
+        },
+    };
+    try {
+        const workerHealth = await ipcHub.request({ type: 'GET_HEALTH' }, 1000);
+        health.worker = {
+            status: workerHealth.data.status,
+            connected: true,
+            uptime: workerHealth.data.uptime,
+            memory: workerHealth.data.memory,
+        };
+    }
+    catch (err) {
+        health.worker = {
+            status: 'error',
+            connected: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    return {
+        isError: false,
+        content: [{
+                type: 'text',
+                text: formatHealthMarkdown(health)
+            }],
+    };
+}
+function formatHealthMarkdown(health) {
+    let md = `## Infrastructure Health Status\n\n`;
+    md += `### Master Process\n`;
+    md += `- **Status**: \`${health.master.status}\`\n`;
+    md += `- **Uptime**: ${Math.floor(health.master.uptime)}s\n`;
+    md += `- **Memory**: RSS: ${(health.master.memory.rss / 1024 / 1024).toFixed(2)}MB, Heap: ${(health.master.memory.heapUsed / 1024 / 1024).toFixed(2)}MB\n\n`;
+    md += `### Worker Process (GUI)\n`;
+    if (health.worker) {
+        md += `- **Status**: \`${health.worker.status}\`\n`;
+        md += `- **IPC**: ${health.worker.connected ? '✅ Connected' : '❌ Disconnected'}\n`;
+        if (health.worker.connected) {
+            md += `- **Uptime**: ${Math.floor(health.worker.uptime)}s\n`;
+            md += `- **Memory**: RSS: ${(health.worker.memory.rss / 1024 / 1024).toFixed(2)}MB, Heap: ${(health.worker.memory.heapUsed / 1024 / 1024).toFixed(2)}MB\n`;
+        }
+        else {
+            md += `- **Error**: ${health.worker.error}\n`;
+        }
+    }
+    else {
+        md += `*Worker status unavailable*\n`;
+    }
+    return md;
+}

package/dist/src/tools/list-existing-processes.d.ts

@@ -0,0 +1,7 @@
+import { YamlEngine } from '../core/yaml-engine.js';
+export declare function listExistingProcesses(yamlEngine: YamlEngine): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;

package/dist/src/tools/list-existing-processes.js

@@ -0,0 +1,25 @@
+export async function listExistingProcesses(yamlEngine) {
+    const processes = await yamlEngine.listProcesses();
+    if (processes.length === 0) {
+        return {
+            content: [{ type: 'text', text: 'No processes found.' }]
+        };
+    }
+    const results = await Promise.all(processes.map(async (id) => {
+        const p = await yamlEngine.loadProcess(id);
+        if (!p)
+            return `- (ID: ${id}) [Error loading]`;
+        const manualFlags = [];
+        if (p.nodes.input.manuallyModified)
+            manualFlags.push('Input');
+        if (p.nodes.flow.manuallyModified)
+            manualFlags.push('Flow');
+        if (p.nodes.output.manuallyModified)
+            manualFlags.push('Output');
+        const manualSuffix = manualFlags.length > 0 ? ` [MODIFIÉ MANUELLEMENT: ${manualFlags.join(', ')}]` : '';
+        return `- ${p.name} (ID: ${id}) [Entry: ${p.entryPoint}]${manualSuffix}`;
+    }));
+    return {
+        content: [{ type: 'text', text: `Existing processes:\n${results.join('\n')}` }]
+    };
+}

package/dist/src/tools/scan-node.d.ts

@@ -0,0 +1,14 @@
+import { YamlEngine } from '../core/yaml-engine.js';
+export declare function scanNode(yamlEngine: YamlEngine, args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+}>;

package/dist/src/tools/scan-node.js

@@ -0,0 +1,47 @@
+import { ScanNodeArgsSchema } from '../../shared/schemas/process.schema.js';
+const PROMPTS = {
+    entry: `Analyse les points d'entrée de la feature. Identifie :
+1. Les sources de données (APIs, fichiers, input utilisateur).
+2. La structure des données entrantes.
+3. Les schémas de validation appliqués (ex: Zod, Joi).
+4. Les contraintes de sécurité (auth, rate limiting).`,
+    flow: `Analyse la logique de traitement. Identifie :
+1. Le cheminement des données entre les modules.
+2. Les transformations appliquées.
+3. Les services ou helpers sollicités.
+4. Les effets de bord (écriture DB, appels externes, logs).`,
+    exit: `Analyse les résultats et retours. Identifie :
+1. Le format de la réponse (JSON, Status Codes).
+2. La destination des données (Client, Cache, DB).
+3. Les mécanismes de gestion d'erreurs et les codes d'erreur spécifiques.
+4. Les garanties de succès (retries, transactions).`
+};
+export async function scanNode(yamlEngine, args) {
+    const validatedArgs = ScanNodeArgsSchema.parse(args);
+    const { process_name, node_type } = validatedArgs;
+    const process = await yamlEngine.loadProcess(process_name);
+    if (!process) {
+        return {
+            content: [{ type: 'text', text: `Processus "${process_name}" non trouvé.` }],
+            isError: true
+        };
+    }
+    // Map node type to check for manual modification
+    let targetKey;
+    if (node_type === 'entry')
+        targetKey = 'input';
+    else if (node_type === 'flow')
+        targetKey = 'flow';
+    else
+        targetKey = 'output';
+    let prompt = PROMPTS[node_type];
+    if (process.nodes[targetKey].manuallyModified) {
+        prompt = `⚠️ ATTENTION : Ce nœud a été modifié manuellement par l'utilisateur. 
+Prends en compte les corrections humaines dans ton analyse et évite d'écraser les informations importantes.
+
+${prompt}`;
+    }
+    return {
+        content: [{ type: 'text', text: prompt }]
+    };
+}

package/dist/src/tools/submit-node-data.d.ts

@@ -0,0 +1,18 @@
+import { YamlEngine } from '../core/yaml-engine.js';
+/**
+ * Submits and validates findings for a specific process node.
+ *
+ * This tool validates the findings against the appropriate Zod schema
+ * for the node type, then persists the data via YamlEngine.
+ *
+ * @param yamlEngine - The YamlEngine instance for persistence
+ * @param args - The tool arguments (process_name, node_type, findings)
+ * @returns MCP tool response with success/error status
+ */
+export declare function submitNodeData(yamlEngine: YamlEngine, args: unknown): Promise<{
+    isError: boolean;
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;

package/dist/src/tools/submit-node-data.js

@@ -0,0 +1,86 @@
+import { SubmitNodeDataArgsSchema, NodeFindingsSchema } from '../../shared/schemas/process.schema.js';
+import { ZodError } from 'zod';
+import { ErrorFormatter } from '../core/error-formatter.js';
+/**
+ * Submits and validates findings for a specific process node.
+ *
+ * This tool validates the findings against the appropriate Zod schema
+ * for the node type, then persists the data via YamlEngine.
+ *
+ * @param yamlEngine - The YamlEngine instance for persistence
+ * @param args - The tool arguments (process_name, node_type, findings)
+ * @returns MCP tool response with success/error status
+ */
+export async function submitNodeData(yamlEngine, args) {
+    try {
+        const validatedArgs = SubmitNodeDataArgsSchema.parse(args);
+        const { process_name, node_type, findings } = validatedArgs;
+        const process = await yamlEngine.loadProcess(process_name);
+        if (!process) {
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Processus "${process_name}" non trouvé.` }],
+            };
+        }
+        // Prepare findings for validation by adding the 'type' field to match the discriminated union
+        const findingsWithType = { ...findings, type: node_type };
+        try {
+            const validatedFindings = NodeFindingsSchema.parse(findingsWithType);
+            // Update the specific node
+            const timestamp = new Date().toISOString();
+            let targetNode;
+            let warning = "";
+            if (node_type === 'entry')
+                targetNode = process.nodes.input;
+            else if (node_type === 'flow')
+                targetNode = process.nodes.flow;
+            else
+                targetNode = process.nodes.output;
+            if (targetNode.manuallyModified) {
+                warning = "\n⚠️ NOTE : Tu viens d'écraser une modification manuelle effectuée par l'utilisateur sur ce nœud.";
+            }
+            const updatedNode = {
+                ...targetNode,
+                status: 'done',
+                lastUpdated: timestamp,
+                data: validatedFindings,
+                manuallyModified: false // Reset flag on agent submission
+            };
+            if (node_type === 'entry')
+                process.nodes.input = updatedNode;
+            else if (node_type === 'flow')
+                process.nodes.flow = updatedNode;
+            else
+                process.nodes.output = updatedNode;
+            await yamlEngine.saveProcess(process);
+            const updatedProcess = await yamlEngine.loadProcess(process_name);
+            const statusMsg = updatedProcess?.is_executable ? "TRUE ✅" : "false ❌";
+            return {
+                isError: false,
+                content: [{
+                        type: 'text',
+                        text: `Données soumises et validées pour le nœud "${node_type}" du processus "${process_name}".${warning}\n\n[GUARDRAIL] État actuel de is_executable : ${statusMsg}`
+                    }],
+            };
+        }
+        catch (err) {
+            if (err instanceof ZodError) {
+                return {
+                    isError: true,
+                    content: [{
+                            type: 'text',
+                            text: `Échec de la validation des données pour le nœud "${node_type}":\n${ErrorFormatter.format(err, node_type)}`
+                        }],
+                };
+            }
+            throw err;
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            isError: true,
+            content: [{ type: 'text', text: `Erreur lors de la soumission : ${message}` }],
+        };
+    }
+}

package/gui/README.md

@@ -0,0 +1,73 @@
+# React + TypeScript + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) (or [oxc](https://oxc.rs) when used in [rolldown-vite](https://vite.dev/guide/rolldown)) for Fast Refresh
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
+
+## React Compiler
+
+The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
+
+```js
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+
+      // Remove tseslint.configs.recommended and replace with this
+      tseslint.configs.recommendedTypeChecked,
+      // Alternatively, use this for stricter rules
+      tseslint.configs.strictTypeChecked,
+      // Optionally, add this for stylistic rules
+      tseslint.configs.stylisticTypeChecked,
+
+      // Other configs...
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```
+
+You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
+
+```js
+// eslint.config.js
+import reactX from 'eslint-plugin-react-x'
+import reactDom from 'eslint-plugin-react-dom'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+      // Enable lint rules for React
+      reactX.configs['recommended-typescript'],
+      // Enable lint rules for React DOM
+      reactDom.configs.recommended,
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```

package/gui/dist/assets/index-BpHg-2LI.css

@@ -0,0 +1 @@
+:root{font-family:system-ui,Avenir,Helvetica,Arial,sans-serif;line-height:1.5;font-weight:400;color-scheme:light dark;color:#ffffffde;background-color:#242424;font-synthesis:none;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}a{font-weight:500;color:#646cff;text-decoration:inherit}a:hover{color:#535bf2}body{margin:0;display:flex;place-items:center;min-width:320px;min-height:100vh}h1{font-size:3.2em;line-height:1.1}button{border-radius:8px;border:1px solid transparent;padding:.6em 1.2em;font-size:1em;font-weight:500;font-family:inherit;background-color:#1a1a1a;cursor:pointer;transition:border-color .25s}button:hover{border-color:#646cff}button:focus,button:focus-visible{outline:4px auto -webkit-focus-ring-color}@media(prefers-color-scheme:light){:root{color:#213547;background-color:#fff}a:hover{color:#747bff}button{background-color:#f9f9f9}}:root{--bg-color: #0f172a;--sidebar-bg: #1e293b;--card-bg: #334155;--text-primary: #f8fafc;--text-secondary: #94a3b8;--accent: #3b82f6;--success: #22c55e;--error: #ef4444;--warning: #f59e0b;--muted: #64748b;--border: #334155}.dashboard-layout{display:flex;flex-direction:column;height:100vh;background-color:var(--bg-color);color:var(--text-primary);font-family:Inter,system-ui,-apple-system,sans-serif}.main-header{display:flex;justify-content:space-between;align-items:center;padding:.75rem 1.5rem;background-color:var(--sidebar-bg);border-bottom:1px solid var(--border)}.main-header h1{font-size:1.25rem;margin:0;color:var(--accent)}.connection-status{display:flex;align-items:center;gap:.5rem;font-size:.875rem;padding:.25rem .75rem;border-radius:9999px}.connection-status.connected{background-color:#22c55e1a;color:var(--success)}.connection-status.disconnected{background-color:#ef44441a;color:var(--error)}.main-content{display:flex;flex:1;overflow:hidden}.sidebar{width:260px;background-color:var(--sidebar-bg);border-right:1px solid var(--border);display:flex;flex-direction:column}.sidebar-header{display:flex;align-items:center;gap:.75rem;padding:1.25rem;border-bottom:1px solid var(--border)}.sidebar-header h2{font-size:1rem;margin:0}.process-list{flex:1;overflow-y:auto;padding:.5rem}.process-item{display:flex;align-items:center;gap:.75rem;padding:.75rem 1rem;border-radius:.5rem;cursor:pointer;transition:all .2s;margin-bottom:.25rem}.process-item:hover{background-color:#ffffff0d}.process-item.active{background-color:#3b82f61a;color:var(--accent)}.process-name{flex:1;font-size:.875rem;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.node-card.selected{border-color:var(--accent);box-shadow:0 0 10px #3b82f64d;transform:translateY(-4px)}.node-editor-overlay{position:fixed;inset:0;background-color:#000000bf;display:flex;justify-content:center;align-items:center;z-index:1000}.node-editor-container{width:800px;max-width:90vw;height:600px;max-height:80vh;background-color:var(--sidebar-bg);border-radius:1rem;border:1px solid var(--border);display:flex;flex-direction:column;overflow:hidden;box-shadow:0 20px 25px -5px #00000080}.editor-header{padding:1.5rem;border-bottom:1px solid var(--border);display:flex;justify-content:space-between;align-items:center}.editor-title h2{font-size:1.25rem;margin:0}.editor-title .process-name{font-size:.875rem;color:var(--text-secondary)}.close-btn{background:none;border:none;color:var(--text-secondary);cursor:pointer;padding:.5rem;display:flex;align-items:center;justify-content:center;border-radius:.375rem;transition:background-color .2s}.close-btn:hover{background-color:#ffffff1a;color:var(--text-primary)}.editor-content{flex:1;display:flex;flex-direction:column;padding:1.5rem;gap:1rem}.yaml-textarea{flex:1;background-color:var(--bg-color);color:var(--text-primary);border:1px solid var(--border);border-radius:.5rem;padding:1rem;font-family:JetBrains Mono,Fira Code,"ui-monospace",monospace;font-size:.875rem;line-height:1.6;resize:none;outline:none}.yaml-textarea:focus{border-color:var(--accent)}.error-banner{background-color:#ef44441a;border:1px solid var(--error);color:#fca5a5;padding:.75rem 1rem;border-radius:.5rem;display:flex;align-items:center;gap:.75rem;font-size:.875rem}.editor-footer{padding:1.5rem;border-top:1px solid var(--border);display:flex;justify-content:flex-end;gap:1rem}.cancel-btn{background:none;border:1px solid var(--border);color:var(--text-primary)}.cancel-btn:hover{background-color:#ffffff0d}.save-btn{background-color:var(--accent);color:#fff;display:flex;align-items:center;gap:.5rem}.save-btn:hover{background-color:#2563eb}.save-btn:disabled{opacity:.5;cursor:not-allowed}.process-view{flex:1;display:flex;flex-direction:column;padding:2rem;overflow-y:auto}.view-header{margin-bottom:2rem;display:flex;justify-content:space-between;align-items:flex-start}.execution-signal{display:flex;align-items:center;gap:.75rem;padding:.5rem 1rem;border-radius:.5rem;background-color:#1e293b80;border:1px solid var(--border)}.execution-signal.executable{border-color:var(--success)}.execution-signal.executable .signal-dot{width:10px;height:10px;background-color:var(--success);border-radius:50%;box-shadow:0 0 8px var(--success)}.execution-signal.not-executable .signal-dot{width:10px;height:10px;background-color:var(--muted);border-radius:50%}.signal-label{font-size:.875rem;font-weight:500}.signal-label.executable{color:var(--success)}.nodes-container{display:flex;align-items:flex-start;gap:1rem}.connector{flex:1;height:2px;background-color:var(--border);margin-top:3rem;min-width:2rem}.node-card{width:300px;background-color:var(--sidebar-bg);border-radius:.75rem;border:1px solid var(--border);padding:1.25rem;display:flex;flex-direction:column;gap:1rem;transition:transform .2s,border-color .2s}.node-card:hover{transform:translateY(-4px)}.node-card.status-done{border-left:4px solid var(--success)}.node-card.status-error{border-left:4px solid var(--error)}.node-card.status-progress{border-left:4px solid var(--warning)}.node-card.status-todo{border-left:4px solid var(--muted)}.node-header{display:flex;justify-content:space-between;align-items:center}.node-title{display:flex;align-items:center;gap:.75rem}.node-title h3{font-size:1rem;margin:0}.node-content{background-color:#0f172a80;border-radius:.5rem;padding:1rem;min-height:80px}.content-text{font-size:.875rem;line-height:1.5;color:var(--text-secondary);margin:0}.node-footer{font-size:.75rem;color:var(--muted)}.empty-view{flex:1;display:flex;justify-content:center;align-items:center;color:var(--text-secondary)}.status-icon.success{color:var(--success)}.status-icon.error{color:var(--error)}.status-icon.warning{color:var(--warning)}.status-icon.muted{color:var(--muted)}