@imenam/refactoring-mcp 3.1.1 → 3.2.0

package/dist/index.js

@@ -130,6 +130,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
             name: "get_file_outline",
             description: "Retourne la liste des symboles d'un fichier (fonctions, classes, interfaces, types, constantes, méthodes) " +
                 "avec leurs numéros de lignes de début et de fin, et leur profondeur d'imbrication (depth). " +
+                "Si un bloc de commentaire JSDoc (/** ... */) précède immédiatement un symbole, les champs commentStartLine et commentEndLine sont inclus dans la réponse. " +
                 "Supporte tous les langages à accolades (TypeScript, JavaScript, PHP, Java, C#…). " +
                 "Paramètres optionnels : depth pour filtrer par niveau d'imbrication, startLine/endLine pour cibler une section. " +
                 "Le chemin doit être absolu.",

package/dist/utils/outline.js

@@ -33,6 +33,26 @@ const SYMBOL_PATTERNS = [
         type: "method",
     },
 ];
+function findPrecedingComment(lines, symbolLineIndex) {
+    let idx = symbolLineIndex - 1;
+    while (idx >= 0 && lines[idx].trim() === "") {
+        idx--;
+    }
+    if (idx < 0)
+        return null;
+    const trimmed = lines[idx].trim();
+    if (!trimmed.endsWith("*/"))
+        return null;
+    const commentEndLine = idx + 1;
+    while (idx >= 0) {
+        const t = lines[idx].trim();
+        if (t.startsWith("/**") || t.startsWith("/*")) {
+            return { commentStartLine: idx + 1, commentEndLine };
+        }
+        idx--;
+    }
+    return null;
+}
 function countBracesInLine(line) {
     let count = 0;
     let inSingleQuote = false;
@@ -78,7 +98,15 @@ export async function getFileOutline(filePath, options = {}) {
                     // Pour le pattern TS method, le groupe capturant est match[2] (match[1] = lookahead interne)
                     const name = match[2] ?? match[1];
                     if (name) {
-                        symbols.push({ name, type, startLine: lineNum, endLine: 0, depth: braceDepth });
+                        const comment = findPrecedingComment(lines, i);
+                        symbols.push({
+                            name,
+                            type,
+                            ...(comment ?? {}),
+                            startLine: lineNum,
+                            endLine: 0,
+                            depth: braceDepth,
+                        });
                         break;
                     }
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imenam/refactoring-mcp",
-  "version": "3.1.1",
+  "version": "3.2.0",
   "description": "MCP server to copy or move code blocks between files, with optional directory confinement.",
   "type": "module",
   "main": "dist/index.js",