Repository navigation
Penmark v0.5.0 — Review MVP
Penmark v0.5.0 — the Review MVP. Penmark now does its differentiating thing: Google-Docs-style inline review comments on rendered markdown, stored in the document itself, built for reviewing AI-authored design docs / plans / research in the IDE.
Local-first: download the VSIX below and sideload into VS Code / Cursor / Antigravity (--install-extension penmark-markdown-review-0.5.0.vsix or Extensions → Install from VSIX…). Compatibility floor engines.vscode ^1.105.0.
Highlights
- Inline comments — select rendered prose, add a comment; stored as invisible
pmk:s/b/ranchors + a single trailingpmk:reviewblock per the frozen public format (spec/penmark-format.md, agent contract inAGENTS-GUIDE.md). - Highlights, gutter dots, resolve popover — theme-aware, intensity-configurable; blue (human) / purple (agent) authorship.
- Comments drawer + needs-attention bucket + attention chip — orphaned / content-removed / degraded comments surfaced by the §8 reconcile degradation ladder, with re-anchor and delete.
- Add / resolve as one undo step (single
WorkspaceEdit), author identity, reconcile on open/change (corruption flagged, never silently swallowed). - Export review as an agent-ready prompt for handoff to a coding agent.
- Release-blocking acceptance gate — golden suite over the §8 desync states + real
git merge-fileconcurrent-merge scenarios, proving the single-file format survives 3-way merges.
Core VSIX 581 KiB (mermaid chunk excluded, lazy-loaded), under the 1 MiB budget.
Known limitation
Resolving a 3-way merge by keeping two pmk:review blocks surfaces the non-EOF block's comments via the corruption flag only, not yet in needs-attention (§8.5, tracked post-v0.5). No data loss; the union resolution is fully lossless.
Verification
CI is billing-blocked, so this release was verified locally per plan D16: build, typecheck, eslint, vitest run --coverage (717 passed; src/core/comments ≥95%), Docker Playwright goldens, and the VSIX size gate. The manual cross-IDE smoke (docs/guides/release-smoke-checklist-v0.5.md) is the remaining human step.
Full notes: CHANGELOG.
🤖 Generated with Claude Code