@superdoc/mcp 1.3.0-next.12 → 1.3.0-next.13

package/dist/index.js

@@ -31318,7 +31318,7 @@ var init_host = __esm(() => {
 });
 
 // ../../packages/sdk/langs/node/src/runtime/sdk-version.generated.ts
-var SDK_VERSION = "2.16.0-next.12";
+var SDK_VERSION = "2.16.0-next.13";
 
 // ../../packages/sdk/langs/node/src/runtime/embedded-platform.ts
 import { chmodSync, existsSync } from "node:fs";
@@ -134922,6 +134922,58 @@ function parseDirectRunSequence(xml, allowRevisions) {
     return null;
   return { currentText, originalText, revisions };
 }
+function splitLeadingNoteMarkerRun(xml, family) {
+  const firstRun = /^\s*<((?:[A-Za-z_][\w.-]*:)?r)\b(?:"[^"]*"|'[^']*'|[^>"'])*>[\s\S]*?<\/\1>/.exec(xml);
+  if (!firstRun)
+    return null;
+  const markerRunXml = firstRun[0];
+  const localName2 = family === "footnotes" ? "footnoteRef" : "endnoteRef";
+  const markerTag = new RegExp(`<((?:[A-Za-z_][\\w.-]*:)?)${localName2}\\s*\\/>`, "g");
+  const markers = [...markerRunXml.matchAll(markerTag)];
+  if (markers.length !== 1)
+    return null;
+  let valid = true;
+  let depth = 0;
+  let markerCount = 0;
+  const parser = new import_saxes3.SaxesParser({
+    xmlns: true,
+    additionalNamespaces: replayAdditionalNamespaces(markerRunXml)
+  });
+  parser.on("error", () => {
+    valid = false;
+  });
+  parser.on("opentag", (tag) => {
+    depth += 1;
+    if (depth === 1 && tag.local === "replay")
+      return;
+    if (depth === 2 && tag.uri === W_NS && tag.local === "r")
+      return;
+    if (depth === 3 && tag.uri === W_NS && tag.local === "rPr")
+      return;
+    if (depth === 3 && tag.uri === W_NS && tag.local === localName2 && tag.isSelfClosing && Object.keys(tag.attributes).length === 0) {
+      markerCount += 1;
+      return;
+    }
+    if (depth === 3 || (tag.local === "footnoteRef" || tag.local === "endnoteRef"))
+      valid = false;
+  });
+  parser.on("closetag", () => {
+    depth -= 1;
+  });
+  try {
+    parser.write(`<replay>${markerRunXml}</replay>`).close();
+  } catch {
+    valid = false;
+  }
+  const withoutMarker = markerRunXml.replace(markerTag, "<w:t/>");
+  if (!valid || depth !== 0 || markerCount !== 1 || parseDirectRunSequence(withoutMarker, false)?.currentText !== "")
+    return null;
+  return { markerRunXml, remainingRunXml: xml.slice(markerRunXml.length) };
+}
+function sameNoteMarkerRunXml(base2, target) {
+  const withoutRedundantWordNamespace = (xml) => xml.split(` xmlns:w="${W_NS}"`).join("").split(` xmlns:w='${W_NS}'`).join("");
+  return withoutRedundantWordNamespace(base2) === withoutRedundantWordNamespace(target);
+}
 function inspectDirectParagraphRevisionRuns(xml) {
   return parseDirectRunSequence(xml, true);
 }
@@ -135265,9 +135317,21 @@ function parseXmlStartTag(rawTag) {
   return null;
 }
 function validateRunContents(xml, options) {
-  if (xml === "")
+  const baseHasNoteMarker = options.baseRunXml !== undefined && /<(?:[A-Za-z_][\w.-]*:)?(?:footnoteRef|endnoteRef)\b/.test(options.baseRunXml);
+  const targetHasNoteMarker = /<(?:[A-Za-z_][\w.-]*:)?(?:footnoteRef|endnoteRef)\b/.test(xml);
+  let runs = xml;
+  if (baseHasNoteMarker || targetHasNoteMarker) {
+    const family = options.noteMarkerFamily;
+    const target = family && splitLeadingNoteMarkerRun(xml, family);
+    const base2 = family && options.baseRunXml !== undefined ? splitLeadingNoteMarkerRun(options.baseRunXml, family) : undefined;
+    if (!target || options.baseRunXml !== undefined && (!base2 || !sameNoteMarkerRunXml(base2.markerRunXml, target.markerRunXml))) {
+      return { ok: false, reason: "target runs change or misplace the note marker" };
+    }
+    runs = target.remainingRunXml;
+  }
+  if (runs === "")
     return { ok: true };
-  const replayXml = stripAllowedNoteReferences(xml, options);
+  const replayXml = stripAllowedNoteReferences(runs, options);
   const withoutCarriers = replayXml !== null && options.baseRunXml ? stripRetainedCarrier(replayXml, options.baseRunXml, options.allowNamespaceDeclarationDifference === true) : replayXml;
   const withoutBookmarks = withoutCarriers !== null && /<(?:[\w.-]+:)?bookmark(?:Start|End)\b/.test(withoutCarriers) ? preservedBookmarkRunTokens(withoutCarriers)?.strippedXml ?? null : withoutCarriers;
   if (withoutBookmarks === null || UNSUPPORTED_XML.test(withoutBookmarks) || RELATIONSHIP_REFERENCE.test(withoutBookmarks)) {
@@ -136990,7 +137054,8 @@ function validateCompareApplyPlan(value, baseBody = []) {
       if (!isRecord9(group) || !Array.isArray(group.operations))
         return;
       group.operations.forEach((operation, operationIndex) => {
-        validateBodyOperation(operation, `storyOperations[${index}].operations[${operationIndex}]`, problems);
+        const noteMarkerFamily = (group.family === "footnotes" || group.family === "endnotes") && isRecord9(operation) && (operation.kind === "edit" || operation.kind === "formatEdit") ? group.family : undefined;
+        validateBodyOperation(operation, `storyOperations[${index}].operations[${operationIndex}]`, problems, { noteMarkerFamily });
       });
     });
   }
@@ -139106,7 +139171,7 @@ function attachExactTargetRevisionReplayToStories(groups, base2, target, matchRe
   });
   return { groups: replayGroups, coveredBaseAnnotations, coveredTargetAnnotations, changedTrackedXmlReplayed };
 }
-function firstUnsafeReplayReason(operations, noteLifecycle = [], targetStories = [], baseBody = []) {
+function firstUnsafeReplayReason(operations, noteLifecycle = [], targetStories = [], baseBody = [], noteMarkerFamily) {
   const createdNoteReferences = noteLifecycle.filter((operation) => operation.kind === "create-note-definition" || operation.kind === "create-note-story").map((operation) => ({ family: operation.family, noteId: operation.noteId }));
   const retainedNoteReferences = targetStories.flatMap((story) => (story.family === "footnotes" || story.family === "endnotes") && story.noteId ? [{ family: story.family, noteId: story.noteId }] : []);
   const allowedNoteReferences = [...createdNoteReferences, ...retainedNoteReferences];
@@ -139116,7 +139181,7 @@ function firstUnsafeReplayReason(operations, noteLifecycle = [], targetStories =
       continue;
     const result = validateCompareReplayPayload(operation, {
       allowedNoteReferences,
-      ...operation.kind === "edit" || operation.kind === "formatEdit" ? { baseRunXml: baseRunByBlockId.get(operation.blockId) } : {}
+      ...operation.kind === "edit" || operation.kind === "formatEdit" ? { baseRunXml: baseRunByBlockId.get(operation.blockId), noteMarkerFamily } : {}
     });
     if (!result.ok)
       return result.reason;
@@ -139310,7 +139375,9 @@ function planCompare(base2, target) {
   for (const group of storyOperations) {
     if (!replayableStoryFamilies.has(group.family))
       continue;
-    const unsafeStoryReason = firstUnsafeReplayReason(group.operations);
+    const noteMarkerFamily = group.family === "footnotes" || group.family === "endnotes" ? group.family : undefined;
+    const baseStory = noteMarkerFamily ? base2.stories?.find((story) => story.storyId === group.storyId && story.family === group.family && story.noteId === group.noteId) : undefined;
+    const unsafeStoryReason = firstUnsafeReplayReason(group.operations, [], [], baseStory?.entries ?? [], noteMarkerFamily);
     if (!unsafeStoryReason || unsafeStoryFamilies.has(group.family))
       continue;
     unsafeStoryFamilies.add(group.family);
@@ -222582,7 +222649,10 @@ function normalizeCompareBodyStep(step2, sectionSteps, referenceSteps, allowedNo
     return step2.targetRevisionReplay === undefined || step2.targetRevisionReplay.structuralAction === "delete" ? step2 : null;
   }
   const baseRunXml = step2.kind === "edit" || step2.kind === "formatEdit" ? liveCompareBodyRunXml(state, storyId, step2.blockId) : undefined;
-  if (!validateCompareBodyReplayPayload(step2, sectionSteps, referenceSteps, allowedNoteReferences, step2.text, baseRunXml))
+  const noteMarkerFamily = step2.kind === "edit" || step2.kind === "formatEdit" ? storyId.startsWith("footnotes:") ? "footnotes" : storyId.startsWith("endnotes:") ? "endnotes" : undefined : undefined;
+  if (noteMarkerFamily && baseRunXml && /<(?:[A-Za-z_][\w.-]*:)?(?:footnoteRef|endnoteRef)\b/.test(baseRunXml) && step2.targetRunXml === undefined)
+    return null;
+  if (!validateCompareBodyReplayPayload(step2, sectionSteps, referenceSteps, allowedNoteReferences, step2.text, baseRunXml, noteMarkerFamily))
     return null;
   const targetParagraphPropertiesXml = step2.targetParagraphPropertiesXml === undefined ? undefined : canonicalizeCompareBodyParagraphPropertiesXml(step2.targetParagraphPropertiesXml, sectionSteps);
   const targetRunXml = step2.targetRunXml === undefined ? undefined : (step2.targetRunXml.includes("<w:drawing") || step2.targetRunXml.includes("<w:fldSimple")) && baseRunXml && referenceSteps.length === 0 ? step2.targetRunXml : canonicalizeCompareBodyRunXml(step2.targetRunXml, referenceSteps);
@@ -222598,7 +222668,7 @@ function normalizeCompareBodyStep(step2, sectionSteps, referenceSteps, allowedNo
     targetRunXml,
     replayDependencies: "replayDependencies" in step2 ? step2.replayDependencies : undefined,
     targetRevisionReplay: "targetRevisionReplay" in step2 ? step2.targetRevisionReplay : undefined
-  }, sectionSteps, referenceSteps, allowedNoteReferences, step2.text, baseRunXml) ? normalized : null;
+  }, sectionSteps, referenceSteps, allowedNoteReferences, step2.text, baseRunXml, noteMarkerFamily) ? normalized : null;
 }
 function liveCompareBodyRunXml(state, storyId, blockId) {
   const entry = getStoryParagraphIndexFromState(state, storyId)?.byParaId(blockId);
@@ -222731,7 +222801,7 @@ function sourceProofBindsReference(proof, family) {
   const childXml = wrappedSource.slice(child.start, child.end);
   return isValidNoteReferenceReplayRunXml(childXml, family, proof.noteId, child.namespaceBindings) && replayCarrierXmlEquals(childXml, proof.referenceRunXml);
 }
-function validateCompareBodyReplayPayload(payload, sectionSteps, referenceSteps, allowedNoteReferences, expectedCurrentText, baseRunXml) {
+function validateCompareBodyReplayPayload(payload, sectionSteps, referenceSteps, allowedNoteReferences, expectedCurrentText, baseRunXml, noteMarkerFamily) {
   if (payload.targetRunXml !== undefined && expectedCurrentText !== undefined && projectCompareReplayCurrentText(payload.targetRunXml) !== expectedCurrentText.replace(/\uFFFC/g, "")) {
     return false;
   }
@@ -222739,7 +222809,12 @@ function validateCompareBodyReplayPayload(payload, sectionSteps, referenceSteps,
   if (targetParagraphPropertiesXml === null)
     return false;
   const targetRunXml = payload.targetRunXml === undefined ? undefined : stripProtectedReferenceTokens(payload.targetRunXml, referenceSteps);
-  return targetRunXml !== null && validateCompareReplayPayload({ ...payload, targetParagraphPropertiesXml, targetRunXml }, { allowedNoteReferences, baseRunXml, allowNamespaceDeclarationDifference: baseRunXml !== undefined }).ok;
+  return targetRunXml !== null && validateCompareReplayPayload({ ...payload, targetParagraphPropertiesXml, targetRunXml }, {
+    allowedNoteReferences,
+    baseRunXml,
+    noteMarkerFamily,
+    allowNamespaceDeclarationDifference: baseRunXml !== undefined
+  }).ok;
 }
 function stripProtectedSectionTokens(xml, sectionSteps) {
   const tokens = collectProtectedSectionTokens(xml, sectionSteps);
@@ -223717,6 +223792,24 @@ function unchangedBookmarkReferenceSteps(oldRuns, targetRuns) {
     afterNamespaceBindings: bookmarkBindings
   }];
 }
+function retainedNoteMarkerRuns(oldRuns, targetRuns, storyId) {
+  const markerPattern = /<(?:[A-Za-z_][\w.-]*:)?(?:footnoteRef|endnoteRef)\b/;
+  if (!markerPattern.test(oldRuns) && !markerPattern.test(targetRuns)) {
+    return { markerRunXml: "", oldRuns, targetRuns };
+  }
+  const family = storyId.startsWith("footnotes:") ? "footnotes" : storyId.startsWith("endnotes:") ? "endnotes" : null;
+  if (!family)
+    return null;
+  const oldMarker = splitLeadingNoteMarkerRun(oldRuns, family);
+  const targetMarker = splitLeadingNoteMarkerRun(targetRuns, family);
+  if (!oldMarker || !targetMarker || !sameNoteMarkerRunXml(oldMarker.markerRunXml, targetMarker.markerRunXml))
+    return null;
+  return {
+    markerRunXml: oldMarker.markerRunXml,
+    oldRuns: oldMarker.remainingRunXml,
+    targetRuns: targetMarker.remainingRunXml
+  };
+}
 function runCompareBodyEditCommit(input, storyId, step2, changeMode, options, pushHistory, referenceSteps) {
   const { state, txId } = input;
   const partUri = storyPartUriFromStoryId2(storyId);
@@ -223738,6 +223831,9 @@ function runCompareBodyEditCommit(input, storyId, step2, changeMode, options, pu
   const closeStart = paraXml.lastIndexOf("</");
   const innerXml = closeStart > openEnd ? paraXml.slice(openEnd, closeStart) : "";
   const oldRunsRaw = stripElements(innerXml, "pPr");
+  const retainedMarker = retainedNoteMarkerRuns(oldRunsRaw, newRuns, storyId);
+  if (!retainedMarker)
+    return rejected14(txId, "unsupported-context");
   const stableBookmarkSteps = unchangedBookmarkReferenceSteps(oldRunsRaw, newRuns);
   if (stableBookmarkSteps === null && referenceSteps.length === 0)
     return rejected14(txId, "unsupported-context");
@@ -223756,10 +223852,10 @@ function runCompareBodyEditCommit(input, storyId, step2, changeMode, options, pu
         storyId
       });
     }
-    const oldRunsDel = oldRunsRaw.replace(/<((?:[\w.-]+:)?)t(\b[^>]*)>/g, "<$1delText$2>").replace(/<\/((?:[\w.-]+:)?)t>/g, "</$1delText>");
+    const oldRunsDel = retainedMarker.oldRuns.replace(/<((?:[\w.-]+:)?)t(\b[^>]*)>/g, "<$1delText$2>").replace(/<\/((?:[\w.-]+:)?)t>/g, "</$1delText>");
     const hunkStamps = makeCompareHunkStampSource(stamps, input);
-    const retainedCarrier = newRuns.includes("<w:drawing") || newRuns.includes("<w:fldSimple") && protectedReferenceSteps.length === 0;
-    const protectedRuns = retainedCarrier ? protectedReferenceSteps.length === 0 ? renderTrackedRunsWithRetainedCarrier(oldRunsRaw, newRuns, hunkStamps.next, paragraphWrapper.wordprocessingPrefix, bytes, entry.byteStart, entry.byteEnd) : null : renderTrackedRunsWithProtectedReferences(oldRunsRaw, newRuns, protectedReferenceSteps, hunkStamps.next, paragraphWrapper.wordprocessingPrefix);
+    const retainedCarrier = retainedMarker.targetRuns.includes("<w:drawing") || retainedMarker.targetRuns.includes("<w:fldSimple") && protectedReferenceSteps.length === 0;
+    const protectedRuns = retainedCarrier ? protectedReferenceSteps.length === 0 ? renderTrackedRunsWithRetainedCarrier(retainedMarker.oldRuns, retainedMarker.targetRuns, hunkStamps.next, paragraphWrapper.wordprocessingPrefix, bytes, entry.byteStart, entry.byteEnd) : null : renderTrackedRunsWithProtectedReferences(retainedMarker.oldRuns, retainedMarker.targetRuns, protectedReferenceSteps, hunkStamps.next, paragraphWrapper.wordprocessingPrefix);
     if (retainedCarrier && !protectedRuns)
       return rejected14(txId, "unsupported-context");
     if (!protectedRuns && stableBookmarkSteps?.length)
@@ -223772,10 +223868,10 @@ function runCompareBodyEditCommit(input, storyId, step2, changeMode, options, pu
     } else {
       const fallbackPair = hunkStamps.next();
       delXml = oldRunsDel ? wrapTracked("del", oldRunsDel, fallbackPair.del, "rsidDel", paragraphWrapper.wordprocessingPrefix) : "";
-      insXml = newRuns ? wrapTracked("ins", newRuns, fallbackPair.ins, "rsidR", paragraphWrapper.wordprocessingPrefix) : "";
+      insXml = retainedMarker.targetRuns ? wrapTracked("ins", retainedMarker.targetRuns, fallbackPair.ins, "rsidR", paragraphWrapper.wordprocessingPrefix) : "";
     }
     const trackedPPrXml = buildTrackedParagraphProperties(targetParagraphPropertiesXml, pPrXml, stamps.paragraphProperties ?? stamps.ins, paragraphWrapper.wordprocessingPrefix);
-    const assembledParaXml = `${paragraphWrapper.openTag}${trackedPPrXml}${delXml}${insXml}${paragraphWrapper.closeTag}`;
+    const assembledParaXml = `${paragraphWrapper.openTag}${trackedPPrXml}` + `${retainedMarker.markerRunXml}${delXml}${insXml}${paragraphWrapper.closeTag}`;
     if (hunkStamps.usedPairs.length === 0) {
       newParaXml = assembledParaXml;
     } else {
@@ -224068,6 +224164,9 @@ function runCompareBodyFormatEditCommit(input, storyId, step2, changeMode, optio
   const closeStart = paraXml.lastIndexOf("</");
   const innerXml = closeStart > openEnd ? paraXml.slice(openEnd, closeStart) : "";
   const oldRunsRaw = stripElements(innerXml, "pPr");
+  const retainedMarker = retainedNoteMarkerRuns(oldRunsRaw, targetRunXml, storyId);
+  if (!retainedMarker)
+    return rejected14(txId, "unsupported-context");
   const paragraphPropertiesChanged = !equivalentParagraphProperties(targetPPrXml, pPrXml);
   const stableBookmarkSteps = unchangedBookmarkReferenceSteps(oldRunsRaw, targetRunXml);
   if (stableBookmarkSteps === null && referenceSteps.length === 0)
@@ -224135,12 +224234,12 @@ function runCompareBodyFormatEditCommit(input, storyId, step2, changeMode, optio
       const stamps = compareTrackedStampPair(input, paragraphPropertiesChanged);
       if (!stamps)
         return rejected14(txId, "no-author-configured");
-      const oldRunsDel = oldRunsRaw.replace(/<((?:[\w.-]+:)?)t(\b[^>]*)>/g, "<$1delText$2>").replace(/<\/((?:[\w.-]+:)?)t>/g, "</$1delText>");
-      const protectedRuns = renderTrackedRunsWithProtectedReferences(oldRunsRaw, targetRunXml, protectedReferenceSteps, () => stamps, paragraphWrapper.wordprocessingPrefix);
+      const oldRunsDel = retainedMarker.oldRuns.replace(/<((?:[\w.-]+:)?)t(\b[^>]*)>/g, "<$1delText$2>").replace(/<\/((?:[\w.-]+:)?)t>/g, "</$1delText>");
+      const protectedRuns = renderTrackedRunsWithProtectedReferences(retainedMarker.oldRuns, retainedMarker.targetRuns, protectedReferenceSteps, () => stamps, paragraphWrapper.wordprocessingPrefix);
       if (!protectedRuns && stableBookmarkSteps?.length)
         return rejected14(txId, "unsupported-context");
       const delXml = protectedRuns?.xml ?? (oldRunsDel ? wrapTracked("del", oldRunsDel, stamps.del, "rsidDel", paragraphWrapper.wordprocessingPrefix) : "");
-      const insXml = protectedRuns ? "" : targetRunXml ? wrapTracked("ins", targetRunXml, stamps.ins, "rsidR", paragraphWrapper.wordprocessingPrefix) : "";
+      const insXml = protectedRuns ? "" : retainedMarker.targetRuns ? wrapTracked("ins", retainedMarker.targetRuns, stamps.ins, "rsidR", paragraphWrapper.wordprocessingPrefix) : "";
       if (delXml || insXml) {
         createdRefs.push({ kind: "trackedChange", entityId: stamps.ins.rsid, storyId });
       }
@@ -224152,7 +224251,7 @@ function runCompareBodyFormatEditCommit(input, storyId, step2, changeMode, optio
         });
       }
       const trackedPPrXml = buildTrackedParagraphProperties(targetParagraphPropertiesXml, pPrXml, stamps.paragraphProperties ?? stamps.ins, paragraphWrapper.wordprocessingPrefix);
-      newParaXml = `${paragraphWrapper.openTag}${trackedPPrXml}${delXml}${insXml}${paragraphWrapper.closeTag}`;
+      newParaXml = `${paragraphWrapper.openTag}${trackedPPrXml}` + `${retainedMarker.markerRunXml}${delXml}${insXml}${paragraphWrapper.closeTag}`;
     }
   } else {
     newParaXml = `${paragraphWrapper.openTag}${targetPPrXml}${targetRunXml}${paragraphWrapper.closeTag}`;
@@ -363370,7 +363469,8 @@ function buildHeaderFooterLifecyclePlan(base3, target) {
     const after = targetParts.get(partUri);
     const kind = after?.kind ?? before.kind;
     const relationshipsChanged = !headerFooterPartRelationshipsEqual(before?.relationshipsBytes ?? null, after?.relationshipsBytes ?? null);
-    const changed = !before || !after || !numbersEqual(before.bytes, after.bytes) || relationshipsChanged;
+    const contentChanged = Boolean(before && after && (before.bytes.length !== after.bytes.length || before.bytes.some((value2, index2) => value2 !== after.bytes[index2])));
+    const changed = !before || !after || contentChanged || relationshipsChanged;
     if (!changed)
       continue;
     if (hasUnsafeRelationshipDependencyChange(before, after, relationshipsChanged)) {
@@ -363387,7 +363487,7 @@ function buildHeaderFooterLifecyclePlan(base3, target) {
       });
     } else if (before && !after) {
       rewrites.push({ family: "header-footer-parts", partUri, kind: "remove" });
-    } else if (before && after && !numbersEqual(before.bytes, after.bytes)) {
+    } else if (before && after && contentChanged) {
       contentRewrites.push({
         family: "header-footer-parts",
         partUri,
@@ -365053,6 +365153,17 @@ function isCommentRelationshipSemanticKey(semanticKey) {
   const relType = semanticKey.slice(sep + 1);
   return /\/relationships\/(?:comments|commentsExtended|commentsIds|commentsExtensible|threadedComments|people)$/i.test(relType);
 }
+function isResolutionSidecarAddition(key2, targetEntry) {
+  if (!targetEntry)
+    return false;
+  if (key2 === "ct:override:/word/commentsExtended.xml") {
+    return targetEntry.semanticKey === key2 && targetEntry.contentSignature === sha256HexSync(TE62.encode("override:/word/commentsExtended.xml=" + "application/vnd.openxmlformats-officedocument.wordprocessingml.commentsExtended+xml"));
+  }
+  if (!key2.startsWith("rel:/word/document.xml|"))
+    return false;
+  const type = "http://schemas.microsoft.com/office/2011/relationships/commentsExtended";
+  return targetEntry.semanticKey === `/word/document.xml|${type}` && targetEntry.contentSignature === sha256HexSync(TE62.encode(`type:${type}#mode:Internal#target:/word/commentsExtended.xml`));
+}
 function isCommentScopedPackageKey(context, key2, presentInBase, hasCommentCreate, targetEntry) {
   if (key2.startsWith("ct:")) {
     const uri = key2.slice(key2.indexOf(":", 3) + 1);
@@ -365088,10 +365199,15 @@ function packageGraphKeysNotCoveredByComments(context, base3, target, steps) {
       changedKeys.add(key2);
   const hasCommentCreate = steps.some((s) => s.kind === "create");
   const hasCommentDelete = steps.some((s) => s.kind === "delete");
+  const hasRootResolution = steps.some((s) => s.kind === "set-resolved" && s.resolved && !s.targetIsReply && s.targetParentParaId === null);
+  const addedResolutionSidecarKeys = [...changedKeys].filter((key2) => !baseSigs.has(key2) && targetSigs.has(key2) && isResolutionSidecarAddition(key2, targetEntries.get(key2)));
+  const coversResolutionSidecar = hasRootResolution && addedResolutionSidecarKeys.length === 2 && addedResolutionSidecarKeys.includes("ct:override:/word/commentsExtended.xml");
   const notCovered = [];
   for (const key2 of changedKeys) {
     const presentInBase = baseSigs.has(key2);
     const presentInTarget = targetSigs.has(key2);
+    if (coversResolutionSidecar && addedResolutionSidecarKeys.includes(key2))
+      continue;
     let lifecycleCoversEntry = false;
     if (presentInBase !== presentInTarget) {
       lifecycleCoversEntry = presentInBase ? hasCommentDelete : hasCommentCreate;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/mcp",
-  "version": "1.3.0-next.12",
+  "version": "1.3.0-next.13",
   "description": "Model Context Protocol server for SuperDoc, giving an AI agent tools to read and edit .docx files.",
   "type": "module",
   "license": "AGPL-3.0",
@@ -24,13 +24,13 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
-    "@superdoc/sdk": "2.16.0-next.12",
+    "@superdoc/sdk": "2.16.0-next.13",
     "debug": "^4.4.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "superdoc": "2.19.0-next.11",
-    "@superdoc/docx-engine": "0.18.0-next.11",
+    "superdoc": "2.19.0-next.12",
+    "@superdoc/docx-engine": "0.18.0-next.12",
     "@superdoc/document-api": "0.1.0-alpha.0",
     "@types/bun": "^1.3.8",
     "@types/node": "22.19.2",