tandem-editor 0.3.1 → 0.4.0

package/CHANGELOG.md

@@ -5,36 +5,92 @@ All notable changes to Tandem will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.3.0] - 2026-04-07
+## [0.4.0] - 2026-04-12
 
-### Wave 4: Notification & Interruption Redesign
+### Added
 
-- **Solo/Tandem mode** replaces All/Urgent/Paused interruption controls (#207, #226)
-- **Dwell-time selection events** — selections fire after 1s hold (#188)
-- **Configurable layout** — tabbed or three-panel, with settings popover (#206)
-- **Click-to-navigate** — click annotated text to jump to annotation card
-- **Tab badges** — notification counts on inactive panel tabs
-- **Skill-directed response routing** — Claude responds in chat panel, not terminal
-- Review banner replaced with per-annotation toasts (#208, landed earlier)
-- `Y_MAP_MODE` constant, Zod validation for mode reads, error logging in channel event bridge
-- 894 tests passing
+- Tauri v2 desktop app wrapping the existing web editor (macOS, Linux, Windows)
+- System tray with menu: Open Editor, Setup Claude, Check for Updates, About, Quit
+- Single-instance detection — second launch focuses the existing window instead of opening a duplicate
+- Node.js sidecar lifecycle: auto-spawn on startup, health polling, crash restart with exponential backoff
+- Auto-updater checks on launch and every 8h; manual check available via tray menu "Check for Updates"
+- Cross-platform CI release workflow (macOS arm64/x64, Linux x64, Windows x64) with GitHub Releases
+- Window state persistence — position and size remembered across sessions
+- Sample file copied to writable data directory on first run (supports read-only app bundles)
+- Self-signed code signing for Windows builds in CI
+- MCP setup auto-configuration on launch — writes Claude Code/Desktop config without manual `tandem setup`
+
+### Fixed
+
+- Accept `tauri.localhost` origin in WebSocket and CORS checks so the production WebView can connect
+- Strip Windows `\\?\` extended-length path prefix returned by Tauri path APIs before passing to Node
+- Sidecar binary name resolution corrected for Tauri's platform-specific naming convention
+- Self-contained JS bundles via tsup `noExternal` so Tauri doesn't require `node_modules` at runtime
+- Poll for port release before restarting after update install, preventing a startup race condition
+- Surface last HTTP error in health-poll timeout diagnostics for easier debugging
 
-## [Unreleased]
+### Changed
+
+- Updater-unavailable log downgraded from error to debug (reduces noise in dev builds without updater keys)
+- Unhandled sidecar events are now logged instead of silently dropped
+- Warn when `sample/` directory is missing in release builds
+- CI: fail build when updater signing key secret is absent
+- CI: summary job catches partial platform build failures rather than reporting false success
+
+## [0.3.2] - 2026-04-12
+
+### Changed
+
+- **Annotation type unification:** Three semantically identical types (`comment`, `suggestion`, `question`) collapsed into a single `comment` type with optional `suggestedText` and `directedAt` fields. `AnnotationTypeSchema` reduced from 5 values to 3: `highlight`, `comment`, `flag`. (#193, #245, #255)
+- **Toolbar:** Three annotation buttons (Comment, Suggest, Ask Claude) replaced with a single Comment button with "Replace" and "@Claude" toggles (#193)
+- **Side panel filters:** "Suggestions" → "With replacement", "Questions" → "For Claude" (#193)
+- **`sanitizeAnnotation()` moved to `src/shared/sanitize.ts`** — now available to both server and client code. Client-side Y.Map reads are sanitized to handle legacy session data. (#255)
 
 ### Added
 
 - Link (Ctrl+K), Horizontal Rule, and Code Block buttons in the formatting toolbar (#204)
-- Suggestion cards show a visual diff — original text in red strikethrough → replacement in green (#195)
+- Replacement cards show a visual diff — original text in red strikethrough → replacement in green (#195)
 - Undo countdown progress bar — a shrinking indicator shows the 10-second undo window (#196)
 - Review mode shortcut hints (Y / N / ↑↓ / Z) shown below the Review button (#200)
 - Chat anchor previews expand on hover to show full text (#198)
 - `disabledTitle` prop on toolbar buttons — annotation buttons show "Select text first" when no text is selected (#197)
 - Explicit ✕ close button on the highlight color picker (#203)
+- `tandem_comment` now accepts optional `suggestedText` and `directedAt` parameters (#193)
+- `sanitizeAnnotation()` normalizes legacy `suggestion`/`question` entries at read boundaries — permanent migration for historical session data (#193)
+- Exhaustive type switch in `buildDecorations` catches unhandled annotation types at compile time (#255)
+- 8 new tests covering MCP tool params, sanitization edge cases, and legacy migration paths (#255)
 
 ### Fixed
 
 - Toolbar wraps to a second row on narrow windows instead of overflowing; inline inputs shrink responsively (#192)
 - Edit button on annotation cards now shows a visible "✎ Edit" label instead of icon-only (#201)
+- Client-side legacy annotations (from pre-0.3.2 sessions) no longer render as invisible decorations or display raw JSON (#255)
+- `sanitizeAnnotation` no longer drops `textSnapshot: ""` or `editedAt: 0` via falsy-check bug (#255)
+- Event queue observer no longer silently dies if `sanitizeAnnotation` throws (#255)
+- `handleEdit` catch-block no longer corrupts annotation data on JSON parse failure (#255)
+
+### Deprecated
+
+- `tandem_suggest` MCP tool — use `tandem_comment` with `suggestedText` parameter instead (#193)
+
+### Removed
+
+- **MCP wire change:** Removed unused `"overlay"` annotation kind from `AnnotationTypeSchema`. External clients sending `type: "overlay"` will now receive a Zod validation error. (#249)
+- **MCP wire change:** `suggestion` and `question` annotation types removed from `AnnotationTypeSchema`. Use `comment` with `suggestedText` or `directedAt` fields. Legacy data is migrated automatically via `sanitizeAnnotation()`. (#193)
+
+## [0.3.0] - 2026-04-07
+
+### Wave 4: Notification & Interruption Redesign
+
+- **Solo/Tandem mode** replaces All/Urgent/Paused interruption controls (#207, #226)
+- **Dwell-time selection events** — selections fire after 1s hold (#188)
+- **Configurable layout** — tabbed or three-panel, with settings popover (#206)
+- **Click-to-navigate** — click annotated text to jump to annotation card
+- **Tab badges** — notification counts on inactive panel tabs
+- **Skill-directed response routing** — Claude responds in chat panel, not terminal
+- Review banner replaced with per-annotation toasts (#208, landed earlier)
+- `Y_MAP_MODE` constant, Zod validation for mode reads, error logging in channel event bridge
+- 894 tests passing
 
 ## [0.2.12] - 2026-04-06