Skip to content

Penmark v0.5.0 — Review MVP

Choose a tag to compare

@carlosboeing carlosboeing released this 15 Jun 03:02

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/r anchors + a single trailing pmk:review block per the frozen public format (spec/penmark-format.md, agent contract in AGENTS-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-file concurrent-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