Manuscript Placeholder Collector
Repair formatting and add opt-in DOCX table/comment/footnote scanning with source locations and a private resolution ledger with baseline comparisons.
The problem it solves
Manuscript Placeholder Collector Writers leave themselves notes while drafting: [RESEARCH THIS], TODO: fix the argument, <insert description, TK, or a row of question marks. Manuscript Placeholder Collector gathers those scattered reminders into one private revision checklist.
Who Manuscript Placeholder Collector is for
- People who need a small, purpose-built utility instead of a broad platform.
- Users working with writing, manuscript, DOCX who want the documented v1.2.0 behavior.
- People who prefer an open-source release with visible limitations, source, and license terms.
Intended result
Repair formatting and add opt-in DOCX table/comment/footnote scanning with source locations and a private resolution ledger with baseline comparisons.
This summary is reconciled from the current catalog and repository documentation.
Features in v1.2.0
Capabilities below come from the current project README and release documentation.
Writers leave themselves notes while drafting: [RESEARCH THIS], TODO: fix the argument, <insert description, TK, or a row of question marks. Manuscript Placeholder Collector gathers those scattered reminders into one private revision checklist.
Verified examples
Screenshots are shown only when the current README references a local source image. Otherwise, repository example files are linked directly.
Verified release evidence
This project does not currently publish a screenshot or dedicated example folder. The current README, tests, changelog, tagged release, and source repository remain the verified examples of its behavior.
Platforms and implementation
The public release claims only the cataloged platforms and technologies.
Supported platforms
- Windows
- macOS
- Linux
Built with
- Python
- python-docx
What changed in v1.2.0
Repair formatting and add opt-in DOCX table/comment/footnote scanning with source locations and a private resolution ledger with baseline comparisons.
manuscript-placeholders draft.docx --docx-tables --docx-comments --docx-footnotes --format json --output review.json --ledger-output resolution.jsonDOCX body paragraphs remain the default. Optional structures identify XML part, table/row/cell/paragraph or comment/footnote IDs, plus character offsets within extracted paragraph text. Text files retain line positions. Reports explicitly list enabled/skipped optional structures; headers, footers, endnotes, text boxes and legacy DOC converter behavior are not expanded. --ledger reads a version 1 items object keyed by finding fingerprint with open/resolved/ignored status and a private note. --ledger-output writes a new ledger preserving old entries. --baseline compares a previous fingerprinted JSON report. Fingerprints include source location, marker offset and marker text, so moved text can appear new. A missing marker does not prove an issue was resolved. Source manuscripts and existing outputs remain untouched.
Quick start
The shortest documented path into the current release.
Python 3.10 or newer is required.
python -m venv .venv
python -m pip install -e .Current limitations
These boundaries are part of the product and prevent the page from implying unverified capability.
- Legacy
.docsupport depends onantiword,catdoc, or LibreOffice being installed locally and available onPATH; modern.docxdoes not need that extra tool. - Word tables, headers, footnotes, comments, and tracked changes are not scanned.
- Natural-language notes that do not match a marker require a custom regular expression.
- The collector does not rewrite the original manuscript or decide when an item is resolved.
Privacy and licensing
Review the actual data boundary before using a tool with sensitive inputs.
Privacy and safety
The manuscript stays on the computer. No text is uploaded, and no AI or external API is used. Reports necessarily contain the matched note and nearby manuscript context; treat exported reports with the same privacy as the manuscript.
License and release
Manuscript Placeholder Collector is published under MIT. The current cataloged release is v1.2.0, published 2026-09-07.
Related projects
Related projects are selected deterministically from shared catalog tags, category, and implementation technologies—not popularity or paid placement.
Manuscript Placeholder Collector v1.2.0
Use the tagged release for downloads and release notes. Use the repository for source, issues, contribution guidance, security reporting, and complete documentation.
Page source: current Forge catalog plus README and CHANGELOG from the canonical local repository. Fingerprint: 9f11674b28cdb0a9.