@imenam/mcp-documentor 1.0.91 → 1.0.93

package/dist/src/index.js

@@ -54,7 +54,8 @@ import { getImage } from "./tools/get-image.js";
 import { SyncEngine } from "./core/git-sync.js";
 import { syncStatus, pullDocs, pushDocs, syncDocs, resolveSyncConflict } from "./tools/sync.js";
 import { listConflicts, getConflictHunks, resolveConflictHunks } from "./tools/conflicts.js";
-import { textSourceDescriptions, } from "../shared/schemas/doc.schema.js";
+import { hashDocContent, PublicationStore } from "./core/publication-store.js";
+import { MoveDocArgsSchema, textSourceDescriptions, } from "../shared/schemas/doc.schema.js";
 import { isReadOnly, WRITE_TOOLS } from "../shared/read-only.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -109,6 +110,7 @@ historyStore.init(storageEngine.getDataDir());
 storageEngine.setHistoryStore(historyStore);
 const syncEngine = new SyncEngine(storageEngine);
 const localState = new LocalState(storageEngine.getDataDir());
+const publicationStore = new PublicationStore(storageEngine.getDataDir());
 setBlobStoreDir(path.join(storageEngine.getDataDir(), "blob-cache"));
 setCodeRootProvider((project) => localState.getCodeRoot(project));
 setCodeSourceProvider({
@@ -120,7 +122,6 @@ let guiLauncher;
 let guiStatus = "disabled";
 let guiUrl = null;
 let guiStartWaiter = null;
-const sseControllers = new Set();
 function broadcastToGUI(message) {
     const child = guiLauncher.getProcess();
     if (child?.connected) {
@@ -248,6 +249,18 @@ function dispatchIPCMessage(msg) {
             return { success: true };
         });
     }
+    else if (msg.type === "LIST_PUBLICATIONS") {
+        replyToGUI(msg, "LIST_PUBLICATIONS_RESPONSE", () => listPublications(msg.data?.project || undefined));
+    }
+    else if (msg.type === "PUBLISH_DOC") {
+        replyToGUI(msg, "PUBLISH_DOC_RESPONSE", () => publishDoc(msg.data ?? {}));
+    }
+    else if (msg.type === "UPDATE_PUBLICATION") {
+        replyToGUI(msg, "UPDATE_PUBLICATION_RESPONSE", () => updatePublication(msg.data ?? {}));
+    }
+    else if (msg.type === "UNPUBLISH_DOC") {
+        replyToGUI(msg, "UNPUBLISH_DOC_RESPONSE", () => unpublishDoc(msg.data ?? {}));
+    }
     else {
         logger.debug(`Unhandled message from GUI: ${msg.type}`);
     }
@@ -359,6 +372,14 @@ async function handleGetInitialState(msg) {
     }
     catch (err) {
         logger.error(`Failed to get initial state: ${err.message}`);
+        if (msg.correlationId) {
+            broadcastToGUI({
+                type: "INITIAL_STATE",
+                correlationId: msg.correlationId,
+                error: err.message,
+                timestamp: new Date().toISOString(),
+            });
+        }
     }
 }
 async function handleGetConfig(msg) {
@@ -909,6 +930,95 @@ async function handleGetDocVersionIPC(msg) {
         });
     }
 }
+/** A publication as the GUI lists it: the stored record plus the state of the document it froze. */
+async function describePublication(publication) {
+    const doc = await storageEngine.getDoc(publication.docId, publication.project);
+    const status = !doc
+        ? "missing"
+        : hashDocContent(doc.title, doc.content) === publication.contentHash
+            ? "current"
+            : "modified";
+    return {
+        id: publication.id,
+        token: publication.token,
+        project: publication.project,
+        docId: publication.docId,
+        title: publication.title,
+        version: publication.version,
+        note: publication.note,
+        createdAt: publication.createdAt,
+        publishedAt: publication.publishedAt,
+        status,
+        currentVersion: doc ? latestVersion(publication.project, publication.docId) : null,
+    };
+}
+function latestVersion(project, docId) {
+    return historyStore.listVersions(project, docId)[0]?.version ?? null;
+}
+function assertWritable() {
+    if (isReadOnly())
+        throw new Error("READ_ONLY mode: publishing is disabled");
+}
+function broadcastPublicationsChanged(project) {
+    broadcastToGUI({ type: "PUBLICATIONS_CHANGED", data: { project }, timestamp: new Date().toISOString() });
+}
+async function listPublications(project) {
+    const publications = publicationStore.list().filter((p) => !project || p.project === project);
+    return { publications: await Promise.all(publications.map(describePublication)) };
+}
+/** The document as it is now, frozen with the version note. */
+async function freezeInput(project, docId, note) {
+    const doc = await storageEngine.getDoc(docId, project);
+    if (!doc)
+        throw new Error(`Doc "${docId}" not found in project "${project}"`);
+    return {
+        project,
+        docId,
+        title: doc.title,
+        content: doc.content,
+        version: latestVersion(project, docId),
+        note: note,
+    };
+}
+async function publishDoc(data) {
+    assertWritable();
+    if (!data.project || !data.id)
+        throw new Error("project and id are required");
+    const publication = publicationStore.publish(await freezeInput(data.project, data.id, data.note));
+    logger.info(`Published [${publication.project}] ${publication.docId}`);
+    broadcastPublicationsChanged(publication.project);
+    return { publication: await describePublication(publication) };
+}
+async function updatePublication(data) {
+    assertWritable();
+    const existing = data.publicationId ? publicationStore.get(data.publicationId) : undefined;
+    if (!existing)
+        throw new Error(`Publication "${data.publicationId}" does not exist`);
+    const publication = publicationStore.update(existing.id, await freezeInput(existing.project, existing.docId, data.note));
+    logger.info(`Publication of [${publication.project}] ${publication.docId} updated`);
+    broadcastPublicationsChanged(publication.project);
+    return { publication: await describePublication(publication) };
+}
+async function unpublishDoc(data) {
+    assertWritable();
+    if (!data.publicationId)
+        throw new Error("publicationId is required");
+    const publication = publicationStore.unpublish(data.publicationId);
+    logger.info(`Unpublished [${publication.project}] ${publication.docId}`);
+    broadcastPublicationsChanged(publication.project);
+    return { success: true };
+}
+/** A moved document keeps its publication: the link stays valid and its state follows the new path. */
+function movePublication(args) {
+    const parsed = MoveDocArgsSchema.parse(args);
+    const newProject = parsed.new_project ?? parsed.project;
+    const moved = publicationStore.moveDoc(parsed.project, parsed.path, newProject, parsed.new_path ?? parsed.path);
+    if (!moved)
+        return;
+    broadcastPublicationsChanged(parsed.project);
+    if (newProject !== parsed.project)
+        broadcastPublicationsChanged(newProject);
+}
 guiLauncher = new GuiLauncher({
     guiPath: path.join(__dirname, "gui-worker.js"),
     env: { ...process.env },
@@ -1640,8 +1750,12 @@ async function handleToolCall(request) {
                 return await checkLinks(storageEngine, args);
             case "delete_doc":
                 return await deleteDoc(storageEngine, embeddingEngine, args);
-            case "move_doc":
-                return await moveDoc(storageEngine, embeddingEngine, args);
+            case "move_doc": {
+                const result = await moveDoc(storageEngine, embeddingEngine, args);
+                if (!result.isError)
+                    movePublication(args);
+                return result;
+            }
             case "get_doc_tree":
                 return await getDocTree(storageEngine, args);
             case "list_doc_versions":

package/gui/dist/assets/DocContent-BxncLHIS.css

@@ -0,0 +1 @@
+*{margin:0;padding:0;box-sizing:border-box}body{font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,sans-serif;background:#090b0f;color:#e1e4e8;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}#root{width:100%;height:100vh}.doc-inline-link{display:inline;padding:0;border:none;background:none;color:#58a6ff;cursor:pointer;font-size:inherit;font-family:inherit;text-decoration:underline;text-underline-offset:2px}.doc-inline-link:hover{color:#79c0ff}.doc-inline-link--broken{color:#f85149;cursor:not-allowed;text-decoration:underline wavy}.doc-inline-link--cross-project{color:#d2a8ff}.doc-inline-link--cross-project:hover{color:#e2c0ff}.doc-content h1{font-size:2em;margin:.67em 0;border-bottom:1px solid #21262d;padding-bottom:.3em}.doc-content h2{font-size:1.5em;margin:.83em 0;border-bottom:1px solid #21262d;padding-bottom:.3em}.doc-content h3{font-size:1.25em;margin:1em 0}.doc-content h4{font-size:1em;margin:1.33em 0}.doc-content p{margin:1em 0;line-height:1.6}.doc-content code{background:#161b22;padding:2px 6px;border-radius:4px;font-family:Fira Code,Cascadia Code,monospace;font-size:.9em;font-variant-ligatures:none}.doc-content pre{background:#161b22;padding:16px;border-radius:8px;overflow-x:auto;border:1px solid #30363d}.doc-content pre code{background:none;padding:0}.doc-content ul,.doc-content ol{padding-left:2em;margin:1em 0}.doc-content li{margin:.25em 0;line-height:1.6}.doc-content table{border-collapse:collapse;width:100%;margin:1em 0}.doc-content th,.doc-content td{border:1px solid #30363d;padding:8px 12px;text-align:left}.doc-content th{background:#161b22;font-weight:600}.doc-content a{color:#58a6ff;text-decoration:none}.doc-content a:hover{text-decoration:underline}.doc-content blockquote{border-left:3px solid #30363d;padding-left:16px;margin:1em 0;color:#8b949e}.code-block-wrapper{border:1px solid #30363d;border-radius:6px;margin:12px 0;overflow:hidden}.code-block-header{display:flex;align-items:center;justify-content:space-between;padding:4px 12px;background:#21262d;border-bottom:1px solid #30363d}.code-block-lang-select{background:transparent;border:none;color:#8b949e;font-size:11px;font-family:Fira Code,Cascadia Code,Consolas,monospace;cursor:pointer;outline:none;padding:2px 0}.code-block-lang-select:hover{color:#c9d1d9}.code-block-lang{color:#8b949e;font-size:11px;font-family:Fira Code,Cascadia Code,Consolas,monospace;padding:2px 0}.code-block-lang-select option{background:#21262d;color:#c9d1d9}.code-block-copy-btn{background:none;border:1px solid #30363d;color:#8b949e;font-size:11px;cursor:pointer;padding:2px 8px;border-radius:4px;transition:all .15s}.code-block-copy-btn:hover{background:#30363d;color:#c9d1d9}.mermaid-block-wrapper{border:1px solid #30363d;border-radius:6px;margin:12px 0;overflow:hidden;background:#161b22}.mermaid-block-header{display:flex;align-items:center;justify-content:space-between;padding:4px 12px;background:#21262d;border-bottom:1px solid #30363d}.mermaid-block-title{color:#8b949e;font-family:Fira Code,Cascadia Code,Consolas,monospace;font-size:11px}.mermaid-block-actions{display:flex;align-items:center;gap:8px}.mermaid-zoom-controls{display:flex;align-items:center;gap:2px}.mermaid-zoom-btn{background:#30363d;border:1px solid #484f58;color:#c9d1d9;border-radius:4px;width:22px;height:22px;font-size:14px;line-height:1;cursor:pointer;padding:0;display:flex;align-items:center;justify-content:center;transition:background .15s}.mermaid-zoom-btn:hover:not(:disabled){background:#484f58}.mermaid-zoom-btn:disabled{opacity:.35;cursor:not-allowed}.mermaid-zoom-reset{background:transparent;border:1px solid #484f58;color:#8b949e;border-radius:4px;height:22px;min-width:40px;font-size:11px;font-family:Fira Code,Cascadia Code,Consolas,monospace;cursor:pointer;padding:0 4px;transition:background .15s,color .15s}.mermaid-zoom-reset:hover{background:#30363d;color:#c9d1d9}.mermaid-block-content{padding:16px;overflow:auto}.mermaid-block-zoom-container{display:block;transform-origin:top center;transition:transform .15s ease}.mermaid-block-zoom-container svg{display:block;max-width:100%;height:auto;margin:0 auto}.mermaid-block-error{margin:0;color:#f85149;font-family:Fira Code,Cascadia Code,Consolas,monospace;font-size:13px;line-height:1.5;white-space:pre-wrap}.doc-content img.doc-image{max-width:100%;height:auto;border-radius:6px;margin:8px 0;display:block}