M17: Core UX -- Hover Cards, Toolbars & Pinboard
Phase: A1 Amendment -- Phase 3 Roadmap: SPEC-GAP-IMPLEMENTATION-PLAN.md Phase 3 Version target:
web/v0.17.0
Phase Context
Goal: Implement the core user experience features that make the application interactive and productive: a three-layer hover card system with six trigger types, vertical verse-aligned and floating toolbars, a session-scoped Pinboard widget with pinnable items, compound tab comparison, pane discovery, and session color ambient accent with workspace choreography.
Key constraint: The hover card system (M17-001) is on the critical path -- its data hooks and trigger zones must land first, and its pin action gates the Pinboard widget. The vertical toolbar (M17-005) gates both the floating toolbar refactor and comparison entry points.
ZenHub Configuration
| Field | Value |
|---|---|
| Milestone | M17: Core UX -- Hover Cards, Toolbars & Pinboard |
| Due Date | TBD |
| Default Pipeline | Product Backlog |
| Primary Epic(s) | Hover Card System, Toolbar System, Pinboard & Comparison |
Prerequisites
- M16 Phase 1 (M16-002/003/006/008/013) -- plugin host + manifest loader + dock-zone container + composition surfaces + PaneInstance plumbing
Epics & Issues
Epic: Hover Card System
| Issue | Title | Status | Notes |
|---|---|---|---|
| M17-001 | Three-Layer Hover Card System (Verse, Word, Entity Triggers) | ❌ To Do | Three-layer system with 6 trigger types |
| M17-002 | Hover Card Data Hooks (Content Service Integration, Caching) | ❌ To Do | TanStack Query integration |
| M17-003 | Hover Card Plugin Tabs (Plugin Manifest contributes.hoverCardTabs) | ❌ To Do | Plugin tab contribution system |
| M17-004 | Hover Card Action Bar (Pin, Compare, Open in Map, Copy) | ❌ To Do | Action bar with 4+ actions |
Epic: Toolbar System
| Issue | Title | Status | Notes |
|---|---|---|---|
| M17-005 | Vertical Verse-Aligned Toolbar (Active Modes, Highlight, Annotate) | ❌ To Do | Vertical toolbar with active mode system |
| M17-006 | Floating Toolbar Refactor (Selection-Triggered, A1 Merge) | ❌ To Do | Selection-triggered floating toolbar |
Epic: Pinboard & Comparison
| Issue | Title | Status | Notes |
|---|---|---|---|
| M17-007 | Pinboard Widget (Session-Scoped Pins, Drag-Reorder) | ❌ To Do | Session-scoped pin management |
| M17-008 | Compound Tab Comparison (Side-by-Side, Synced Scroll) | ❌ To Do | Side-by-side comparison in panes |
| M17-009 | Pane Discovery Mechanism (Empty State, Suggested Content) | ❌ To Do | Empty pane discovery UI |
| M17-010 | Session Color Ambient Accent with Workspace Choreography | ❌ To Do | Dynamic color accent per session |
| M17-011 | Workspace Choreography (Default Layout Transitions per Context) | ❌ To Do | Context-driven layout transitions |
Progress: 0 Done · 0 Partial · 11 To Do (0%)
Summary
| Metric | Count |
|---|---|
| Total Issues | 11 |
| Sub-Issues | 0 |
| Total Estimate (pts) | 71 |
| Sprints | S5--S7 |
| Dependencies (blocking) | 8 |
| Dependencies (blocked by) | 8 |