@imenam/mcp-documentor 1.0.43 → 1.0.48

package/dist/src/gui-worker.js

@@ -6,10 +6,14 @@ import { ProxyClient } from "@imenam/mcp-gui-interface";
 import { IPCMessageSchema } from "../shared/schemas/doc.schema.js";
 import path from "path";
 import fs from "fs";
+import { execFile } from "child_process";
+import { promisify } from "util";
+const execFileAsync = promisify(execFile);
 import { fileURLToPath } from "url";
 import { createLogger, setupLogging } from "@imenam/mcp-gui-interface";
 import matter from "gray-matter";
 import JSZip from "jszip";
+import puppeteer from "puppeteer-core";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 function findProjectRoot(startDir) {
     let current = startDir;
@@ -48,6 +52,53 @@ const parentCheckInterval = setInterval(() => {
         process.exit(0);
     }
 }, 2000);
+// undefined = not yet resolved ; null = not found ; string = path found
+let cachedBrowserPath = undefined;
+async function findSystemBrowser() {
+    if (cachedBrowserPath !== undefined)
+        return cachedBrowserPath;
+    const envPath = process.env.CHROMIUM_PATH?.trim();
+    if (envPath) {
+        if (fs.existsSync(envPath)) {
+            cachedBrowserPath = envPath;
+            return envPath;
+        }
+        logger.warn(`CHROMIUM_PATH is set but the file does not exist: ${envPath}`);
+    }
+    const candidates = [];
+    if (process.platform === 'win32') {
+        candidates.push('C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe', 'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe', 'C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe', 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe');
+    }
+    else if (process.platform === 'darwin') {
+        candidates.push('/Applications/Google Chrome.app/Contents/MacOS/Google Chrome');
+    }
+    else {
+        candidates.push('/usr/bin/google-chrome', '/usr/bin/google-chrome-stable', '/usr/bin/chromium', '/usr/bin/chromium-browser', '/snap/bin/chromium');
+    }
+    for (const p of candidates) {
+        if (fs.existsSync(p)) {
+            cachedBrowserPath = p;
+            return p;
+        }
+    }
+    if (process.platform !== 'win32') {
+        for (const bin of ['google-chrome', 'google-chrome-stable', 'chromium', 'chromium-browser']) {
+            try {
+                const { stdout } = await execFileAsync('which', [bin]);
+                const result = stdout.trim();
+                if (result) {
+                    cachedBrowserPath = result;
+                    return result;
+                }
+            }
+            catch { /* not found */ }
+        }
+    }
+    cachedBrowserPath = null;
+    return null;
+}
+let localPort = 0;
+let guiPublicUrl = '';
 const app = new Hono();
 let proxyClient = null;
 const sseControllers = new Set();
@@ -356,6 +407,16 @@ app.post("/api/search", async (c) => {
         return c.json({ error: result.error }, 500);
     return c.json(result.data);
 });
+app.get("/api/file-section/*", async (c) => {
+    const docId = c.req.query("docId");
+    if (!docId)
+        return c.json({ error: "docId query param required" }, 400);
+    const filePath = decodeURIComponent(c.req.path.slice("/api/file-section/".length));
+    const result = await ipcRequest("GET_FILE_SECTION", { docId, filePath }, 8000);
+    if (result.error)
+        return c.json({ error: result.error }, 400);
+    return c.json(result.data);
+});
 // Export bundles
 app.get("/api/export-bundles", (c) => {
     const bundlesPath = path.join(dataDir, "export-bundles.json");
@@ -429,6 +490,59 @@ app.get("/api/export-zip/:id", async (c) => {
         },
     });
 });
+// PDF generation
+app.get("/api/pdf", async (c) => {
+    const project = c.req.query('project');
+    const docId = c.req.query('docId');
+    const scale = Math.min(2, Math.max(0.1, Number(c.req.query('scale') ?? '1')));
+    if (!project || !docId) {
+        return c.json({ error: 'project and docId are required' }, 400);
+    }
+    const executablePath = await findSystemBrowser();
+    if (!executablePath) {
+        return c.json({
+            error: 'no_browser',
+            message: 'Aucun navigateur (Chrome, Edge ou Chromium) n\'a été trouvé sur ce système. Installez Google Chrome ou Chromium pour activer la génération PDF.',
+        }, 503);
+    }
+    const encodedPath = docId.split('/').map(encodeURIComponent).join('/');
+    // ?__pdf=1 force <base href="/"> côté serveur pour que les assets JS chargent correctement
+    // sans passer par le proxy (qui requiert une auth)
+    const url = `http://localhost:${localPort}/?__pdf=1#/${encodeURIComponent(project)}/${encodedPath}`;
+    let browser;
+    try {
+        browser = await puppeteer.launch({
+            executablePath,
+            headless: true,
+            args: ['--no-sandbox', '--disable-setuid-sandbox'],
+        });
+        const page = await browser.newPage();
+        await page.emulateMediaType('print');
+        await page.goto(url, { waitUntil: 'load', timeout: 15000 });
+        await page.waitForFunction(() => !!window.__pdfReady && (window.__mermaidPending ?? 0) === 0, { timeout: 15000 });
+        const pdfBuffer = await page.pdf({
+            format: 'A4',
+            scale,
+            printBackground: false,
+            margin: { top: '20mm', bottom: '20mm', left: '15mm', right: '15mm' },
+        });
+        return new Response(Buffer.from(pdfBuffer), {
+            status: 200,
+            headers: {
+                'Content-Type': 'application/pdf',
+                'Content-Disposition': `attachment; filename="${encodeURIComponent(docId.split('/').pop() ?? 'document')}.pdf"`,
+            },
+        });
+    }
+    catch (err) {
+        logger.error(`PDF generation failed: ${err.message}`);
+        return c.json({ error: 'pdf_generation_failed', message: err.message }, 500);
+    }
+    finally {
+        if (browser)
+            await browser.close();
+    }
+});
 // Static files
 app.use("/assets/*", serveStatic({ root: path.relative(process.cwd(), absoluteStaticRoot) }));
 function getHtmlBaseHref(appPath) {
@@ -444,7 +558,9 @@ app.get("/*", (c, next) => {
     try {
         const indexPath = path.join(absoluteStaticRoot, "index.html");
         if (fs.existsSync(indexPath)) {
-            const baseHref = getHtmlBaseHref(configuredAppPath);
+            // ?__pdf=1 : accès direct depuis Puppeteer — pas de préfixe proxy dans <base href>
+            const isPdfRender = c.req.query('__pdf') === '1';
+            const baseHref = isPdfRender ? '/' : getHtmlBaseHref(configuredAppPath);
             const html = fs
                 .readFileSync(indexPath, "utf8")
                 .replace("<head>", `<head>\n    <base href="${baseHref}" />`);
@@ -494,7 +610,9 @@ async function startServer() {
         return;
     }
     const finalPort = result.port;
+    localPort = finalPort;
     const publicUrl = result.url || `${proxyUrl}${appPath}`;
+    guiPublicUrl = publicUrl;
     logger.info(`Registered with proxy. Public URL: ${publicUrl}, Local Port: ${finalPort}`);
     const cleanupProxy = async () => {
         if (proxyClient)

package/dist/src/index.js

@@ -17,6 +17,7 @@ import { listDocs } from "./tools/list-docs.js";
 import { updateDoc } from "./tools/update-doc.js";
 import { searchDocs } from "./tools/search-docs.js";
 import { checkFreshness, computeFreshness } from "./tools/check-freshness.js";
+import { findAndHashSection } from "./core/section-tracker.js";
 import { setProject } from "./tools/set-project.js";
 import { listProjects } from "./tools/list-projects.js";
 import { refreshFileSnapshot } from "./tools/refresh-file-snapshot.js";
@@ -137,6 +138,9 @@ function handleIPCMessage(msg) {
     else if (msg.type === "UPDATE_DOC") {
         handleUpdateDocIPC(msg);
     }
+    else if (msg.type === "GET_FILE_SECTION") {
+        handleGetFileSection(msg);
+    }
     else {
         logger.debug(`Unhandled message from GUI: ${msg.type}`);
     }
@@ -383,6 +387,44 @@ async function handleUpdateDocIPC(msg) {
         });
     }
 }
+async function handleGetFileSection(msg) {
+    try {
+        const { docId, filePath } = msg.data;
+        const resolved = await storageEngine.resolveDoc(docId);
+        if (!resolved)
+            throw new Error("Doc not found");
+        const trackedFile = resolved.doc.tracked_files.find((f) => f.path === filePath);
+        if (!trackedFile || !trackedFile.sections?.length)
+            throw new Error("No sections for this file");
+        const absolutePath = path.resolve(process.cwd(), filePath);
+        const fileLines = fs.readFileSync(absolutePath, "utf-8").split("\n");
+        const sections = trackedFile.sections.map((section) => {
+            const result = findAndHashSection(absolutePath, section);
+            if (!result.found)
+                return null;
+            const { start, end } = result.lines;
+            return {
+                start,
+                end,
+                code: fileLines.slice(start - 1, end).join("\n"),
+            };
+        }).filter(Boolean);
+        broadcastToGUI({
+            type: "GET_FILE_SECTION_RESPONSE",
+            correlationId: msg.correlationId,
+            data: { sections, filePath },
+            timestamp: new Date().toISOString(),
+        });
+    }
+    catch (err) {
+        broadcastToGUI({
+            type: "GET_FILE_SECTION_RESPONSE",
+            correlationId: msg.correlationId,
+            error: err.message,
+            timestamp: new Date().toISOString(),
+        });
+    }
+}
 async function handleCheckFreshness(msg) {
     try {
         const resolved = await storageEngine.resolveDoc(msg.data.id ?? msg.data.path);

package/dist/src/tools/search-docs.js

@@ -13,7 +13,7 @@ export async function searchDocs(storageEngine, embeddingEngine, args) {
             return { content: [{ type: "text", text: "No matching documentation entries found." }] };
         }
         const lines = results.map((r, i) => {
-            const projectTag = r.project && r.project !== config.currentProject ? ` _(project: ${r.project})_` : "";
+            const projectTag = r.project ? ` _(project: ${r.project})_` : "";
             return `${i + 1}. **${r.title}** [${r.id}]${projectTag} — score: ${(r.score * 100).toFixed(1)}%\n   ${r.excerpt}...`;
         });
         return {

package/dist/src/version.d.ts

@@ -1 +1 @@
-export declare const APP_VERSION = "1.0.43";
+export declare const APP_VERSION = "1.0.48";

package/dist/src/version.js

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

package/gui/dist/assets/{arc-d6vCj415.js → arc-CTYsyt8O.js}

@@ -1 +1 @@
-import{a0 as ln,a1 as an,a2 as y,a3 as tn,a4 as H,a5 as q,a6 as _,a7 as un,a8 as rn,a9 as L,aa as o,ab as B,ac as sn,ad as on,ae as fn}from"./index-r9vO4oVD.js";function cn(l){return l.innerRadius}function yn(l){return l.outerRadius}function gn(l){return l.startAngle}function dn(l){return l.endAngle}function mn(l){return l&&l.padAngle}function pn(l,h,I,D,v,A,C,a){var O=I-l,i=D-h,n=C-v,d=a-A,u=d*O-n*i;if(!(u*u<y))return u=(n*(h-A)-d*(l-v))/u,[l+u*O,h+u*i]}function W(l,h,I,D,v,A,C){var a=l-I,O=h-D,i=(C?A:-A)/L(a*a+O*O),n=i*O,d=-i*a,u=l+n,s=h+d,f=I+n,c=D+d,F=(u+f)/2,t=(s+c)/2,m=f-u,g=c-s,R=m*m+g*g,T=v-A,P=u*c-f*s,S=(g<0?-1:1)*L(fn(0,T*T*R-P*P)),j=(P*g-m*S)/R,z=(-P*m-g*S)/R,w=(P*g+m*S)/R,p=(-P*m+g*S)/R,x=j-F,e=z-t,r=w-F,G=p-t;return x*x+e*e>r*r+G*G&&(j=w,z=p),{cx:j,cy:z,x01:-n,y01:-d,x11:j*(v/T-1),y11:z*(v/T-1)}}function hn(){var l=cn,h=yn,I=B(0),D=null,v=gn,A=dn,C=mn,a=null,O=ln(i);function i(){var n,d,u=+l.apply(this,arguments),s=+h.apply(this,arguments),f=v.apply(this,arguments)-an,c=A.apply(this,arguments)-an,F=un(c-f),t=c>f;if(a||(a=n=O()),s<u&&(d=s,s=u,u=d),!(s>y))a.moveTo(0,0);else if(F>tn-y)a.moveTo(s*H(f),s*q(f)),a.arc(0,0,s,f,c,!t),u>y&&(a.moveTo(u*H(c),u*q(c)),a.arc(0,0,u,c,f,t));else{var m=f,g=c,R=f,T=c,P=F,S=F,j=C.apply(this,arguments)/2,z=j>y&&(D?+D.apply(this,arguments):L(u*u+s*s)),w=_(un(s-u)/2,+I.apply(this,arguments)),p=w,x=w,e,r;if(z>y){var G=sn(z/u*q(j)),M=sn(z/s*q(j));(P-=G*2)>y?(G*=t?1:-1,R+=G,T-=G):(P=0,R=T=(f+c)/2),(S-=M*2)>y?(M*=t?1:-1,m+=M,g-=M):(S=0,m=g=(f+c)/2)}var J=s*H(m),K=s*q(m),N=u*H(T),Q=u*q(T);if(w>y){var U=s*H(g),V=s*q(g),X=u*H(R),Y=u*q(R),E;if(F<rn)if(E=pn(J,K,X,Y,U,V,N,Q)){var Z=J-E[0],$=K-E[1],b=U-E[0],k=V-E[1],nn=1/q(on((Z*b+$*k)/(L(Z*Z+$*$)*L(b*b+k*k)))/2),en=L(E[0]*E[0]+E[1]*E[1]);p=_(w,(u-en)/(nn-1)),x=_(w,(s-en)/(nn+1))}else p=x=0}S>y?x>y?(e=W(X,Y,J,K,s,x,t),r=W(U,V,N,Q,s,x,t),a.moveTo(e.cx+e.x01,e.cy+e.y01),x<w?a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,s,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),!t),a.arc(r.cx,r.cy,x,o(r.y11,r.x11),o(r.y01,r.x01),!t))):(a.moveTo(J,K),a.arc(0,0,s,m,g,!t)):a.moveTo(J,K),!(u>y)||!(P>y)?a.lineTo(N,Q):p>y?(e=W(N,Q,U,V,u,-p,t),r=W(J,K,X,Y,u,-p,t),a.lineTo(e.cx+e.x01,e.cy+e.y01),p<w?a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,u,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),t),a.arc(r.cx,r.cy,p,o(r.y11,r.x11),o(r.y01,r.x01),!t))):a.arc(0,0,u,T,R,t)}if(a.closePath(),n)return a=null,n+""||null}return i.centroid=function(){var n=(+l.apply(this,arguments)+ +h.apply(this,arguments))/2,d=(+v.apply(this,arguments)+ +A.apply(this,arguments))/2-rn/2;return[H(d)*n,q(d)*n]},i.innerRadius=function(n){return arguments.length?(l=typeof n=="function"?n:B(+n),i):l},i.outerRadius=function(n){return arguments.length?(h=typeof n=="function"?n:B(+n),i):h},i.cornerRadius=function(n){return arguments.length?(I=typeof n=="function"?n:B(+n),i):I},i.padRadius=function(n){return arguments.length?(D=n==null?null:typeof n=="function"?n:B(+n),i):D},i.startAngle=function(n){return arguments.length?(v=typeof n=="function"?n:B(+n),i):v},i.endAngle=function(n){return arguments.length?(A=typeof n=="function"?n:B(+n),i):A},i.padAngle=function(n){return arguments.length?(C=typeof n=="function"?n:B(+n),i):C},i.context=function(n){return arguments.length?(a=n??null,i):a},i}export{hn as d};
+import{a0 as ln,a1 as an,a2 as y,a3 as tn,a4 as H,a5 as q,a6 as _,a7 as un,a8 as rn,a9 as L,aa as o,ab as B,ac as sn,ad as on,ae as fn}from"./index-BMSuP895.js";function cn(l){return l.innerRadius}function yn(l){return l.outerRadius}function gn(l){return l.startAngle}function dn(l){return l.endAngle}function mn(l){return l&&l.padAngle}function pn(l,h,I,D,v,A,C,a){var O=I-l,i=D-h,n=C-v,d=a-A,u=d*O-n*i;if(!(u*u<y))return u=(n*(h-A)-d*(l-v))/u,[l+u*O,h+u*i]}function W(l,h,I,D,v,A,C){var a=l-I,O=h-D,i=(C?A:-A)/L(a*a+O*O),n=i*O,d=-i*a,u=l+n,s=h+d,f=I+n,c=D+d,F=(u+f)/2,t=(s+c)/2,m=f-u,g=c-s,R=m*m+g*g,T=v-A,P=u*c-f*s,S=(g<0?-1:1)*L(fn(0,T*T*R-P*P)),j=(P*g-m*S)/R,z=(-P*m-g*S)/R,w=(P*g+m*S)/R,p=(-P*m+g*S)/R,x=j-F,e=z-t,r=w-F,G=p-t;return x*x+e*e>r*r+G*G&&(j=w,z=p),{cx:j,cy:z,x01:-n,y01:-d,x11:j*(v/T-1),y11:z*(v/T-1)}}function hn(){var l=cn,h=yn,I=B(0),D=null,v=gn,A=dn,C=mn,a=null,O=ln(i);function i(){var n,d,u=+l.apply(this,arguments),s=+h.apply(this,arguments),f=v.apply(this,arguments)-an,c=A.apply(this,arguments)-an,F=un(c-f),t=c>f;if(a||(a=n=O()),s<u&&(d=s,s=u,u=d),!(s>y))a.moveTo(0,0);else if(F>tn-y)a.moveTo(s*H(f),s*q(f)),a.arc(0,0,s,f,c,!t),u>y&&(a.moveTo(u*H(c),u*q(c)),a.arc(0,0,u,c,f,t));else{var m=f,g=c,R=f,T=c,P=F,S=F,j=C.apply(this,arguments)/2,z=j>y&&(D?+D.apply(this,arguments):L(u*u+s*s)),w=_(un(s-u)/2,+I.apply(this,arguments)),p=w,x=w,e,r;if(z>y){var G=sn(z/u*q(j)),M=sn(z/s*q(j));(P-=G*2)>y?(G*=t?1:-1,R+=G,T-=G):(P=0,R=T=(f+c)/2),(S-=M*2)>y?(M*=t?1:-1,m+=M,g-=M):(S=0,m=g=(f+c)/2)}var J=s*H(m),K=s*q(m),N=u*H(T),Q=u*q(T);if(w>y){var U=s*H(g),V=s*q(g),X=u*H(R),Y=u*q(R),E;if(F<rn)if(E=pn(J,K,X,Y,U,V,N,Q)){var Z=J-E[0],$=K-E[1],b=U-E[0],k=V-E[1],nn=1/q(on((Z*b+$*k)/(L(Z*Z+$*$)*L(b*b+k*k)))/2),en=L(E[0]*E[0]+E[1]*E[1]);p=_(w,(u-en)/(nn-1)),x=_(w,(s-en)/(nn+1))}else p=x=0}S>y?x>y?(e=W(X,Y,J,K,s,x,t),r=W(U,V,N,Q,s,x,t),a.moveTo(e.cx+e.x01,e.cy+e.y01),x<w?a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,s,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),!t),a.arc(r.cx,r.cy,x,o(r.y11,r.x11),o(r.y01,r.x01),!t))):(a.moveTo(J,K),a.arc(0,0,s,m,g,!t)):a.moveTo(J,K),!(u>y)||!(P>y)?a.lineTo(N,Q):p>y?(e=W(N,Q,U,V,u,-p,t),r=W(J,K,X,Y,u,-p,t),a.lineTo(e.cx+e.x01,e.cy+e.y01),p<w?a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,u,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),t),a.arc(r.cx,r.cy,p,o(r.y11,r.x11),o(r.y01,r.x01),!t))):a.arc(0,0,u,T,R,t)}if(a.closePath(),n)return a=null,n+""||null}return i.centroid=function(){var n=(+l.apply(this,arguments)+ +h.apply(this,arguments))/2,d=(+v.apply(this,arguments)+ +A.apply(this,arguments))/2-rn/2;return[H(d)*n,q(d)*n]},i.innerRadius=function(n){return arguments.length?(l=typeof n=="function"?n:B(+n),i):l},i.outerRadius=function(n){return arguments.length?(h=typeof n=="function"?n:B(+n),i):h},i.cornerRadius=function(n){return arguments.length?(I=typeof n=="function"?n:B(+n),i):I},i.padRadius=function(n){return arguments.length?(D=n==null?null:typeof n=="function"?n:B(+n),i):D},i.startAngle=function(n){return arguments.length?(v=typeof n=="function"?n:B(+n),i):v},i.endAngle=function(n){return arguments.length?(A=typeof n=="function"?n:B(+n),i):A},i.padAngle=function(n){return arguments.length?(C=typeof n=="function"?n:B(+n),i):C},i.context=function(n){return arguments.length?(a=n??null,i):a},i}export{hn as d};