V7_4_BUILD_NOTES.md
Design Mockups/Archived Mockups/DOC20 Mockups and Design/DOC20 Archived Mockups/V7_4_BUILD_NOTES.md
# Q_UNIFIED_WORKSPACE_V7_4 — Build Notes
## Date: 2026-04-05
## Changes from V7.3, organized by DOC20 section impact
---
### 1. Note Canvas — Fully Editable with Module Islands
**DOC20 impact:** §6.14 (Notes Editor), §6.18.2 (Content Registry)
- Note content area is now fully `contentEditable` — all space between modules is typeable
- Modules (Task List, Inline Thread, Activity Feed, Notice Bar) render as bordered "island" components embedded in the flowing text
- Editable paragraph gaps are enforced between every module
- **New module type: "Note Block"** — a boxed, movable note module (distinct from ambient canvas text), added as first option in +Module picker
- Final editable area at bottom of note ensures you can always type below the last module
- Tiptap implementation note: modules would be custom NodeView extensions; ambient text is standard Tiptap paragraph content
### 2. Tab Groups — Auto-Save + Nav Section
**DOC20 impact:** §6.3 (Tab Bar), §6.4 (Browser Column — Nav tab)
- Tab groups auto-persist on creation and on any change (add/remove tab, rename, recolor)
- Removed "Save Group" from group context menu (no longer needed)
- Group context menu now: Rename, Change Color, Ungroup All, Close Group
- **New Nav tab section: "Tab Groups"** — collapsed by default, shows count badge, expands to list all groups with color dot, name, tab count. Clicking a group reveals it and switches to first tab.
### 3. Split Screen — Independent Panes
**DOC20 impact:** §6.3 (Tab Bar), new §6.XX (Split View)
- Split screen icon added to far right of tab bar (Columns icon)
- Toggles workspace into two side-by-side panes with draggable vertical divider
- Each pane has its own tab bar, own active tab, own content area
- Left pane retains browser column toggle; right pane does not
- Close button on right pane collapses back to single view with "tabs merged" toast
- Split focus tracked — clicking in a pane sets it as active
- Each pane independently supports its own right panel (Comments/Ask)
### 4. Tab Group Border Styling — Chrome-Style
**DOC20 impact:** §6.3 (Tab Bar — tab groups visual)
- Group color opacity increased (from `40` to `90` for inactive tabs)
- Active tab in group: top + left + right borders in group color, bottom border transparent (tab "pokes out" from group strip)
- Inactive tabs in group: bottom border only in group color
- Creates visual "snake" effect where the group color line wraps around the active tab
### 5. Document Title — Clickable + Right-Click Menu
**DOC20 impact:** §6.12 (Document Viewer toolbar)
- Document title in toolbar is now clickable → opens in default app (Preview.app, Word, etc.)
- Tooltip: "Click to open in default app"
- Right-click on title opens context menu:
- Show in Finder (`shell.showItemInFolder()`)
- Open in Default App (`shell.openPath()`)
- Copy Ref (EC internal reference, e.g., `doc:sanli_expert_report:v2`)
- Copy Path
- Copy File Name
- "Ref" button also added to doc toolbar for quick ref copy
### 6. Ask {Agent} Panel — Simplified
**DOC20 impact:** §6.16 (Right Panel — Ask tab)
- **Compact top section** (collapsible):
- Context reference: single line showing icon + title (no "PDF document" redundancy)
- Agent + Send In on same row (horizontal space saved by using letter-badge instead of full avatar)
- Agent selector: compact dropdown with letter badge
- Send In selector: Inline / New Chat / Existing Chat (replaces old separate "Output mode" and "Send in" which were redundant)
- **"Send with" (replaces "Context scope"):**
- "Document only" — just the content
- "All comments & referenced portions" — document + all open comments + anchor text
- "Select comments" — pick specific ones with checkboxes
- **"Additional instructions"** — single optional textarea (replaces the old mandatory "Instruction" + separate "Send with instructions" mode)
- **"Include session clips"** — single checkbox (replaces old multi-checkbox "Include" section; removed "Active project context" and "Pinned pages" as unnecessary)
- Config section collapses after first send to give response more room
- Inline agent response with "Continue in full chat →" link
- Bottom bar: single primary button label changes based on Send In mode
### 7. Status Bar — Bigger + Zoom Slider
**DOC20 impact:** §6.17 (Status Bar)
- Font bumped from 10px to 11px, padding from 3px to 5px
- **Zoom slider** (Word-style): minus button, range slider, plus button, percentage label
- Click percentage to reset to 100%
- Range: 50% to 200%
- Zoom applies to content area via CSS `transform: scale()` with width compensation
- "New Session" and zoom controls on right side
- Status bar spans full workspace width (does not extend under right panel — zoom applies to content only)
### 8. Browser Column Tabs — Improved Styling
**DOC20 impact:** §6.4 (Browser Column — mode tabs)
- Label font increased from 10.5px to 11.5px
- Active tab: fontWeight 700 (was 650), background matches panel, subtle border outline (top + sides), rounded top corners, slight negative margin to overlap border
- Inactive tabs: lighter background, no border, lower font weight
- Better visual differentiation between active and inactive states
### 9. "Knowledge Manager" → "Knowledge"
**DOC20 impact:** §6.4 (Nav tab), [+] menu, any reference to this page name
- Label shortened everywhere: Nav tab pages list, [+] dropdown Open section
- Page title when opened as utility tab: "Knowledge"
### 10. Per-Tab Right Panel State
**DOC20 impact:** §6.16 (Right Panel state management)
- Right panel state (comments, ask, agent response) resets on tab switch
- Utility tabs: right panel auto-closes on switch (no Comments tab shown for utility pages, only Ask tab available if reopened)
- Content tabs: panel closes, state resets, can be reopened fresh for new tab
### 11. Bookmarks Bar
**DOC20 impact:** §6.19 (Embedded Browser), new subsection for bookmarks bar
- Thin horizontal bar below web browser toolbar (URL bar)
- Populated from special "Bookmarks Bar" folder in bookmark tree (marked with `isBar: true`)
- Shows favicon-style color badge + title for each bookmark
- "⋯" button at end for editing bar contents
- Visibility toggled via settings (bmBarVisible state)
- Only visible on web tab type
### 12. Floating Command Palette ("Quick Command Window")
**DOC20 impact:** New §6.20 (Quick Command Window)
- Toggle: ⚡ button in left nav rail (bottom), or keyboard shortcut ⌥Space (noted in UI)
- Dark floating window: 560px wide, centered on screen, dark theme (#1a1d23 background)
- Rounded corners (12px), heavy drop shadow, modal with backdrop
- **Three modes** via top tab bar:
**💬 Chat mode:**
- Persistent Quick Command chat — scrollable message history
- Input bar with send button at bottom
- Screen capture toggle (camera icon, top right) — when on, shows 📸 indicator on messages
- "New Thread" button — archives current thread, starts fresh
- "Open in Q ↗" link — opens chat in full Q workspace
- Status line shows capture state
**📝 Note mode:**
- Quick scratchpad textarea (200px height)
- Auto-saves to "Today Note" (configurable)
- Save button for explicit save
- Minimal chrome — just write and save
**⌘ Command mode:**
- Search input for commands, entities, actions
- Quick Actions list:
- "Watch my actions" (DOC3 demonstration mode trigger, highlighted with accent color, ⌥W shortcut)
- New note, Search knowledge graph, Run standing procedure, Open Settings
- Recent items list (recent files, chats)
- Keyboard navigation hints in footer (↑↓ to navigate, ↵ to select, Esc to close)
**Architectural notes for DOC20 spec:**
- Quick Command Window is a separate Electron `BrowserWindow` with `alwaysOnTop: true`, `frame: false`
- Chat persistence: dedicated chat with `chat_type: "quick_command"`, stored in same chat store, visible in Q's chat list with ⚡ indicator
- Screen capture: uses DOC3 §4.3 screenshot adapter infrastructure in single-frame mode, attached as ephemeral context to chat message, purged after 24h
- "Watch my actions" trigger sends `learn.session.start` command to EC (same as Q's Learn page)
- Escape key or clicking backdrop closes the window (hides, not destroys)
---
## Items NOT in this mockup (deferred):
- Full web browser settings panel expansion (DOC20 §6.19 subsections)
- Chrome extension support UI
- Native app companion windows
- Full notes folder tree management (simplified in V7.4 for space)
- Full bookmark folder management (simplified)
- Right chat column replacement (awaiting separate mockup from Will)