Dodaios is an open-source agent OS for your desktop: it runs your coding agents, browser and apps by voice or chat, on your own machine. Formerly Personal Jarvis.
Python agent-orchestrationai-agentai-coding-assistantclaude-codecoding-agentcomputer-usedesktop-applocal-firstmcppersonal-jarvisvoice-assistantvoice-coding
fix(sidebar): the rail's hover label paints over the IDE's pane chat, not under it
rubenluetke10-beep258fb1bd9a67
diff --git a/docs/BUGS.md b/docs/BUGS.mdindex 2aad109df8..f506e5d301 100644--- a/docs/BUGS.md+++ b/docs/BUGS.md@@ -13738,3 +13738,32 @@ none of them. Memory that stands in for a computation must record WHEN it wascomputed, or a fact that arrives later loses to a stale one. And the durablesource was on disk the whole time: the CLI's own transcript names everysession, restart or not.++## BUG-195: the collapsed sidebar's hover label is cut to "Lo" at the rail's edge in the Agentic IDE — the pane chat's `z-20` tied with the nav column's `z-20` and won on DOM order (LOW, FIXED 2026-08-27)++**Symptom.** With the sidebar collapsed to its icon rail and the Agentic IDE+open in chat mode, hovering an icon showed the first two letters of its name+("Lo" for Local models) and nothing past the sidebar's right edge (maintainer+screenshot 2026-08-27 11:46). Every other section drew the label whole.++**Root cause.** The rail's label was an `absolute` child of the sidebar+column, which paints at `z-20`. The stage column beside it deliberately+carries NO stacking context (App.tsx, `overlay-stacking.test.ts`) so a+section's full-screen overlays can reach the app's dialog levels — which also+means every z-index a section uses lands in the SAME root context as the+sidebar's. `PaneChat` covers its pane with `absolute inset-0 z-20`; equal+z-index, later in the DOM, so it painted over the part of the label that+reached past the column. Raising the column's z-index would only move the tie+to the next section overlay (the IDE has `z-30` drag targets and dropdowns).++**Fix.** `DockRail` renders the label through `createPortal` on `<body>`,+`position: fixed` at the app's tooltip level (`z-[70]`, the same as+`QuickTooltip`), and offsets its rail-relative `top` by the rail's measured+viewport position, re-measured whenever the hovered slot changes — the only+moment the label moves. Regression: `DockRail.test.tsx` ("the label leaves+the rail's stacking context").++**Lesson.** An open stage column is a two-way door: it lets a section's+overlays out, and it lets a section's z-indexes in. Anything in the chrome that+reaches past its own column must not rely on the column's z-index; a portal at+the tooltip level is the one placement no section can tie with.diff --git a/jarvis/ui/web/frontend/src/components/layout/DockRail.test.tsx b/jarvis/ui/web/frontend/src/components/layout/DockRail.test.tsxindex 77cea0df47..1927cb0e34 100644--- a/jarvis/ui/web/frontend/src/components/layout/DockRail.test.tsx+++ b/jarvis/ui/web/frontend/src/components/layout/DockRail.test.tsx@@ -98,6 +98,22 @@ describe("DockRail", () => {);});+ test("the label leaves the rail's stacking context — a portal on <body>, fixed to the viewport", () => {+ // The sidebar column paints at z-20 in the same stacking context as the+ // section stage, so a section's own z-20 layer (the IDE's pane chat) ties+ // with it and wins on DOM order: "Local models" was cut to "Lo" at the+ // rail's edge (report 2026-08-27). The label therefore rides outside the+ // column entirely, at the tooltip level.+ renderRail();+ const rail = screen.getByTestId("dock-rail");+ moveTo(rail, centreOf(2));+ const label = screen.getByTestId("dock-label");+ expect(label.parentElement).toBe(document.body);+ expect(rail.contains(label)).toBe(false);+ expect(label.classList).toContain("fixed");+ expect(label.classList).toContain("z-[70]");+ });+test("hovering does not grow or move an icon — the rail holds its size and place", () => {// The magnification was taken back by the maintainer (2026-08-18): the// hovered icon gets its surface and its label, nothing else changes.diff --git a/jarvis/ui/web/frontend/src/components/layout/DockRail.tsx b/jarvis/ui/web/frontend/src/components/layout/DockRail.tsxindex e611ad669d..c2f34f423c 100644--- a/jarvis/ui/web/frontend/src/components/layout/DockRail.tsx+++ b/jarvis/ui/web/frontend/src/components/layout/DockRail.tsx@@ -1,4 +1,5 @@import { useCallback, useEffect, useMemo, useRef, useState } from "react";+import { createPortal } from "react-dom";import {AnimatePresence,motion,@@ -131,11 +132,36 @@ export function DockRail({ className }: { className?: string }) {const labelTopSmooth = useSpring(labelTopRaw, GLIDE_SPRING);const labelTop = reduced ? labelTopRaw : labelTopSmooth;+ // The label is rendered in a portal on <body>, fixed to the viewport, and+ // its rail-relative `top` is offset by where the rail sits on screen. The+ // offset is measured whenever the hovered slot changes — the only moment+ // the label's own position changes too, so the derived value is never stale+ // for a label that is moving. The rail itself does not move mid-hover.+ //+ // Why a portal: the sidebar column paints at z-20 with no stacking context+ // around the section stage (App.tsx), so a section's own `z-20` layer — the+ // IDE's pane chat is one — meets the column's z-20 in the SAME context and+ // wins on DOM order, covering a label that reaches past the rail's edge.+ // A higher z-index on the column would only move the tie to the next+ // section overlay; leaving the column's context entirely settles it, the+ // same way `QuickTooltip` does.+ const navRef = useRef<HTMLElement | null>(null);+ const navTop = useRef(0);+ const labelLeft = useMotionValue(LABEL_LEFT);+ const labelViewportTop = useTransform(labelTop, (top: number) => top + navTop.current);+ const measureOrigin = useCallback(() => {+ const rect = navRef.current?.getBoundingClientRect();+ if (!rect) return;+ navTop.current = rect.top;+ labelLeft.set(rect.left + LABEL_LEFT);+ }, [labelLeft]);+const setHoveredSlot = useCallback((slot: number) => {const prev = hoveredRef.current;if (slot === prev) return;hoveredRef.current = slot;+ if (slot >= 0) measureOrigin();hoveredMV.set(slot);setHovered(slot);if (slot < 0) return;@@ -198,6 +224,7 @@ export function DockRail({ className }: { className?: string }) {return (<nav+ ref={navRef}aria-label={t("deck.sections")}className={cn("relative z-10 flex min-h-0 w-16 shrink-0 flex-col", className)}>@@ -243,37 +270,42 @@ export function DockRail({ className }: { className?: string }) {</div></div>- {/* The label rides beside the hovered icon, outside the scroller so the- scroller's clipping cannot cut it off. Decorative: every button- already carries its name as aria-label. */}- <AnimatePresence>- {hoveredItem && (- <motion.div- key="label"- aria-hidden- data-testid="dock-label"- initial={{ opacity: 0, x: -6 }}- animate={{ opacity: 1, x: 0 }}- exit={{ opacity: 0, x: -4 }}- transition={reduced ? { duration: 0 } : { duration: 0.12, ease: "easeOut" }}- style={{ top: labelTop, left: LABEL_LEFT, y: "-50%" }}- className="pointer-events-none absolute flex items-center gap-1.5 whitespace-nowrap rounded-md border border-border bg-background/95 px-2 py-1 text-xs text-foreground shadow-md backdrop-blur"- >- {resolveNavLabel(t, hoveredItem)}- {hoveredItem.beta && (- <span className="rounded-full border border-primary/30 bg-primary/10 px-1.5 py-0.5 text-[9px] font-medium uppercase tracking-wide text-primary">- {t("nav.agentic_ide_beta")}- </span>- )}- {hoveredCount > 0 && (- <span className="font-mono text-[10px] text-primary">{hoveredCount}</span>- )}- {hoveredHint && (- <span className="max-w-[28ch] truncate text-muted-foreground">— {hoveredHint}</span>- )}- </motion.div>- )}- </AnimatePresence>+ {/* The label rides beside the hovered icon. It lives in a portal on+ <body>, fixed to the viewport, so neither the scroller's clipping nor+ a section's own z-20 layer (see `measureOrigin`) can cut it off.+ z-[70] is the app's tooltip level (`QuickTooltip`). Decorative: every+ button already carries its name as aria-label. */}+ {createPortal(+ <AnimatePresence>+ {hoveredItem && (+ <motion.div+ key="label"+ aria-hidden+ data-testid="dock-label"+ initial={{ opacity: 0, x: -6 }}+ animate={{ opacity: 1, x: 0 }}+ exit={{ opacity: 0, x: -4 }}+ transition={reduced ? { duration: 0 } : { duration: 0.12, ease: "easeOut" }}+ style={{ top: labelViewportTop, left: labelLeft, y: "-50%" }}+ className="pointer-events-none fixed z-[70] flex items-center gap-1.5 whitespace-nowrap rounded-md border border-border bg-background/95 px-2 py-1 text-xs text-foreground shadow-md backdrop-blur"+ >+ {resolveNavLabel(t, hoveredItem)}+ {hoveredItem.beta && (+ <span className="rounded-full border border-primary/30 bg-primary/10 px-1.5 py-0.5 text-[9px] font-medium uppercase tracking-wide text-primary">+ {t("nav.agentic_ide_beta")}+ </span>+ )}+ {hoveredCount > 0 && (+ <span className="font-mono text-[10px] text-primary">{hoveredCount}</span>+ )}+ {hoveredHint && (+ <span className="max-w-[28ch] truncate text-muted-foreground">— {hoveredHint}</span>+ )}+ </motion.div>+ )}+ </AnimatePresence>,+ document.body,+ )}</nav>);}