docrev 0.9.11 → 0.9.14

package/dist/lib/commands/utilities.js

@@ -229,179 +229,179 @@ export function register(program, pkg) {
 }
 // Helper functions for help text
 function showFullHelp(pkg) {
-    console.log(`
-${chalk.bold.cyan('rev')} ${chalk.dim(`v${pkg?.version || 'unknown'}`)} - Revision workflow for Word ↔ Markdown round-trips
-
-${chalk.bold('DESCRIPTION')}
-  Handle reviewer feedback when collaborating on academic papers.
-  Import changes from Word, review them interactively, and preserve
-  comments for discussion with Claude.
-
-${chalk.bold('GLOBAL OPTIONS')}
-
-  ${chalk.bold('--no-color')}               Disable colored output
-  ${chalk.bold('-q, --quiet')}              Suppress non-essential output
-  ${chalk.bold('--json')}                   Output in JSON format (for scripting)
-
-${chalk.bold('TYPICAL WORKFLOW')}
-
-  ${chalk.dim('1.')} Build and send: ${chalk.green('rev build docx')} ${chalk.dim('(or rev b docx)')}
-  ${chalk.dim('2.')} Reviewers return ${chalk.yellow('reviewed.docx')} with edits and comments
-  ${chalk.dim('3.')} Sync their feedback: ${chalk.green('rev sync reviewed.docx')}
-  ${chalk.dim('4.')} Work through comments: ${chalk.green('rev next')} ${chalk.dim('(n)')} / ${chalk.green('rev todo')} ${chalk.dim('(t)')}
-  ${chalk.dim('5.')} Accept/reject changes: ${chalk.green('rev accept -a')} ${chalk.dim('(a)')} or ${chalk.green('rev review')}
-  ${chalk.dim('6.')} Rebuild: ${chalk.green('rev build docx')}
-  ${chalk.dim('7.')} Archive old files: ${chalk.green('rev archive')}
-
-${chalk.bold('MORE HELP')}
-
-  rev help workflow    Detailed workflow guide
-  rev help syntax      Annotation syntax reference
-  rev help commands    All commands with options
+    console.log(`
+${chalk.bold.cyan('rev')} ${chalk.dim(`v${pkg?.version || 'unknown'}`)} - Revision workflow for Word ↔ Markdown round-trips
+
+${chalk.bold('DESCRIPTION')}
+  Handle reviewer feedback when collaborating on academic papers.
+  Import changes from Word, review them interactively, and preserve
+  comments for discussion with Claude.
+
+${chalk.bold('GLOBAL OPTIONS')}
+
+  ${chalk.bold('--no-color')}               Disable colored output
+  ${chalk.bold('-q, --quiet')}              Suppress non-essential output
+  ${chalk.bold('--json')}                   Output in JSON format (for scripting)
+
+${chalk.bold('TYPICAL WORKFLOW')}
+
+  ${chalk.dim('1.')} Build and send: ${chalk.green('rev build docx')} ${chalk.dim('(or rev b docx)')}
+  ${chalk.dim('2.')} Reviewers return ${chalk.yellow('reviewed.docx')} with edits and comments
+  ${chalk.dim('3.')} Sync their feedback: ${chalk.green('rev sync reviewed.docx')}
+  ${chalk.dim('4.')} Work through comments: ${chalk.green('rev next')} ${chalk.dim('(n)')} / ${chalk.green('rev todo')} ${chalk.dim('(t)')}
+  ${chalk.dim('5.')} Accept/reject changes: ${chalk.green('rev accept -a')} ${chalk.dim('(a)')} or ${chalk.green('rev review')}
+  ${chalk.dim('6.')} Rebuild: ${chalk.green('rev build docx')}
+  ${chalk.dim('7.')} Archive old files: ${chalk.green('rev archive')}
+
+${chalk.bold('MORE HELP')}
+
+  rev help workflow    Detailed workflow guide
+  rev help syntax      Annotation syntax reference
+  rev help commands    All commands with options
 `);
 }
 function showWorkflowHelp() {
-    console.log(`
-${chalk.bold.cyan('rev')} ${chalk.dim('- Workflow Guide')}
-
-${chalk.bold('OVERVIEW')}
-
-  The rev workflow solves a common problem: you write in Markdown,
-  but collaborators review in Word. When they return edited documents,
-  you need to merge their changes back into your source files.
-
-${chalk.bold('STEP 1: BUILD & SEND')}
-
-  ${chalk.green('rev build docx')}
-  ${chalk.dim('# Send the .docx to reviewers')}
-
-${chalk.bold('STEP 2: RECEIVE FEEDBACK')}
-
-  Reviewers edit the document, adding:
-  ${chalk.dim('•')} Track changes (insertions, deletions)
-  ${chalk.dim('•')} Comments (questions, suggestions)
-
-${chalk.bold('STEP 3: SYNC CHANGES')}
-
-  ${chalk.green('rev sync reviewed.docx')}
-  ${chalk.dim('# Or just: rev sync (auto-detects most recent .docx)')}
-
-  Your markdown files now contain their feedback as annotations.
-
-${chalk.bold('STEP 4: WORK THROUGH COMMENTS')}
-
-  ${chalk.green('rev todo')}              ${chalk.dim('# See all pending comments')}
-  ${chalk.green('rev next')}              ${chalk.dim('# Show next pending comment')}
-  ${chalk.green('rev reply file.md -n 1 -m "Done"')}
-  ${chalk.green('rev resolve file.md -n 1')}
-
-${chalk.bold('STEP 5: ACCEPT/REJECT CHANGES')}
-
-  ${chalk.green('rev accept file.md -a')} ${chalk.dim('# Accept all changes')}
-  ${chalk.green('rev reject file.md -n 2')} ${chalk.dim('# Reject specific change')}
-  ${chalk.dim('# Or use interactive mode:')}
-  ${chalk.green('rev review file.md')}
-
-${chalk.bold('STEP 6: REBUILD')}
-
-  ${chalk.green('rev build docx')}
-  ${chalk.green('rev build docx --dual')} ${chalk.dim('# Clean + comments version')}
-
-${chalk.bold('STEP 7: ARCHIVE & REPEAT')}
-
-  ${chalk.green('rev archive')}           ${chalk.dim('# Move reviewer files to archive/')}
-  ${chalk.dim('# Send new .docx, repeat cycle')}
+    console.log(`
+${chalk.bold.cyan('rev')} ${chalk.dim('- Workflow Guide')}
+
+${chalk.bold('OVERVIEW')}
+
+  The rev workflow solves a common problem: you write in Markdown,
+  but collaborators review in Word. When they return edited documents,
+  you need to merge their changes back into your source files.
+
+${chalk.bold('STEP 1: BUILD & SEND')}
+
+  ${chalk.green('rev build docx')}
+  ${chalk.dim('# Send the .docx to reviewers')}
+
+${chalk.bold('STEP 2: RECEIVE FEEDBACK')}
+
+  Reviewers edit the document, adding:
+  ${chalk.dim('•')} Track changes (insertions, deletions)
+  ${chalk.dim('•')} Comments (questions, suggestions)
+
+${chalk.bold('STEP 3: SYNC CHANGES')}
+
+  ${chalk.green('rev sync reviewed.docx')}
+  ${chalk.dim('# Or just: rev sync (auto-detects most recent .docx)')}
+
+  Your markdown files now contain their feedback as annotations.
+
+${chalk.bold('STEP 4: WORK THROUGH COMMENTS')}
+
+  ${chalk.green('rev todo')}              ${chalk.dim('# See all pending comments')}
+  ${chalk.green('rev next')}              ${chalk.dim('# Show next pending comment')}
+  ${chalk.green('rev reply file.md -n 1 -m "Done"')}
+  ${chalk.green('rev resolve file.md -n 1')}
+
+${chalk.bold('STEP 5: ACCEPT/REJECT CHANGES')}
+
+  ${chalk.green('rev accept file.md -a')} ${chalk.dim('# Accept all changes')}
+  ${chalk.green('rev reject file.md -n 2')} ${chalk.dim('# Reject specific change')}
+  ${chalk.dim('# Or use interactive mode:')}
+  ${chalk.green('rev review file.md')}
+
+${chalk.bold('STEP 6: REBUILD')}
+
+  ${chalk.green('rev build docx')}
+  ${chalk.green('rev build docx --dual')} ${chalk.dim('# Clean + comments version')}
+
+${chalk.bold('STEP 7: ARCHIVE & REPEAT')}
+
+  ${chalk.green('rev archive')}           ${chalk.dim('# Move reviewer files to archive/')}
+  ${chalk.dim('# Send new .docx, repeat cycle')}
 `);
 }
 function showSyntaxHelp() {
-    console.log(`
-${chalk.bold.cyan('rev')} ${chalk.dim('- Annotation Syntax (CriticMarkup)')}
-
-${chalk.bold('INSERTIONS')}
-
-  Syntax:  ${chalk.green('{++inserted text++}')}
-  Meaning: This text was added by the reviewer
-
-  Example:
-    We ${chalk.green('{++specifically++}')} focused on neophytes.
-    → Reviewer added the word "specifically"
-
-${chalk.bold('DELETIONS')}
-
-  Syntax:  ${chalk.red('{--deleted text--}')}
-  Meaning: This text was removed by the reviewer
-
-  Example:
-    We focused on ${chalk.red('{--recent--}')} neophytes.
-    → Reviewer removed the word "recent"
-
-${chalk.bold('SUBSTITUTIONS')}
-
-  Syntax:  ${chalk.yellow('{~~old text~>new text~~}')}
-  Meaning: Text was changed from old to new
-
-  Example:
-    The effect was ${chalk.yellow('{~~significant~>substantial~~}')}.
-    → Reviewer changed "significant" to "substantial"
-
-${chalk.bold('COMMENTS')}
-
-  Syntax:  ${chalk.blue('{>>Author: comment text<<}')}
-  Meaning: Reviewer left a comment at this location
-
-  Example:
-    The results were significant. ${chalk.blue('{>>Dr. Smith: Add p-value<<}')}
-    → Dr. Smith commented asking for a p-value
-
-  Comments are placed ${chalk.bold('after')} the text they reference.
+    console.log(`
+${chalk.bold.cyan('rev')} ${chalk.dim('- Annotation Syntax (CriticMarkup)')}
+
+${chalk.bold('INSERTIONS')}
+
+  Syntax:  ${chalk.green('{++inserted text++}')}
+  Meaning: This text was added by the reviewer
+
+  Example:
+    We ${chalk.green('{++specifically++}')} focused on neophytes.
+    → Reviewer added the word "specifically"
+
+${chalk.bold('DELETIONS')}
+
+  Syntax:  ${chalk.red('{--deleted text--}')}
+  Meaning: This text was removed by the reviewer
+
+  Example:
+    We focused on ${chalk.red('{--recent--}')} neophytes.
+    → Reviewer removed the word "recent"
+
+${chalk.bold('SUBSTITUTIONS')}
+
+  Syntax:  ${chalk.yellow('{~~old text~>new text~~}')}
+  Meaning: Text was changed from old to new
+
+  Example:
+    The effect was ${chalk.yellow('{~~significant~>substantial~~}')}.
+    → Reviewer changed "significant" to "substantial"
+
+${chalk.bold('COMMENTS')}
+
+  Syntax:  ${chalk.blue('{>>Author: comment text<<}')}
+  Meaning: Reviewer left a comment at this location
+
+  Example:
+    The results were significant. ${chalk.blue('{>>Dr. Smith: Add p-value<<}')}
+    → Dr. Smith commented asking for a p-value
+
+  Comments are placed ${chalk.bold('after')} the text they reference.
 `);
 }
 function showCommandsHelp() {
-    console.log(`
-${chalk.bold.cyan('rev')} ${chalk.dim('- Command Reference')}
-
-${chalk.bold('rev import')} <docx> <original-md>
-
-  Import changes from a Word document by comparing against your
-  original Markdown source.
-
-  ${chalk.bold('Arguments:')}
-    docx          Word document from reviewer
-    original-md   Your original Markdown file
-
-  ${chalk.bold('Options:')}
-    -o, --output <file>   Write to different file (default: overwrites original)
-    -a, --author <name>   Author name for changes (default: "Reviewer")
-    --dry-run             Preview changes without saving
-
-${chalk.bold('rev review')} <file>
-
-  Interactively review and accept/reject track changes.
-  Comments are preserved; only track changes are processed.
-
-  ${chalk.bold('Keys:')}
-    a   Accept this change
-    r   Reject this change
-    s   Skip (decide later)
-    A   Accept all remaining changes
-    L   Reject all remaining changes
-    q   Quit without saving
-
-${chalk.bold('rev strip')} <file>
-
-  Remove annotations, outputting clean Markdown.
-  Track changes are applied (insertions kept, deletions removed).
-
-  ${chalk.bold('Options:')}
-    -o, --output <file>   Write to file (default: stdout)
-    -c, --keep-comments   Keep comment annotations
-
-${chalk.bold('rev help')} [topic]
-
-  Show help. Optional topics:
-    workflow    Step-by-step workflow guide
-    syntax      Annotation syntax reference
-    commands    This command reference
+    console.log(`
+${chalk.bold.cyan('rev')} ${chalk.dim('- Command Reference')}
+
+${chalk.bold('rev import')} <docx> <original-md>
+
+  Import changes from a Word document by comparing against your
+  original Markdown source.
+
+  ${chalk.bold('Arguments:')}
+    docx          Word document from reviewer
+    original-md   Your original Markdown file
+
+  ${chalk.bold('Options:')}
+    -o, --output <file>   Write to different file (default: overwrites original)
+    -a, --author <name>   Author name for changes (default: "Reviewer")
+    --dry-run             Preview changes without saving
+
+${chalk.bold('rev review')} <file>
+
+  Interactively review and accept/reject track changes.
+  Comments are preserved; only track changes are processed.
+
+  ${chalk.bold('Keys:')}
+    a   Accept this change
+    r   Reject this change
+    s   Skip (decide later)
+    A   Accept all remaining changes
+    L   Reject all remaining changes
+    q   Quit without saving
+
+${chalk.bold('rev strip')} <file>
+
+  Remove annotations, outputting clean Markdown.
+  Track changes are applied (insertions kept, deletions removed).
+
+  ${chalk.bold('Options:')}
+    -o, --output <file>   Write to file (default: stdout)
+    -c, --keep-comments   Keep comment annotations
+
+${chalk.bold('rev help')} [topic]
+
+  Show help. Optional topics:
+    workflow    Step-by-step workflow guide
+    syntax      Annotation syntax reference
+    commands    This command reference
 `);
 }
 //# sourceMappingURL=utilities.js.map

package/dist/lib/commands/word-tools.js

@@ -50,16 +50,16 @@ export function register(program) {
             }
         }
         else {
-            commentsXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<w:comments xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
+            commentsXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<w:comments xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
 </w:comments>`;
         }
         const author = options.author || getUserName() || 'Claude';
         const date = new Date().toISOString();
         const commentId = nextCommentId;
         // Add comment to comments.xml
-        const newComment = `<w:comment w:id="${commentId}" w:author="${author}" w:date="${date}">
-  <w:p><w:r><w:t>${options.message}</w:t></w:r></w:p>
+        const newComment = `<w:comment w:id="${commentId}" w:author="${author}" w:date="${date}">
+  <w:p><w:r><w:t>${options.message}</w:t></w:r></w:p>
 </w:comment>`;
         commentsXml = commentsXml.replace('</w:comments>', `${newComment}\n</w:comments>`);
         // Find text and add comment markers
@@ -200,15 +200,15 @@ export function register(program) {
                 }
             }
             else {
-                commentsXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<w:comments xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
+                commentsXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<w:comments xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
 </w:comments>`;
             }
             const date = new Date().toISOString();
             const commentId = nextCommentId;
             // Add comment to comments.xml
-            const newComment = `<w:comment w:id="${commentId}" w:author="${author}" w:date="${date}">
-  <w:p><w:r><w:t>${message}</w:t></w:r></w:p>
+            const newComment = `<w:comment w:id="${commentId}" w:author="${author}" w:date="${date}">
+  <w:p><w:r><w:t>${message}</w:t></w:r></w:p>
 </w:comment>`;
             commentsXml = commentsXml.replace('</w:comments>', `${newComment}\n</w:comments>`);
             // Find text and add comment markers

package/dist/lib/grammar.js

@@ -125,9 +125,9 @@ export function loadDictionary(directory = '.') {
  */
 export function saveDictionary(words, directory = '.') {
     const dictPath = path.join(directory, DEFAULT_DICT_NAME);
-    const header = `# Custom dictionary for docrev
-# Add one word per line
-# Lines starting with # are comments
+    const header = `# Custom dictionary for docrev
+# Add one word per line
+# Lines starting with # are comments
 `;
     const content = header + [...words].sort().join('\n') + '\n';
     fs.writeFileSync(dictPath, content, 'utf-8');

package/dist/lib/import.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../lib/import.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../lib/import.ts"],"names":[],"mappings":"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"}

package/dist/lib/import.js

@@ -103,6 +103,44 @@ function pushPastSectionHeading(text, pos) {
     }
     return after;
 }
+/**
+ * Snap a position to the nearest whitespace boundary within ±50 chars so a
+ * proportional fallback insertion never lands mid-word.
+ */
+function snapToWordBoundary(text, pos) {
+    if (pos <= 0)
+        return 0;
+    if (pos >= text.length)
+        return text.length;
+    if (/\s/.test(text[pos] ?? ''))
+        return pos;
+    for (let d = 1; d <= 50; d++) {
+        if (pos + d < text.length && /\s/.test(text[pos + d] ?? ''))
+            return pos + d;
+        if (pos - d >= 0 && /\s/.test(text[pos - d] ?? ''))
+            return pos - d;
+    }
+    return pos;
+}
+/**
+ * Final-resort placement when every text-matching strategy failed. The docx
+ * carries a real `<w:commentRangeStart w:id="N">` marker at a known offset
+ * inside its body text — that's a structural anchor, even if the anchored
+ * span itself is empty and the surrounding context drifted in the target.
+ *
+ * Map docPosition into the target markdown proportionally and snap to a word
+ * boundary. This is approximate when the document was heavily restructured,
+ * but it's strictly better than silently dropping a reviewer's comment: the
+ * comment lands in roughly the right neighborhood and the reviewer can
+ * relocate it during their next pass.
+ */
+function proportionalFallback(anchorData, target) {
+    if (anchorData.docLength <= 0)
+        return null;
+    const proportion = Math.min(anchorData.docPosition / anchorData.docLength, 1.0);
+    const rawPos = Math.floor(proportion * target.length);
+    return pushPastSectionHeading(target, snapToWordBoundary(target, rawPos));
+}
 /**
  * Insert comments into markdown text based on anchor texts with context
  */
@@ -113,10 +151,42 @@ export function insertCommentsIntoMarkdown(markdown, comments, anchors, options
     let placedCount = 0;
     const duplicateWarnings = [];
     const usedPositions = new Set(); // For tie-breaking: track used positions
+    // Resolve threading: replies share their parent's anchor in Word, so they
+    // must inherit the parent's position and ride alongside it as one cluster.
+    // Letting each reply run through anchor scoring scatters the cluster (the
+    // same docPosition forces `usedPositions` to push later replies onto a
+    // different occurrence), which on re-build looks like independent comments
+    // and loses the paraIdParent threading. See gcol33/docrev issue #2.
+    const inputById = new Map();
+    for (const c of comments)
+        inputById.set(c.id, c);
+    function rootIdOf(c) {
+        let cur = c;
+        const seen = new Set();
+        while (cur.parentId && !seen.has(cur.id)) {
+            seen.add(cur.id);
+            const parent = inputById.get(cur.parentId);
+            if (!parent || parent === cur)
+                break;
+            cur = parent;
+        }
+        return cur.id;
+    }
+    const replyRootId = new Map();
+    for (const c of comments) {
+        const root = rootIdOf(c);
+        if (root !== c.id)
+            replyRootId.set(c.id, root);
+    }
     // Anchor matching primitives live in lib/anchor-match.ts so that
     // `rev verify-anchors` can use the same strategies for drift reporting.
-    // Get all positions in order (for sequential tie-breaking)
+    // Get all positions in order (for sequential tie-breaking).
+    // Replies skip scoring entirely — they piggyback on their root's position
+    // in the emit pass below.
     const commentsWithPositions = comments.map((c) => {
+        if (replyRootId.has(c.id)) {
+            return { ...c, pos: -1, anchorText: null, strategy: 'reply' };
+        }
         const anchorData = anchors.get(c.id);
         if (!anchorData) {
             unmatchedCount++;
@@ -212,12 +282,28 @@ export function insertCommentsIntoMarkdown(markdown, comments, anchors, options
                     return { ...c, pos: occurrences[0], anchorText: null, isEmpty: true };
                 }
             }
+            // Last resort: docx carried a structural marker at docPosition; map
+            // it proportionally into the target so the comment isn't dropped.
+            if (typeof anchorData === 'object') {
+                const fallback = proportionalFallback(anchorData, result);
+                if (fallback !== null) {
+                    return { ...c, pos: fallback, anchorText: null, isEmpty: true, strategy: 'proportional-fallback' };
+                }
+            }
             unmatchedCount++;
             return { ...c, pos: -1, anchorText: null, isEmpty: true };
         }
         // Text-based matching strategies
         const { occurrences, matchedAnchor, strategy, stripped } = findAnchorInText(anchor, result, before, after);
         if (occurrences.length === 0) {
+            // Same last-resort as the empty-anchor path: anchor text is gone from
+            // the target, but the marker's text-offset survived extraction.
+            if (typeof anchorData === 'object') {
+                const fallback = proportionalFallback(anchorData, result);
+                if (fallback !== null) {
+                    return { ...c, pos: fallback, anchorText: null, strategy: 'proportional-fallback' };
+                }
+            }
             unmatchedCount++;
             return { ...c, pos: -1, anchorText: null };
         }
@@ -244,51 +330,87 @@ export function insertCommentsIntoMarkdown(markdown, comments, anchors, options
             return { ...c, pos: finalIdx, anchorText: null };
         }
     });
-    // Log any unmatched comments for debugging
-    const unmatched = commentsWithPositions.filter((c) => c.pos < 0);
+    // Group comments into clusters (root + ordered replies). The root carries
+    // the resolved position; replies inherit it and ride along in input order
+    // so the rebuilt CriticMarkup looks like `{>>p<<}{>>r1<<}{>>r2<<}[anchor]`
+    // and adjacency-based reply detection picks the cluster up again.
+    const byId = new Map();
+    for (const cwp of commentsWithPositions)
+        byId.set(cwp.id, cwp);
+    const repliesByRoot = new Map();
+    for (const c of comments) {
+        const rootId = replyRootId.get(c.id);
+        if (!rootId)
+            continue;
+        const cwp = byId.get(c.id);
+        if (!cwp)
+            continue;
+        const list = repliesByRoot.get(rootId);
+        if (list)
+            list.push(cwp);
+        else
+            repliesByRoot.set(rootId, [cwp]);
+    }
+    // Replies whose root never resolved (parent missing from the input slice or
+    // parent unmatched) count as unmatched too — there's no position to attach
+    // them to.
+    for (const [rootId, replies] of repliesByRoot) {
+        const root = byId.get(rootId);
+        if (!root || root.pos < 0) {
+            unmatchedCount += replies.length;
+        }
+    }
+    // Roots only — replies attach during emission.
+    const rootsWithPos = commentsWithPositions.filter(c => !replyRootId.has(c.id));
+    // Log any unmatched roots for debugging
+    const unmatched = rootsWithPos.filter((c) => c.pos < 0);
     if (process.env.DEBUG) {
-        console.log(`[DEBUG] insertComments: ${comments.length} input, ${commentsWithPositions.length} processed, ${unmatched.length} unmatched`);
+        console.log(`[DEBUG] insertComments: ${comments.length} input, ${rootsWithPos.length} roots, ${unmatched.length} unmatched roots, ${replyRootId.size} replies`);
         if (unmatched.length > 0) {
             unmatched.forEach(c => console.log(`[DEBUG]   Unmatched ID=${c.id}: anchor="${(c.anchorText || 'none').slice(0, 30)}"`));
         }
     }
-    const matched = commentsWithPositions.filter((c) => c.pos >= 0);
+    const matchedRoots = rootsWithPos.filter((c) => c.pos >= 0);
     // Sort by position descending (insert from end to avoid offset issues)
-    matched.sort((a, b) => b.pos - a.pos);
-    // Insert each comment. With `wrapAnchor` (the default), the anchor text
+    matchedRoots.sort((a, b) => b.pos - a.pos);
+    // Insert each cluster. With `wrapAnchor` (the default), the anchor text
     // gets wrapped in `[anchor]{.mark}` so the rebuilt docx restores the
     // original Word comment range. Without it, the comment block is inserted
     // adjacent to the anchor and prose stays untouched — required for
     // comments-only sync where multiple comments may share one anchor.
-    // Skip insertion when an identical comment already lives near the target.
-    // Re-running sync against the same docx would otherwise stack duplicate
-    // CriticMarkup blocks (`{>>R1: ...<<}{>>R1: ...<<}...`) on each invocation.
-    // A 200-char window catches both wrapped (`{>>...<<}[anchor]{.mark}`) and
-    // bare (`{>>...<<}anchor`) forms while ignoring incidental matches farther
-    // away.
+    // Skip insertion when the parent's CriticMarkup already lives near the
+    // target — re-running sync against the same docx would otherwise stack
+    // duplicates. A 200-char window catches both wrapped
+    // (`{>>...<<}[anchor]{.mark}`) and bare (`{>>...<<}anchor`) forms while
+    // ignoring incidental matches farther away.
     let dedupedCount = 0;
-    for (const c of matched) {
-        const comment = `{>>${c.author}: ${c.text}<<}`;
+    for (const c of matchedRoots) {
+        const parentBlock = `{>>${c.author}: ${c.text}<<}`;
+        const replies = repliesByRoot.get(c.id) ?? [];
         const windowStart = Math.max(0, c.pos - 200);
         const windowEnd = Math.min(result.length, c.pos + 200);
-        if (result.slice(windowStart, windowEnd).includes(comment)) {
-            dedupedCount++;
+        if (result.slice(windowStart, windowEnd).includes(parentBlock)) {
+            // Cluster already synced; treat all members as deduped.
+            dedupedCount += 1 + replies.length;
             continue;
         }
+        // Replies carry an explicit `↪ ` author prefix so the round-trip does not
+        // depend on positional adjacency in the markdown. On dense reviewer docs
+        // distinct clusters frequently land at the same anchor position; without
+        // the prefix the re-parse would misthread them. The injection side strips
+        // `↪ ` back off the author so Word renders the original name.
+        const replyBlocks = replies.map(r => `{>>↪ ${r.author}: ${r.text}<<}`);
+        const combined = parentBlock + replyBlocks.join('');
         if (wrapAnchor && c.anchorText && c.anchorEnd) {
             const before = result.slice(0, c.pos);
             const anchor = result.slice(c.pos, c.anchorEnd);
             const after = result.slice(c.anchorEnd);
-            result = before + comment + `[${anchor}]{.mark}` + after;
+            result = before + combined + `[${anchor}]{.mark}` + after;
         }
         else {
-            // Insert comment at the anchor position with no surrounding whitespace
-            // tweaks; CriticMarkup blocks are invisible to readers, and adding a
-            // leading space would shift prose byte-for-byte (relevant when callers
-            // verify that --comments-only didn't touch the original).
-            result = result.slice(0, c.pos) + comment + result.slice(c.pos);
+            result = result.slice(0, c.pos) + combined + result.slice(c.pos);
         }
-        placedCount++;
+        placedCount += 1 + replies.length;
     }
     if (outStats) {
         outStats.placed = placedCount;