@de-otio/epimethian-mcp 6.8.0 → 6.9.0

package/dist/cli/index.js

@@ -35481,7 +35481,7 @@ async function getPage(pageId, includeBody) {
 async function _rawCreatePage(spaceId, title, body, parentId, clientLabel) {
   const cfg = await getConfig();
   const pageBody = normalizeBodyForSubmit(body);
-  const epimethianTag = `Epimethian v${"6.8.0"}`;
+  const epimethianTag = `Epimethian v${"6.9.0"}`;
   const versionMsg = cfg.attribution && clientLabel ? `Created by ${clientLabel} (via ${epimethianTag})` : `Created by ${epimethianTag}`;
   const payload = {
     title,
@@ -35502,7 +35502,7 @@ async function _rawCreatePage(spaceId, title, body, parentId, clientLabel) {
 async function _rawUpdatePage(pageId, opts) {
   const cfg = await getConfig();
   const newVersion = opts.version + 1;
-  const epimethianTag = `Epimethian v${"6.8.0"}`;
+  const epimethianTag = `Epimethian v${"6.9.0"}`;
   const effectiveClient = cfg.attribution ? opts.clientLabel : void 0;
   let versionMessage;
   if (opts.versionMessage && effectiveClient)
@@ -47715,7 +47715,7 @@ function enforceContentSafetyGuards(input) {
   if (oldLen > SHRINKAGE_GUARD_MIN_OLD_LEN && newLen < oldLen * SHRINKAGE_GUARD_MAX_RATIO && !confirmShrinkage) {
     const pct = Math.round((1 - newLen / oldLen) * 100);
     throw new ConverterError(
-      `Body would shrink from ${oldLen} to ${newLen} characters (${pct}% reduction). This may indicate accidental content loss. Re-submit with confirm_shrinkage: true to proceed, or omit replace_body to use token-aware preservation.`,
+      `Body would shrink from ${oldLen} to ${newLen} characters (${pct}% reduction). This may indicate accidental content loss. Re-submit with confirm_shrinkage: true to proceed (accepted by update_page, update_page_section, and update_page_sections).`,
       SHRINKAGE_NOT_CONFIRMED
     );
   }
@@ -48428,6 +48428,7 @@ async function safePrepareBody(input) {
     confirmDeletions,
     confirmShrinkage,
     confirmStructureLoss,
+    fullPageBody,
     replaceBody,
     allowRawHtml,
     confluenceBaseUrl
@@ -48556,9 +48557,15 @@ Pick one path:
     assertDeletionAckMatches(confirmDeletions, deletedTokens);
   }
   if (scope !== "additive" && currentBody !== void 0) {
+    let guardOld = currentBody;
+    let guardNew = finalStorage;
+    if (scope === "section" && fullPageBody !== void 0 && fullPageBody.includes(currentBody)) {
+      guardOld = fullPageBody;
+      guardNew = fullPageBody.replace(currentBody, () => finalStorage);
+    }
     enforceContentSafetyGuards({
-      oldStorage: currentBody,
-      newStorage: finalStorage,
+      oldStorage: guardOld,
+      newStorage: guardNew,
       confirmShrinkage,
       confirmStructureLoss: confirmStructureLoss || replaceBody === true,
       // confirmDeletions (any truthy form, incl. a non-empty string[]) OR
@@ -48822,6 +48829,8 @@ async function safePrepareMultiSectionBody(input) {
     currentStorage,
     sections,
     confirmDeletions,
+    confirmShrinkage,
+    confirmStructureLoss,
     allowRawHtml,
     confluenceBaseUrl
   } = input;
@@ -48904,6 +48913,10 @@ async function safePrepareMultiSectionBody(input) {
         currentBody: loc.body,
         scope: "section",
         confirmDeletions: confirmDeletions ? true : void 0,
+        confirmShrinkage,
+        confirmStructureLoss,
+        // Measure each section's guards page-relative (see safePrepareBody).
+        fullPageBody: currentStorage,
         ...allowRawHtml !== void 0 ? { allowRawHtml } : {},
         ...confluenceBaseUrl !== void 0 ? { confluenceBaseUrl } : {}
       });
@@ -50278,7 +50291,7 @@ __export(upgrade_exports, {
   runUpgrade: () => runUpgrade
 });
 async function runUpgrade() {
-  const currentVersion = "6.8.0";
+  const currentVersion = "6.9.0";
   console.log(`epimethian-mcp upgrade: current version v${currentVersion}`);
   let pending = await getPendingUpdate();
   if (!pending) {
@@ -62761,6 +62774,8 @@ batch_token: ${batch.token}` + echo;
         ),
         version_message: external_exports.string().optional().describe("Optional version comment"),
         confirm_deletions: external_exports.boolean().default(false).describe("Set to true to acknowledge that your markdown removes preserved macros, emoticons, or rich elements from this section. Required when any preserved element would be deleted."),
+        confirm_shrinkage: external_exports.boolean().default(false).describe("Set to true to acknowledge a large body reduction. The shrinkage guard is measured against the WHOLE page (not the isolated section), so a small edit to a short section will not trip it; this flag is only needed for a genuinely large page-level reduction."),
+        confirm_structure_loss: external_exports.boolean().default(false).describe("Set to true to acknowledge a large drop in heading count, measured against the whole page."),
         confirm_token: external_exports.string().optional().describe("Soft-confirmation token from a prior SOFT_CONFIRMATION_REQUIRED response. Single-use; bound to this exact diff and page version."),
         batch_token: external_exports.string().optional().describe(
           "Batch authorisation token from a prior authorise_destructive_writes call. Bypasses the per-call confirmation gate when valid for this page_id. Validation failures fall through to the per-call confirm_token / soft-confirm flow."
@@ -62771,7 +62786,7 @@ batch_token: ${batch.token}` + echo;
       outputSchema: writeOutputSchema,
       annotations: { destructiveHint: false, idempotentHint: false }
     },
-    async ({ page_id, section, body, find_replace, version: version2, version_message, confirm_deletions, confirm_token, batch_token }) => {
+    async ({ page_id, section, body, find_replace, version: version2, version_message, confirm_deletions, confirm_shrinkage, confirm_structure_loss, confirm_token, batch_token }) => {
       const blocked = writeGuard("update_page_section", config3);
       if (blocked) return blocked;
       let batchReservationId;
@@ -62863,7 +62878,12 @@ batch_token: ${batch.token}` + echo;
             }
           };
         }
-        if (confirm_deletions) {
+        const sectionFlagsSet = listDestructiveFlagsSet({
+          confirmShrinkage: confirm_shrinkage,
+          confirmStructureLoss: confirm_structure_loss,
+          confirmDeletions: confirm_deletions
+        });
+        if (sectionFlagsSet.length > 0) {
           const batchAttempt = await tryBatchTokenForWrite({
             batch_token,
             cloudId,
@@ -62871,7 +62891,7 @@ batch_token: ${batch.token}` + echo;
           });
           batchReservationId = batchAttempt.batchReservationId;
           if (batchReservationId === void 0) {
-            const deletionSummary = tryForecastDeletions(currentSectionBody, body, cfg.url);
+            const deletionSummary = confirm_deletions && body ? tryForecastDeletions(currentSectionBody, body, cfg.url) : null;
             const diffHash = cloudId && pageVersion > 0 ? computeDiffHash(body ?? currentSectionBody, pageVersion) : void 0;
             const tokenResult = await maybeConsumeConfirmToken({
               confirm_token,
@@ -62889,11 +62909,11 @@ batch_token: ${batch.token}` + echo;
             } else if (tokenResult === "no_token") {
               await gateOperation(server, {
                 tool: "update_page_section",
-                summary: `Update section "${section}" in page ${page_id} with confirm_deletions?`,
+                summary: `Update section "${section}" in page ${page_id} with ${sectionFlagsSet.join(", ")}?`,
                 details: {
                   page_id,
                   section,
-                  source: "confirm_deletions",
+                  flags: sectionFlagsSet.join(","),
                   ...deletionSummary ? { deletionSummary } : {}
                 },
                 cloudId,
@@ -62909,6 +62929,10 @@ batch_token: ${batch.token}` + echo;
           currentBody: currentSectionBody,
           scope: "section",
           confirmDeletions: confirm_deletions || void 0,
+          confirmShrinkage: confirm_shrinkage,
+          confirmStructureLoss: confirm_structure_loss,
+          // Measure shrink/structure/floor guards against the whole page.
+          fullPageBody: fullBody,
           confluenceBaseUrl: cfg.url
         });
         const newFullBody = replaceSection(fullBody, section, prepared.finalStorage);
@@ -62931,6 +62955,11 @@ batch_token: ${batch.token}` + echo;
           deletedTokens: prepared.deletedTokens,
           operation: "update_page_section",
           clientLabel: getClientLabel(server),
+          // Recorded for the destructive-flag audit / version-message suffix;
+          // guards already ran in safePrepareBody (page-relative).
+          confirmShrinkage: confirm_shrinkage,
+          confirmStructureLoss: confirm_structure_loss,
+          confirmDeletions: confirm_deletions || void 0,
           cloudId
         });
         const warnings = [];
@@ -62985,6 +63014,8 @@ batch_token: ${batch.token}` + echo;
         confirm_deletions: external_exports.boolean().default(false).describe(
           "Set to true to acknowledge that the aggregated set of sections removes preserved macros, emoticons, or rich elements. Required when ANY section would delete a preserved element. The deletion-summary gate fires once on the AGGREGATE \u2014 a caller cannot bypass the gate by spreading deletions across sections."
         ),
+        confirm_shrinkage: external_exports.boolean().default(false).describe("Set to true to acknowledge a large body reduction. Each section's shrinkage is measured against the WHOLE page, so small edits to short sections will not trip it; needed only for a genuinely large page-level reduction."),
+        confirm_structure_loss: external_exports.boolean().default(false).describe("Set to true to acknowledge a large drop in heading count, measured against the whole page."),
         confirm_token: external_exports.string().optional().describe("Soft-confirmation token from a prior SOFT_CONFIRMATION_REQUIRED response. Single-use; bound to this exact diff and page version."),
         batch_token: external_exports.string().optional().describe(
           "Batch authorisation token from a prior authorise_destructive_writes call. Bypasses the per-call confirmation gate when valid for this page_id. Validation failures fall through to the per-call confirm_token / soft-confirm flow."
@@ -63002,7 +63033,7 @@ batch_token: ${batch.token}` + echo;
       },
       annotations: { destructiveHint: false, idempotentHint: false }
     },
-    async ({ page_id, version: version2, version_message, confirm_deletions, sections, confirm_token, batch_token }) => {
+    async ({ page_id, version: version2, version_message, confirm_deletions, confirm_shrinkage, confirm_structure_loss, sections, confirm_token, batch_token }) => {
       const blocked = writeGuard("update_page_sections", config3);
       if (blocked) return blocked;
       let batchReservationId;
@@ -63020,7 +63051,12 @@ batch_token: ${batch.token}` + echo;
             `Could not resolve current version for page ${page_id} (server returned no version metadata)`
           );
         }
-        if (confirm_deletions) {
+        const sectionsFlagsSet = listDestructiveFlagsSet({
+          confirmShrinkage: confirm_shrinkage,
+          confirmStructureLoss: confirm_structure_loss,
+          confirmDeletions: confirm_deletions
+        });
+        if (sectionsFlagsSet.length > 0) {
           const batchAttempt = await tryBatchTokenForWrite({
             batch_token,
             cloudId,
@@ -63037,27 +63073,29 @@ batch_token: ${batch.token}` + echo;
               other: 0
             };
             let any = false;
-            for (const s of sections) {
-              let currentSectionBody = null;
-              try {
-                currentSectionBody = extractSectionBody(fullBody, s.section);
-              } catch {
-                currentSectionBody = null;
-              }
-              if (currentSectionBody === null) continue;
-              const summary = tryForecastDeletions(
-                currentSectionBody,
-                s.body,
-                cfg.url
-              );
-              if (summary !== null) {
-                summed.tocs += summary.tocs;
-                summed.links += summary.links;
-                summed.structuredMacros += summary.structuredMacros;
-                summed.codeMacros += summary.codeMacros;
-                summed.plainElements += summary.plainElements;
-                summed.other += summary.other;
-                any = true;
+            if (confirm_deletions) {
+              for (const s of sections) {
+                let currentSectionBody = null;
+                try {
+                  currentSectionBody = extractSectionBody(fullBody, s.section);
+                } catch {
+                  currentSectionBody = null;
+                }
+                if (currentSectionBody === null) continue;
+                const summary = tryForecastDeletions(
+                  currentSectionBody,
+                  s.body,
+                  cfg.url
+                );
+                if (summary !== null) {
+                  summed.tocs += summary.tocs;
+                  summed.links += summary.links;
+                  summed.structuredMacros += summary.structuredMacros;
+                  summed.codeMacros += summary.codeMacros;
+                  summed.plainElements += summary.plainElements;
+                  summed.other += summary.other;
+                  any = true;
+                }
               }
             }
             const aggregateBody = sections.map((s) => s.body).join("\n");
@@ -63078,11 +63116,11 @@ batch_token: ${batch.token}` + echo;
             } else if (tokenResult === "no_token") {
               await gateOperation(server, {
                 tool: "update_page_sections",
-                summary: `Update ${sections.length} section${sections.length === 1 ? "" : "s"} in page ${page_id} with confirm_deletions?`,
+                summary: `Update ${sections.length} section${sections.length === 1 ? "" : "s"} in page ${page_id} with ${sectionsFlagsSet.join(", ")}?`,
                 details: {
                   page_id,
                   section_count: sections.length,
-                  source: "confirm_deletions",
+                  flags: sectionsFlagsSet.join(","),
                   ...any ? { deletionSummary: summed } : {}
                 },
                 cloudId,
@@ -63097,6 +63135,8 @@ batch_token: ${batch.token}` + echo;
           currentStorage: fullBody,
           sections,
           confirmDeletions: confirm_deletions,
+          confirmShrinkage: confirm_shrinkage,
+          confirmStructureLoss: confirm_structure_loss,
           confluenceBaseUrl: cfg.url
         });
         const mergedVersionMessage = prepared.versionMessage && version_message ? `${version_message}; ${prepared.versionMessage}` : prepared.versionMessage || version_message || "";
@@ -63113,6 +63153,8 @@ batch_token: ${batch.token}` + echo;
           operation: "update_page_section",
           clientLabel: getClientLabel(server),
           confirmDeletions: confirm_deletions,
+          confirmShrinkage: confirm_shrinkage,
+          confirmStructureLoss: confirm_structure_loss,
           cloudId
         });
         const warnings = [];
@@ -63569,12 +63611,18 @@ ${truncated}`);
           "Name for the diagram file (e.g., 'architecture.drawio'). Will have .drawio appended if not present."
         ),
         append: external_exports.boolean().default(true).describe(
-          "If true, appends the diagram to existing page content. If false, replaces the page body."
+          "If true, appends the diagram to the end of the page. If false, replaces the page body. Ignored when after_section or return_macro_only is set."
+        ),
+        after_section: external_exports.string().optional().describe(
+          "Heading text of a section to place the diagram in. The diagram is inserted at the END of that section's content (before the next heading) instead of at the end of the page. Use headings_only / get_page to find section names. Takes precedence over `append`."
+        ),
+        return_macro_only: external_exports.boolean().default(false).describe(
+          "If true, upload the diagram as an attachment but DO NOT modify the page body; instead return the draw.io macro storage markup so you can place it yourself with update_page / update_page_section. Use this when you need precise positioning the other options can't express. Takes precedence over `after_section` and `append`. (The attachment is created either way; if you never embed the returned macro it is left orphaned.)"
         )
       },
       annotations: { destructiveHint: false, idempotentHint: false }
     },
-    async ({ page_id, diagram_xml, diagram_name, append }) => {
+    async ({ page_id, diagram_xml, diagram_name, append, after_section, return_macro_only }) => {
       const blocked = writeGuard("add_drawio_diagram", config3);
       if (blocked) return blocked;
       try {
@@ -63609,15 +63657,47 @@ ${truncated}`);
         ].join("\n");
         const current = await getPage(page_id, true);
         const existingBody = current.body?.storage?.value ?? current.body?.value ?? "";
-        const newBody = append ? `${existingBody}
+        if (return_macro_only) {
+          return toolResult(
+            `Diagram "${filename}" uploaded to page ${current.title} (ID: ${page_id}, attachment ID: ${attachmentId}, macro ID: ${macroId}). The page body was NOT modified. Embed the diagram by inserting this macro where you want it (its baseUrl/pageId/diagramName are bound to this page):
+
+${macro}${echo}`
+          );
+        }
+        let newBody;
+        let placementNote = "";
+        if (after_section !== void 0) {
+          const sectionBody = extractSectionBody(existingBody, after_section);
+          if (sectionBody === null) {
+            return toolError(
+              new Error(
+                `Section "${after_section}" not found. Use headings_only to see available sections.`
+              )
+            );
+          }
+          const spliced = replaceSection(
+            existingBody,
+            after_section,
+            `${sectionBody}
+${macro}`
+          );
+          if (spliced === null) {
+            return toolError(
+              new Error(
+                `Section "${after_section}" not found. Use headings_only to see available sections.`
+              )
+            );
+          }
+          newBody = spliced;
+          placementNote = ` in section "${after_section}"`;
+        } else {
+          newBody = append ? `${existingBody}
 ${macro}` : macro;
+        }
         const prepared = await safePrepareBody({
           body: newBody,
           currentBody: existingBody,
           scope: "full"
-          // append=true is additive but newBody already contains the concat,
-          // so "full" is correct: guards compare existingBody vs the complete
-          // new body, which is what we want for both branches.
         });
         const submitted = await safeSubmitPage({
           pageId: page_id,
@@ -63636,7 +63716,7 @@ ${macro}` : macro;
         const badgeResult = await markPageUnverified(submitted.page.id, config3);
         if (badgeResult.warning) warnings.push(badgeResult.warning);
         return toolResult(
-          appendWarnings(`Diagram "${filename}" added to page ${submitted.page.title} (ID: ${submitted.page.id}, version: ${submitted.newVersion}, attachment ID: ${attachmentId}, macro ID: ${macroId})`, warnings) + echo
+          appendWarnings(`Diagram "${filename}" added to page ${submitted.page.title}${placementNote} (ID: ${submitted.page.id}, version: ${submitted.newVersion}, attachment ID: ${attachmentId}, macro ID: ${macroId})`, warnings) + echo
         );
       } catch (err) {
         return toolErrorWithContext(err, { operation: "add_drawio_diagram", resource: `page ${page_id}`, profile: config3.profile });
@@ -64423,7 +64503,7 @@ ${titleFenced}${echo2}`
       inputSchema: {}
     },
     async () => {
-      let text2 = `epimethian-mcp v${"6.8.0"}`;
+      let text2 = `epimethian-mcp v${"6.9.0"}`;
       try {
         const pending = await getPendingUpdate();
         if (pending) {
@@ -64454,7 +64534,7 @@ ${label} update available: v${pending.current} \u2192 v${pending.latest}. Run \`
         const pending = await getPendingUpdate();
         if (!pending) {
           return toolResult(
-            `epimethian-mcp v${"6.8.0"} is already up to date.`
+            `epimethian-mcp v${"6.9.0"} is already up to date.`
           );
         }
         const output = await performUpgrade(pending.latest);
@@ -64476,7 +64556,7 @@ async function startRecoveryServer(profile) {
   const server = new McpServer(
     {
       name: `confluence-${profile}-setup-needed`,
-      version: "6.8.0"
+      version: "6.9.0"
     },
     {
       instructions: `The Confluence profile "${profile}" referenced by CONFLUENCE_PROFILE has no keychain entry, so no Confluence tools are available. Call the setup_profile tool for instructions to create it.`
@@ -64527,21 +64607,21 @@ async function main() {
   const serverName = config3.profile ? `confluence-${config3.profile}` : "confluence";
   const server = new McpServer({
     name: serverName,
-    version: "6.8.0"
+    version: "6.9.0"
   });
   await registerTools(server, config3);
   const transport = new StdioServerTransport();
   await server.connect(transport);
   try {
     const pending = await getPendingUpdate();
-    if (pending && pending.current === "6.8.0") {
+    if (pending && pending.current === "6.9.0") {
       console.error(
         `epimethian-mcp: update available: v${pending.current} \u2192 v${pending.latest} (${pending.type}). Run \`epimethian-mcp upgrade\` to install.`
       );
     }
   } catch {
   }
-  checkForUpdates("6.8.0").catch(() => {
+  checkForUpdates("6.9.0").catch(() => {
   });
 }