docrev 0.6.13 → 0.7.6

package/lib/wordcomments.js

@@ -73,8 +73,8 @@ export function prepareMarkdownWithMarkers(markdown) {
 
   // Detect reply relationships based on adjacency
   // First comment in a cluster = parent, all subsequent = replies to that parent
-  // Comments are "adjacent" if there's only whitespace between them (< 50 chars)
-  const ADJACENT_THRESHOLD = 50;
+  // Comments are "adjacent" if there's minimal text between them (< 10 chars)
+  const ADJACENT_THRESHOLD = 10;
   const comments = [];
   let clusterParentIdx = -1;  // Index of first comment in current cluster
   let lastCommentEnd = -1;
@@ -170,23 +170,9 @@ export function prepareMarkdownWithMarkers(markdown) {
         markedMarkdown = markedMarkdown.slice(0, removeStart) + markedMarkdown.slice(c.end);
       } else {
         // Normal case: replace with markers
-        let anchor = c.anchor || '';
-
-        // If no anchor, try to use the next word as fallback to avoid empty ranges
-        if (!anchor) {
-          const afterComment = markedMarkdown.slice(c.end);
-          // Match the next word (skip leading whitespace/punctuation)
-          const nextWordMatch = afterComment.match(/^\s*([a-zA-Z0-9]+)/);
-          if (nextWordMatch) {
-            anchor = nextWordMatch[1];
-            // Also need to consume the matched text from afterComment
-            c.consumeAfter = nextWordMatch[0].length;
-          }
-        }
-
+        const anchor = c.anchor || '';
         const replacement = `${MARKER_START_PREFIX}${i}${MARKER_SUFFIX}${anchor}${MARKER_END_PREFIX}${i}${MARKER_SUFFIX}`;
-        const endPos = c.end + (c.consumeAfter || 0);
-        markedMarkdown = markedMarkdown.slice(0, c.start) + replacement + markedMarkdown.slice(endPos);
+        markedMarkdown = markedMarkdown.slice(0, c.start) + replacement + markedMarkdown.slice(c.end);
       }
     }
   }
@@ -414,10 +400,19 @@ export async function injectCommentsAtMarkers(docxPath, comments, outputPath) {
       if (startInText === -1 || endInText === -1) continue;
 
       let textBefore = fullText.slice(0, startInText);
-      const anchorText = fullText.slice(startInText + startMarker.length, endInText);
+      let anchorText = fullText.slice(startInText + startMarker.length, endInText);
       let textAfter = fullText.slice(endInText + endMarker.length);
 
-      // When anchor is empty, normalize double spaces to single space
+      // When anchor is empty, use the first word from textAfter as fallback
+      if (!anchorText && textAfter) {
+        const wordMatch = textAfter.match(/^\s*(\S+)/);
+        if (wordMatch) {
+          anchorText = wordMatch[1];
+          textAfter = textAfter.slice(wordMatch[0].length);
+        }
+      }
+
+      // When anchor is still empty, normalize double spaces to single space
       if (!anchorText && textBefore.endsWith(' ') && textAfter.startsWith(' ')) {
         textAfter = textAfter.slice(1); // Remove leading space from textAfter
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docrev",
-  "version": "0.6.13",
+  "version": "0.7.6",
   "description": "Academic paper revision workflow: Word ↔ Markdown round-trips, DOI validation, reviewer comments",
   "type": "module",
   "types": "types/index.d.ts",
@@ -114,11 +114,13 @@
     "dictionary-en": "^4.0.0",
     "dictionary-en-gb": "^3.0.0",
     "diff": "^8.0.2",
-    "js-yaml": "^4.1.1",
     "mammoth": "^1.6.0",
     "mathml-to-latex": "^1.5.0",
     "nspell": "^2.1.5",
-    "xml2js": "^0.6.2"
+    "pdf-lib": "^1.17.1",
+    "pdfjs-dist": "^5.4.530",
+    "xml2js": "^0.6.2",
+    "yaml": "^2.8.2"
   },
   "devDependencies": {
     "c8": "^10.1.2"

package/skill/REFERENCE.md

@@ -1,12 +1,29 @@
 # docrev Command Reference
 
+## Project Creation
+
+### rev new
+Create a new document project.
+```bash
+rev new my-document          # Creates my-document/ with section files
+rev new my-document --template apa
+```
+
 ## Document Import/Export
 
 ### rev import
 Import a Word document with track changes and comments.
 ```bash
-rev import --file manuscript.docx
-rev import -f manuscript.docx --output ./project
+rev import manuscript.docx
+rev import manuscript.docx --output ./project
+```
+
+### rev sync
+Sync feedback from a reviewed Word document into existing markdown sections.
+```bash
+rev sync reviewed.docx       # Updates markdown with track changes/comments
+rev sync                     # Auto-detect most recent .docx
+rev sync reviewed.docx methods  # Sync only methods section
 ```
 
 ### rev build
@@ -16,8 +33,13 @@ rev build                    # Build PDF and DOCX
 rev build pdf                # PDF only
 rev build docx               # DOCX only
 rev build --toc              # Include table of contents
+rev build docx --dual        # Clean + annotated versions
 ```
 
+The `--dual` flag produces:
+- `paper.docx` — clean, for submission
+- `paper_comments.docx` — includes comment threads as Word comments
+
 ### rev preview
 Build and open document in default app.
 ```bash
@@ -62,9 +84,44 @@ rev resolve methods.md -n 1,2,3   # Multiple comments
 ```
 
 ### rev status
-Show annotation counts for a file.
+Show project overview or annotation counts for a file.
+```bash
+rev status               # Project overview (words, comments, changes)
+rev status methods.md    # Specific file annotations
+```
+
+### rev next / rev prev
+Navigate pending comments.
+```bash
+rev next                 # Show next pending comment
+rev next -n 3            # Show 3rd pending comment
+rev prev                 # Show last pending comment
+rev first methods        # First comment in methods section
+rev last                 # Last comment overall
+```
+
+### rev todo
+List all pending comments as a checklist.
+```bash
+rev todo                 # List all pending
+rev todo --by-author     # Group by author
+```
+
+### rev accept / rev reject
+Accept or reject track changes.
 ```bash
-rev status methods.md
+rev accept methods.md         # List all changes
+rev accept methods.md -n 1    # Accept change #1
+rev accept methods.md -a      # Accept all
+rev reject methods.md -n 2    # Reject change #2
+```
+
+### rev archive
+Archive reviewer .docx files.
+```bash
+rev archive              # Move all .docx to archive/
+rev archive --by Smith   # Specify reviewer name
+rev archive --dry-run    # Preview without moving
 ```
 
 ### rev strip
@@ -202,7 +259,7 @@ rev equations list           # List all equations
 rev equations from-word manuscript.docx  # Extract from Word
 ```
 
-## Direct DOCX Editing
+## Direct DOCX Editing (Layout Workflow)
 
 ### rev annotate
 Add comments directly to Word document.
@@ -224,19 +281,6 @@ rev comment paper.docx
 
 ## Project Management
 
-### rev init
-Initialize a new paper project.
-```bash
-rev init my-paper
-rev init my-paper --template apa
-```
-
-### rev sections
-List and manage section files.
-```bash
-rev sections                 # List all sections
-```
-
 ### rev clean
 Remove generated files.
 ```bash
@@ -277,3 +321,17 @@ Output shell completions.
 eval "$(rev completions bash)"  # Bash
 eval "$(rev completions zsh)"   # Zsh
 ```
+
+## AI Skill Installation
+
+### rev install-cli-skill
+Install the docrev skill for AI coding assistants.
+```bash
+rev install-cli-skill        # Install to ~/.claude/skills/docrev
+```
+
+### rev uninstall-cli-skill
+Remove the installed skill.
+```bash
+rev uninstall-cli-skill
+```

package/skill/SKILL.md

@@ -1,30 +1,63 @@
 ---
 name: docrev
-description: "Academic paper revision workflow tool (CLI: `rev`). Use when working with Word documents containing reviewer comments, importing track changes to markdown, replying to reviewer comments, building PDF/DOCX outputs, generating response letters, validating citations/DOIs, or any academic paper revision task."
+description: "Document revision workflow tool (CLI: `rev`). Use when working with Word documents containing reviewer comments, importing track changes to markdown, replying to reviewer comments, building PDF/DOCX outputs, generating response letters, validating citations/DOIs, or any document revision task."
 ---
 
-# docrev - Academic Paper Revision Tool
+# docrev - Document Revision Tool
 
-`rev` is a CLI tool for academic paper workflows with Word ↔ Markdown round-trips.
+`rev` is a CLI tool for document workflows with Word ↔ Markdown round-trips.
+
+Works for any document that goes through Word-based review: scientific papers, contracts, reports, proposals, manuals.
+
+## Content and Layout, Separated
+
+In Markdown, you focus on content. Write text, add citations with `[@key]`, insert equations with `$...$`, reference figures with `@fig:label`. No fiddling with fonts or styles.
+
+Layout is controlled in `rev.yaml`:
+
+```yaml
+title: "My Document"
+output:
+  docx:
+    reference-doc: template.docx
+```
+
+Change the template, rebuild, and every document gets the new formatting.
 
 ## Core Workflow
 
-### 1. Import reviewed Word document
+### 1. Create or import a project
+
+```bash
+rev new my-document          # Start from scratch
+rev import manuscript.docx   # Start from existing Word doc
+```
+
+### 2. Build and share
 
 ```bash
-rev import --file manuscript-reviewed.docx
+rev build docx               # Generate Word document
 ```
 
-This extracts track changes and comments as CriticMarkup annotations in markdown files.
+Send to reviewers. They add comments and track changes in Word.
 
-### 2. View and address comments
+### 3. Import feedback
 
 ```bash
-rev comments methods.md              # List all comments with context
-rev status methods.md                # Show annotation counts
+rev sync reviewed.docx       # Updates markdown with annotations
+rev sync                     # Auto-detect most recent .docx
 ```
 
-### 3. Reply to reviewer comments
+### 4. View and address comments
+
+```bash
+rev status                   # Project overview
+rev todo                     # List all pending comments
+rev next                     # Show next pending comment
+rev comments methods.md      # List all comments with context
+```
+
+### 5. Reply to reviewer comments
 
 **Always use the non-interactive reply mode:**
 
@@ -35,25 +68,31 @@ rev reply results.md -n 3 -m "Updated figure to include 95% CI"
 
 Replies appear as: `{>>Reviewer: Original<<} {>>User: Reply<<}`
 
-### 4. Resolve addressed comments
+### 6. Resolve addressed comments
+
+```bash
+rev resolve methods.md -n 1  # Mark comment #1 as resolved
+```
+
+### 7. Rebuild with comment threads
 
 ```bash
-rev resolve methods.md -n 1          # Mark comment #1 as resolved
+rev build docx --dual        # Produces clean + annotated versions
 ```
 
-### 5. Build output documents
+- `paper.docx` — clean, for submission
+- `paper_comments.docx` — includes comment threads as Word comments
+
+### 8. Archive reviewer files
 
 ```bash
-rev build                            # Build both PDF and DOCX
-rev build docx                       # Word only
-rev build pdf                        # PDF only
-rev build --toc                      # Include table of contents
+rev archive                  # Move reviewer files to archive/
 ```
 
-### 6. Generate response letter
+### 9. Generate response letter
 
 ```bash
-rev response                         # Generate point-by-point response letter
+rev response                 # Generate point-by-point response letter
 ```
 
 ## Annotation Syntax (CriticMarkup)
@@ -68,8 +107,28 @@ rev response                         # Generate point-by-point response letter
 
 | Task | Command |
 |------|---------|
+| Create project | `rev new my-project` |
+| Create LaTeX project | `rev new my-project --template latex` |
+| Import Word doc | `rev import manuscript.docx` |
+| Sync Word feedback | `rev sync reviewed.docx` |
+| Sync PDF comments | `rev sync annotated.pdf` |
+| Extract PDF comments | `rev pdf-comments annotated.pdf` |
+| Extract with highlighted text | `rev pdf-comments file.pdf --with-text` |
+| Append PDF comments | `rev pdf-comments annotated.pdf --append methods.md` |
+| Project status | `rev status` |
+| Next pending | `rev next` |
+| List pending | `rev todo` |
+| Filter by author | `rev comments file.md --author "Reviewer 2"` |
+| Reply to all pending | `rev reply file.md --all -m "Addressed"` |
+| Accept all changes | `rev accept file.md -a` |
+| Build Word | `rev build docx` |
+| Build PDF | `rev build pdf` |
+| Build clean + annotated Word | `rev build docx --dual` |
+| Build clean + annotated PDF | `rev build pdf --dual` |
+| Show contributors | `rev contributors` |
+| Lookup ORCID | `rev orcid 0000-0002-1825-0097` |
+| Archive reviewer files | `rev archive` |
 | Word count per section | `rev word-count` |
-| Word count with limit | `rev word-count --limit 5000` |
 | Project dashboard | `rev stats` |
 | Search all sections | `rev search "query"` |
 | Pre-submission check | `rev check` |
@@ -78,6 +137,7 @@ rev response                         # Generate point-by-point response letter
 | Check spelling | `rev spelling` |
 | Open PDF preview | `rev preview pdf` |
 | Auto-rebuild on changes | `rev watch` |
+| Check for updates | `rev upgrade --check` |
 
 ## DOI Management
 
@@ -115,7 +175,7 @@ Available in section files (processed during build):
 ## Project Structure
 
 ```
-my-paper/
+my-document/
 ├── rev.yaml           # Project config
 ├── introduction.md    # Section files with annotations
 ├── methods.md
@@ -126,17 +186,52 @@ my-paper/
 └── paper.docx         # Built output
 ```
 
+## PDF Comment Workflow
+
+For reviewers who annotate PDFs instead of Word documents:
+
+### 1. Extract comments from PDF
+
+```bash
+rev pdf-comments annotated.pdf              # Display all comments
+rev pdf-comments annotated.pdf --by-author  # Group by reviewer
+rev pdf-comments annotated.pdf --json       # Output as JSON
+```
+
+### 2. Import into markdown
+
+```bash
+rev sync annotated.pdf                      # Auto-import to sections
+rev pdf-comments annotated.pdf --append methods.md  # Append to specific file
+```
+
+### 3. Build PDF with margin notes
+
+```bash
+rev build pdf --dual
+```
+
+Produces:
+- `paper.pdf` — clean version for submission
+- `paper_comments.pdf` — comments rendered as LaTeX margin notes
+
+**Supported PDF Annotations:**
+- Sticky notes, text boxes, highlights, underlines, strikethrough, squiggly
+
 ## When Helping Users
 
-1. **Import phase**: Run `rev import` to get track changes as markdown
-2. **Review phase**: Use `rev comments` to see all comments, then `rev reply` to respond
-3. **Build phase**: Run `rev build docx` to generate the updated Word document
-4. **Validation phase**: Run `rev check` before submission (lint + grammar + citations)
-5. **Response letter**: Use `rev response` to generate point-by-point responses
+1. **Setup**: Ensure `rev config user "Name"` is set for replies
+2. **Sync phase**: Run `rev sync` to get feedback (works with both Word and PDF)
+3. **Review phase**: Use `rev todo` and `rev next` to navigate comments, `rev reply` to respond
+4. **Accept phase**: Use `rev accept -a` or `rev review` to handle track changes
+5. **Build phase**: Run `rev build docx --dual` or `rev build pdf --dual` for annotated versions
+6. **Archive phase**: Run `rev archive` to move reviewer files
+7. **Validation phase**: Run `rev check` before submission
+8. **Response letter**: Use `rev response` to generate point-by-point responses
 
 ## Critical: Ask Questions When Unsure
 
-When addressing reviewer comments or editing scientific papers:
+When addressing reviewer comments or editing documents:
 
 - **Never guess methods or numbers** - If a comment asks for clarification about methodology, sample sizes, statistical parameters, dates, or any quantitative information, ASK the user rather than inventing values
 - **Placeholders are acceptable** - Use `[???]` or `[TODO: specify X]` when information is missing rather than fabricating data

package/.rev-dictionary

@@ -1,4 +0,0 @@
-# Custom dictionary for docrev
-# Add one word per line
-# Lines starting with # are comments
-