feat(review): send preview comments to quickfix list

[antono]

Review comments → quickfix list

Let a reviewer attach a comment to a rendered block in the browser preview and map it back to the original markdown line, appending it to Neovim's quickfix list — immediately usable by :copen and by quickfix-review-nvim. No extra plugins required for the base feature.

The feature is opt-in and built without requiring a Next.js rebuild of the bundled app/out/.

Usage

" one-shot: enable review mode and open the preview
:MarkdownReview

Then in the browser, hover any paragraph / heading / list item / table → click the 💬 button → type a comment. Back in Neovim:

:copen           " the comment is a quickfix item at the right source line
:QuickfixReview  " optional: annotate with quickfix-review-nvim

:MarkdownPreview still opens a normal preview with no comment UI.

Configuration

Variable	Default	Description
g:mkdp_enable_review	0	Enable the comment UI and quickfix integration
g:mkdp_review_auto_open	0	Run :copen automatically after each comment

How it works

• The browser already injects data-source-line attributes on block elements (used for sync-scroll); the overlay reuses them to map a click back to the 1-based source line.
• The Node server already holds a live msgpack-RPC handle to Neovim, so it calls setqflist(..., 'a') directly — no nvr, no extra channel.

Changes

• plugin/mkdp.vim: add g:mkdp_enable_review and g:mkdp_review_auto_open; register :MarkdownReview command + <Plug>MarkdownReview mappings
• autoload/mkdp/review.vim (new): mkdp#review#open() enables review then opens the preview; mkdp#review#add() resolves the buffer path and appends a quickfix item, gated by the flag, with an unnamed-buffer guard
• app/server.js: handle the add_comment socket event and ack the client
• app/routes.js: inject the review flag and comments.js at serve time (no out/ rebuild required)
• app/_static/comments.js (new): build-free overlay with hover button, comment popover, and quickfix-line marker decoration

Notes / limitations

• Comments anchor to the nearest block that carries data-source-line (paragraph, heading, list item, table).
• Line numbers can drift if the buffer is edited after commenting — same as any quickfix entry.
• Markers are in-memory per page session (a future phase could sync them back from the quickfix list).