SecurityRonin/docx-mcp

Bulletproof Documents — Auto-Repair, Backups, and Silent-Failure Fixes

v0.3.1 makes every document that passes through docx-mcp structurally valid on save — no more Word recovery dialogs, no more silently empty conversions.

Save Safety Net

Every save_document() call now runs three layers of protection automatically:

• Backup-on-overwrite — creates .bak (or .bak2, .bak3...) before overwriting any existing file, so you never lose the original
• Auto-repair — silently fixes orphaned footnotes/endnotes, duplicate paraIds, and broken internal relationships before writing
• Warn-on-save — surfaces heading level skips, unpaired bookmarks, inconsistent tables, and residual DRAFT/TODO markers in the save response

Markdown Conversion Fixes

Three bugs that caused create_from_markdown to silently produce near-empty documents:

• BOM handling — files starting with a byte-order mark no longer lose the first heading
• HTML headings — <h1>–<h6> tags (common in AI-generated markdown) now render as proper Word headings instead of being silently dropped
• Unknown content preserved — unrecognized markdown blocks render as plain paragraphs instead of disappearing

Track Changes Fix

• Mid-run insertion placement — insert_text with a position substring that falls mid-run now correctly splits the run and inserts at the right point (previously placed at end of run)
• Delete-then-insert — inserting after previously deleted text now works correctly

Other

• README rewritten for end-user audience (legal, security, consulting professionals)
• create_from_markdown auto-saves to disk immediately (no separate save_document call needed)
• 355 tests, 100% coverage

Full Changelog: https://github.com/SecurityRonin/docx-mcp/compare/v0.3.0...v0.3.1