Elnor Repo Reader

V7_4_BUILD_NOTES.md

Design Mockups/Archived Mockups/DOC20 Mockups and Design/DOC20 Archived Mockups/V7_4_BUILD_NOTES.md

Generated 2026-06-09T01:23:58.539Z from commit dbaa25962edc11ab30e8d4ca1715f9ae5bf77331. Worktree: clean.

Open text page · Open raw txt · Open path URL

# 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)