Phase 4C: Convergence — Changeset Review UI

[mikewolfd]

Motivation

This is where Track A (ProposalManager, Phase 4A) meets Track B (chat panel, Phase 4B). The changeset review UI renders in the chat panel, letting users review AI changes grouped by dependency, accept or reject groups, and see conflict diagnostics — all while continuing to edit the canvas.

Parent epic: #9 — Unified Authoring Architecture

Scope

• Changeset review UI component in the chat panel
• Dependency-grouped display — entries grouped by DependencyGroup, not individual operations
• Per-group accept/reject controls
• Accept all / reject all shortcuts
• Real-time progress — as AI calls MCP tools, each operation appears with its summary
• User overlay awareness — show user edits made during the changeset period
• Conflict diagnostics display — post-merge diagnose() results rendered inline
• Visual differentiation of AI-created elements on canvas during review (subtle badge/color)
• State transition feedback — brief flash on merge/reject as state restores and replays
• Scaffold review mode — single large group with structure overview (field count, etc.)

Acceptance Criteria

• User can review AI changesets in the chat panel while continuing to edit the canvas
• Partial merge works: accept some dependency groups, reject others
• User overlay edits preserved through reject-all and partial merge
• Conflict diagnostics clearly communicated when user overlay depends on rejected AI changes
• Canvas visually distinguishes AI-created elements during review period
• Scaffold (first changeset) reviewable as a whole with structure summary

Layer

SaaS Platform (Layer 6)

Dependencies

• Phase 4A (Phase 4A: ProposalManager (Changeset Semantics) #13) — ProposalManager, changeset types, dependency grouping
• Phase 4B (Phase 4B: Chat Integration in Studio #14) — chat panel exists in studio
• This phase CANNOT start until both 4A and 4B are complete

Spec Reference

thoughts/specs/2026-03-24-unified-authoring-architecture.md — Section 2 (Merge UX) and Section 4 (Chat Panel)