@imenam/mcp-documentor 1.0.79 → 1.0.80

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

@@ -1,9 +1,14 @@
-import type { DocEntry, DocSummary, ExportBundle } from "../../shared/schemas/doc.schema.js";
+import type { DocEntry, DocSummary, TrackedFile, ExportBundle } from "../../shared/schemas/doc.schema.js";
 import type { HistoryStore } from "./history-store.js";
 interface GlobalConfig {
     projects: string[];
     foldersMigrated?: boolean;
 }
+/** One doc as a project listing yields it: the GUI-facing summary, plus what it tracks. */
+export interface DocListing {
+    summary: DocSummary;
+    tracked_files: TrackedFile[];
+}
 /**
  * GitHub sync settings. Sourced exclusively from environment variables — the
  * repository, branch and token are administration concerns and must never be
@@ -43,6 +48,15 @@ export declare class StorageEngine {
     saveDoc(doc: DocEntry, project: string, changeType?: "create" | "update" | "patch"): Promise<void>;
     getDoc(id: string, project: string): Promise<DocEntry | null>;
     listDocs(project: string): Promise<DocSummary[]>;
+    /**
+     * Same listing, plus the tracked files parsed from the very same read.
+     *
+     * Freshness has to know what each doc tracks, and fetching that with `getDoc` per summary read
+     * and re-parsed every file of the project a second time. Callers that scan a whole project use
+     * this instead; `tracked_files` stays out of `DocSummary` so it is never shipped to the GUI,
+     * which only needs the stale/broken flags.
+     */
+    listDocsDetailed(project: string): Promise<DocListing[]>;
     deleteDoc(id: string, project: string): Promise<boolean>;
     moveDoc(oldId: string, newId: string, project: string): Promise<boolean>;
     getBundles(): ExportBundle[];

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

@@ -151,11 +151,22 @@ export class StorageEngine {
         };
     }
     async listDocs(project) {
+        return (await this.listDocsDetailed(project)).map((listing) => listing.summary);
+    }
+    /**
+     * Same listing, plus the tracked files parsed from the very same read.
+     *
+     * Freshness has to know what each doc tracks, and fetching that with `getDoc` per summary read
+     * and re-parsed every file of the project a second time. Callers that scan a whole project use
+     * this instead; `tracked_files` stays out of `DocSummary` so it is never shipped to the GUI,
+     * which only needs the stale/broken flags.
+     */
+    async listDocsDetailed(project) {
         const projectDir = this.getProjectDir(project);
         if (!fs.existsSync(projectDir))
             return [];
         const files = this.walkMdFiles(projectDir);
-        const summaries = [];
+        const listings = [];
         for (const filePath of files) {
             try {
                 const raw = fs.readFileSync(filePath, "utf-8");
@@ -164,21 +175,24 @@ export class StorageEngine {
                 const relPath = path.relative(projectDir, filePath);
                 const id = relPath.replace(/\.md$/, "").split(path.sep).join("/");
                 const folder = id.includes("/") ? id.split("/").slice(0, -1).join("/") : undefined;
-                summaries.push({
-                    id,
-                    title: data.title ?? "",
-                    createdAt: stat.birthtime.toISOString(),
-                    updatedAt: data.updatedAt ?? "",
-                    tags: (data.tags ?? []),
-                    folder,
-                    isStale: false,
+                listings.push({
+                    summary: {
+                        id,
+                        title: data.title ?? "",
+                        createdAt: stat.birthtime.toISOString(),
+                        updatedAt: data.updatedAt ?? "",
+                        tags: (data.tags ?? []),
+                        folder,
+                        isStale: false,
+                    },
+                    tracked_files: (data.tracked_files ?? []),
                 });
             }
             catch (err) {
                 logger.warn(`Failed to read doc ${filePath}: ${err}`);
             }
         }
-        return summaries;
+        return listings;
     }
     // resolveDoc() (first project whose tree contained the path) was removed on purpose:
     // it silently sent reads and writes to the wrong project when the same doc path

package/dist/src/index.js

@@ -204,16 +204,15 @@ function requireProjectFromIPC(msg) {
 }
 /** Loads one project's summaries and flags each entry as stale/broken. */
 async function listDocsWithFreshness(project) {
-    const docs = await storageEngine.listDocs(project);
-    await mapWithConcurrency(docs, DOC_CONCURRENCY, async (doc) => {
-        const full = await storageEngine.getDoc(doc.id, project);
-        if (!full || full.tracked_files.length === 0)
+    const listings = await storageEngine.listDocsDetailed(project);
+    await mapWithConcurrency(listings, DOC_CONCURRENCY, async ({ summary, tracked_files }) => {
+        if (tracked_files.length === 0)
             return;
-        const report = await computeFreshness(full.tracked_files, project);
-        doc.isStale = report.status === "stale" || report.status === "broken";
-        doc.isBroken = report.status === "broken";
+        const report = await computeFreshness(tracked_files, project);
+        summary.isStale = report.status === "stale" || report.status === "broken";
+        summary.isBroken = report.status === "broken";
     });
-    return docs;
+    return listings.map((listing) => listing.summary);
 }
 /**
  * Tells every connected GUI that one project's docs changed. Clients showing

package/dist/src/tools/check-freshness.js

@@ -153,9 +153,9 @@ function renderUntrackedList(titles, heading) {
     return `\n\n${heading}\n${shown.join("\n")}${suffix}`;
 }
 async function scanProjectFreshness(storageEngine, project) {
-    const summaries = await storageEngine.listDocs(project);
+    const listings = await storageEngine.listDocsDetailed(project);
     const scan = {
-        docCount: summaries.length,
+        docCount: listings.length,
         stale: [],
         noTracking: [],
         broken: [],
@@ -163,14 +163,11 @@ async function scanProjectFreshness(storageEngine, project) {
         unverifiable: 0,
         source: getCodeSource(project).label,
     };
-    const checked = await mapWithConcurrency(summaries, DOC_CONCURRENCY, async (summary) => {
-        const doc = await storageEngine.getDoc(summary.id, project);
-        return doc ? { doc, report: await computeFreshness(doc.tracked_files, project) } : undefined;
-    });
-    for (const entry of checked) {
-        if (!entry)
-            continue;
-        const { doc, report } = entry;
+    const checked = await mapWithConcurrency(listings, DOC_CONCURRENCY, async ({ summary, tracked_files }) => ({
+        doc: summary,
+        report: await computeFreshness(tracked_files, project),
+    }));
+    for (const { doc, report } of checked) {
         if (report.sourceError)
             scan.sourceError = report.sourceError;
         if (report.status === "broken") {

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

@@ -4,15 +4,15 @@ import { mapWithConcurrency } from "../core/concurrency.js";
  * Fills in each summary's staleness flags, checking several docs at once — a listing is a
  * whole-project scan, and doing it one doc at a time is what made large projects time out.
  */
-async function flagStaleness(storageEngine, summaries, project) {
-    await mapWithConcurrency(summaries, DOC_CONCURRENCY, async (summary) => {
-        const doc = await storageEngine.getDoc(summary.id, project);
-        if (!doc || doc.tracked_files.length === 0)
+async function flagStaleness(listings, project) {
+    await mapWithConcurrency(listings, DOC_CONCURRENCY, async ({ summary, tracked_files }) => {
+        if (tracked_files.length === 0)
             return;
-        const report = await computeFreshness(doc.tracked_files, project);
+        const report = await computeFreshness(tracked_files, project);
         summary.isStale = report.status === "stale";
         summary.isBroken = report.status === "broken";
     });
+    return listings.map((listing) => listing.summary);
 }
 function renderProjectDocs(summaries, totalLabel) {
     if (summaries.length === 0)
@@ -52,8 +52,7 @@ export async function listDocs(storageEngine, args) {
         const isMultiProject = projectsToList.length > 1;
         if (!isMultiProject) {
             const proj = projectsToList[0];
-            const summaries = await storageEngine.listDocs(proj);
-            await flagStaleness(storageEngine, summaries, proj);
+            const summaries = await flagStaleness(await storageEngine.listDocsDetailed(proj), proj);
             if (summaries.length === 0) {
                 return { content: [{ type: "text", text: `No documentation entries found in project "${proj}".` }] };
             }
@@ -64,8 +63,7 @@ export async function listDocs(storageEngine, args) {
         const lines = [];
         let grandTotal = 0;
         for (const proj of projectsToList) {
-            const summaries = await storageEngine.listDocs(proj);
-            await flagStaleness(storageEngine, summaries, proj);
+            const summaries = await flagStaleness(await storageEngine.listDocsDetailed(proj), proj);
             grandTotal += summaries.length;
             lines.push(`\n🗂 ${proj} (${summaries.length})`);
             lines.push(renderProjectDocs(summaries, ""));

package/dist/src/version.d.ts

@@ -1 +1 @@
-export declare const APP_VERSION = "1.0.79";
+export declare const APP_VERSION = "1.0.80";

package/dist/src/version.js

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

package/gui/dist/assets/{arc-CsM5OJTM.js → arc-CdXRzMBT.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-Dtv0slFQ.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-T7ZLHNgs.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};