@imenam/mcp-documentor 1.0.24 → 1.0.26

package/dist/src/core/storage-engine.d.ts

@@ -25,5 +25,6 @@ export declare class StorageEngine {
     } | null>;
     deleteDoc(id: string, project?: string): Promise<boolean>;
     moveDoc(oldId: string, newId: string, project?: string): Promise<boolean>;
+    rewriteLinks(oldId: string, newId: string, project?: string): Promise<string[]>;
 }
 export {};

package/dist/src/core/storage-engine.js

@@ -3,6 +3,9 @@ import path from "path";
 import matter from "gray-matter";
 import { createLogger } from "@imenam/mcp-gui-interface";
 const logger = createLogger("StorageEngine");
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 export class StorageEngine {
     rootDir;
     constructor(rootDir) {
@@ -188,4 +191,35 @@ export class StorageEngine {
         logger.info(`Doc moved: ${oldFilePath} → ${newFilePath}`);
         return true;
     }
+    async rewriteLinks(oldId, newId, project) {
+        const docs = await this.listDocs(project);
+        const updated = [];
+        for (const summary of docs) {
+            if (summary.id === newId)
+                continue;
+            const doc = await this.getDoc(summary.id, project);
+            if (!doc)
+                continue;
+            let changed = false;
+            const newContent = doc.content.replace(new RegExp(`doc://${escapeRegex(oldId)}`, "g"), `doc://${newId}`);
+            if (newContent !== doc.content) {
+                doc.content = newContent;
+                changed = true;
+            }
+            const newRelated = doc.related_docs.map((ref) => {
+                if (ref === oldId) {
+                    changed = true;
+                    return newId;
+                }
+                return ref;
+            });
+            doc.related_docs = newRelated;
+            if (changed) {
+                doc.updatedAt = new Date().toISOString();
+                await this.saveDoc(doc, project);
+                updated.push(summary.id);
+            }
+        }
+        return updated;
+    }
 }

package/dist/src/index.js

@@ -404,7 +404,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             items: { type: "string" },
                             description: "IDs of related documentation entries",
                         },
-                        project: { type: "string", description: "Project to create the doc in (defaults to current project if omitted)" },
+                        project: { type: "string", description: "Project to create the doc in (defaults to current project if omitted). If the project name does not exist yet, it will be created automatically." },
                     },
                     required: ["title", "content"],
                 },
@@ -463,7 +463,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             },
             {
                 name: "move_doc",
-                description: "Move a documentation entry to a new path (changes its folder and/or name). This is the only way to relocate a document — update_doc does not change the location. After moving, use check_links to detect any broken references.",
+                description: "Move a documentation entry to a new path (changes its folder and/or name). All existing doc:// links and related_docs references pointing to the old path are automatically rewritten across the project. This is the only way to relocate a document — update_doc does not change the location.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -499,11 +499,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             },
             {
                 name: "set_project",
-                description: "Switch the active project for the GUI display. This does NOT affect MCP tool operations — tools work across all projects automatically. Use only to control what the graphical interface shows.",
+                description: "Switch the active project and update it as the default for all subsequent MCP tool operations. If the project name does not exist yet, it is created automatically. Also controls what the GUI displays.",
                 inputSchema: {
                     type: "object",
                     properties: {
-                        project: { type: "string", description: "Project name to switch to" },
+                        project: { type: "string", description: "Project name to switch to (created if it does not exist)" },
                     },
                     required: ["project"],
                 },

package/dist/src/tools/move-doc.js

@@ -18,11 +18,15 @@ export async function moveDoc(storageEngine, embeddingEngine, args) {
             };
         }
         await embeddingEngine.moveEmbedding(validated.path, validated.new_path, resolvedProject);
+        const rewritten = await storageEngine.rewriteLinks(validated.path, validated.new_path, resolvedProject);
+        const rewriteNote = rewritten.length > 0
+            ? `\n\nLiens mis à jour automatiquement dans ${rewritten.length} doc(s) :\n${rewritten.map((id) => `  - ${id}`).join("\n")}`
+            : "\n\nAucune référence existante à mettre à jour.";
         return {
             content: [
                 {
                     type: "text",
-                    text: `Documentation entry moved successfully.\nFrom: "${validated.path}"\nTo:   "${validated.new_path}"\n\nNote: if other documents reference "${validated.path}" in their related_docs or via doc:// links, use check_links to detect broken references.`,
+                    text: `Documentation entry moved successfully.\nFrom: "${validated.path}"\nTo:   "${validated.new_path}"${rewriteNote}`,
                 },
             ],
         };

package/dist/src/version.d.ts

@@ -1 +1 @@
-export declare const APP_VERSION = "1.0.24";
+export declare const APP_VERSION = "1.0.26";

package/dist/src/version.js

@@ -1,2 +1,2 @@
 // Auto-generated version file - do not edit manually
-export const APP_VERSION = '1.0.24';
+export const APP_VERSION = '1.0.26';