Workspace manager - design

Design B, refined and aligned with the design system of the jupyterlab-extension skill. DQ-21 and DQ-22 were decided by the Star Colonel on 2026-10-29. DQ-02, DQ-04, DQ-05 and DQ-19 were amended by his direction on 2026-10-30, and DQ-23 was added the same day. DQ-28 was added by his direction on 2026-11-01, and DQ-02, DQ-07, DQ-20, DQ-22 and DQ-27 were amended the same day. DQ-29 was decided by the Star Colonel on 2026-11-02, and DQ-02, DQ-05, DQ-10, DQ-18, DQ-21 and DQ-28 were amended the same day.

1. What the panel is for

The WORKBENCH sidebar replaces the built-in panel Running Terminals and Kernels. It lists every workspace of the server, and inside each workspace its tabs, terminals and kernels, then every kernel, terminal and language server that runs on the server. It is built for a user who runs several projects at once: each project is one workspace, told apart by its workspace colour, and the panel shows what the workspace holds, how old it is and what can be shut down.

2. The panel

The panel is a header band over four section bands. One section is open at a time, and the three lab bands sit at the bottom of the panel.

Panel header

Section bands

Workspace card

Rows

The panel as it rendered before DQ-23 docked the three lab bands, with the terminal rows and the tabs counter of DQ-24: this window's card open and a KERNELS row selected, with LANGUAGE SERVERS below the fold. The model below draws the card before DQ-28: DQ-02, DQ-21 and DQ-24 at the time, with the workspace colour as a 14 % wash; DQ-28 replaced that wash with the header shade, and DQ-29 replaced that card with the edge tab, which docs/images/panel-full-window.png shows.

WORKBENCHWORKSPACES(6)2m agodefault158Extension developmentTABS(3)README.mdbrief.mddesign.ipynbTERMINALS(5)nowterminal 7bash2m agoterminal 11claude3h agoterminal 13python312m agoterminal 14claude1d agoterminal 15topKERNELS(1)5m agoidledesign.ipynbnowiconprobe23d agoauto-6KERNELS(2)Shut down all5m agoidledesign.ipynbnowbusyhistory.ipynbPython……/history.ipynb182 MB3%TERMINALS(10)Shut down all
Dark
WORKBENCHWORKSPACES(6)2m agodefault158Extension developmentTABS(3)README.mdbrief.mddesign.ipynbTERMINALS(5)nowterminal 7bash2m agoterminal 11claude3h agoterminal 13python312m agoterminal 14claude1d agoterminal 15topKERNELS(1)5m agoidledesign.ipynbnowiconprobe23d agoauto-6KERNELS(2)Shut down all5m agoidledesign.ipynbnowbusyhistory.ipynbPython……/history.ipynb182 MB3%TERMINALS(10)Shut down all
Light

The card as DQ-02, DQ-21 and DQ-24 left it before DQ-28 and DQ-29

WORKBENCHWORKSPACES(1)default2m agoExtension development125TABS(3)README.mdbrief.mddesign.ipynbTERMINALS(2)1m agoterminal 7bash2m agoterminal 11claudeKERNELS(1)5m agoidledesign.ipynb
Dark, the workspace colour as a 14 % wash over body and header
WORKBENCHWORKSPACES(1)default2m agoExtension development125TABS(3)README.mdbrief.mddesign.ipynbTERMINALS(2)1m agoterminal 7bash2m agoterminal 11claudeKERNELS(1)5m agoidledesign.ipynb
Light, the workspace colour as a 14 % wash over body and header

3. Colours and type

PartSurface tokenFont colourSize and weight
Panel--jp-layout-color1--jp-ui-font-color1--jp-ui-font-size1
Panel header band--jp-layout-color2title --jp-ui-font-color1; glyph --jp-inverse-layout-color3, active --jp-brand-color1title --jp-ui-font-size0, 600, uppercase, 1 px letter spacing; button 24 px with a 14 px glyph
Section band--jp-layout-color2; hover --jp-layout-color3label --jp-ui-font-color1; count and caret --jp-ui-font-color2label --jp-ui-font-size0, 600, uppercase, 1 px letter spacing
Section list--jp-layout-color1empty state --jp-ui-font-color2empty state --jp-ui-font-size0, italic
Band buttonnone at rest; disabled at opacity 0.4--jp-inverse-layout-color3button 22 px square, glyph 14 px: an eraser on WORKSPACES, the power symbol on the three lab bands (DQ-29) the circle outline and one diagonal stroke superseded by DQ-29
Workspace cardedge tab 2 px from the panel's left edge, square at the left with a 2 px right radius; header the hue at 30 % and body the hue at 12 %, both over --jp-layout-color1; 1 px hue rule between them; strip 4 px in the full-strength hue; a plain card's header --jp-layout-color2 and its body --jp-layout-color1 (DQ-29) superseded by DQ-29: body --jp-layout-color1 plain; header in the workspace's muted shade, this window's card the active shade; 1 px --jp-border-color1, 2 px corners; strip 4 px in the same shade; spans the panel width (DQ-28)--
Workspace name---jp-inverse-layout-color0 on a coloured card, --jp-ui-font-color1 on a plain card --jp-ui-font-color1 on a coloured card superseded by DQ-29--jp-ui-font-size1, weight 400
Workspace purpose---jp-inverse-layout-color1 on a coloured card, --jp-ui-font-color2 on a plain card --jp-ui-font-color2 on a coloured card superseded by DQ-29--jp-ui-font-size1, weight 400
Workspace age and counts---jp-inverse-layout-color1 on a coloured card, --jp-ui-font-color2 on a plain card --jp-ui-font-color2 on a coloured card superseded by DQ-29age and a hidden card's word --jp-ui-font-size0 (DQ-21), counts --jp-ui-font-size1 the age at --jp-ui-font-size1 superseded on 2026-11-02
Row--jp-layout-color1, a coloured card's row the hue at 12 % over it; hover and selected --jp-layout-color2, a coloured card's row the hue at 12 % over it (DQ-10) hover and selected --jp-layout-color2 on a coloured card superseded on 2026-11-02name --jp-ui-font-color1; time, status word and detail --jp-ui-font-color2; on a coloured card name --jp-inverse-layout-color0 and the rest --jp-inverse-layout-color1; identifiers --jp-code-font-family, a card row's label the UI font (DQ-18)name --jp-ui-font-size1, weight 400; time and detail --jp-ui-font-size0
Row focus1 px --jp-brand-color1 outline, offset -1px on a section row and a row in a card, offset 1 px on a button; this window's card header -3px--jp-brand-color1, on a coloured card's header, buttons and rows --jp-inverse-layout-color0, :focus-visible only:focus-visible only
Dialog--jp-layout-color1, 2 px cornersprimary text --jp-ui-font-color1--jp-ui-font-size1
Dialog footerone filled --jp-brand-color1; Cancel a surface button on --jp-layout-color1 with a 1 px --jp-border-color1; a destructive action unfilled in --jp-error-color1 at the far left--
Dialog state line--jp-layout-color2 with a 2 px left border in the state colour--jp-ui-font-color1--jp-ui-font-size1
Banner--jp-error-color1 at 15% over the panel, border at 35%--jp-ui-font-color1--jp-ui-font-size1
Destructive menu entry-label and icon --jp-error-color1--jp-ui-font-size1
Workspace coloursrose #f191ae; peach #dfa465; lemon #cbc061; mint #73c973; sky #62c0f5; lavender #be9fe4, one value each on :root, with no theme branch; each mixes over the theme's layout colour (DQ-28, DQ-29) superseded by DQ-29: rose #f1b2c4 (#f191ae active); peach #e5ba90 (#dfa465); lemon #d5cea2 (#cbc061); mint #a7cfa5 (#73c973); sky #98cff2 (#62c0f5); lavender #cebbe7 (#be9fe4), light on :root and dark in one [data-jp-theme-light='false'] block (DQ-28)-stored names unchanged

4. Dialogs

A dialog has one filled button at most, and Cancel is always a surface button. A destructive action is unfilled, with error-coloured text and border, at the far left (DQ-14).

Delete confirmation

Shut-down confirmation

The shut-down confirmation as it renders today: a terminal that another workspace also holds, and the panel's error banner.

Shut down terminal 7?Workspace auto-6 also holds this terminal.Shut downCancelWORKBENCHReload failed: terminals answered 500WORKSPACES(6)The last content stays under the banner
Dark
Shut down terminal 7?Workspace auto-6 also holds this terminal.Shut downCancelWORKBENCHReload failed: terminals answered 500WORKSPACES(6)The last content stays under the banner
Light

Clean-up confirmation

The clean-up confirmation of DQ-22: the count sentence, the list of workspaces with their contents, a destructive Clean up button and Cancel.

Clean up workspacesClean up 3 workspaces? 1 is deleted, default is emptied,and auto-6 is kept because another window shows it.defaultemptiedTabs: docs/README.md, notebooks/design.ipynbTerminals: terminal 7, terminal 11Kernels: Python 3 (design.ipynb)iconprobe2deletedTabs: notebooks/probe.ipynbTerminals: noneKernels: noneauto-6keptTabs: noneTerminals: terminal 1Kernels: noneClean upCancel
Dark
Clean up workspacesClean up 3 workspaces? 1 is deleted, default is emptied,and auto-6 is kept because another window shows it.defaultemptiedTabs: docs/README.md, notebooks/design.ipynbTerminals: terminal 7, terminal 11Kernels: Python 3 (design.ipynb)iconprobe2deletedTabs: notebooks/probe.ipynbTerminals: noneKernels: noneauto-6keptTabs: noneTerminals: terminal 1Kernels: noneClean upCancel
Light

5. Decisions

DQ-01 to DQ-20 were decided by the Star Colonel on 2026-10-28 as the design-system alignment; DQ-21 and DQ-22 on 2026-10-29. DQ-02 and DQ-05 were amended by his 2026-10-30 direction: a card carries its workspace colour as a 14 % wash over the body and the header, and every card and row surface spans the panel width with the text inset as padding. DQ-03 was amended by the same direction to the reference panel's 4 px band padding and its ▾/▸ text caret. DQ-04 and DQ-19 were amended by the same direction: the sections open exclusively, and this window's card paints its outline inside its box. DQ-23 was added the same day and docks the three lab bands at the panel bottom. DQ-28 replaced the 14 % wash with the header shade on 2026-11-01. DQ-29 replaced the card with the edge tab on 2026-11-02, and the refinements measured in Galaxa Dark Theme - Steel the same day amended DQ-02, DQ-05, DQ-10, DQ-18, DQ-21 and DQ-28. Each row states the decision, the design-system rule it adopts and the criteria that govern it.

IdDecisionDesign-system rule it adoptsCriteria
DQ-01Every colour is a --jp-* token, never a literal value; a theme flip changes the same token names, and the extension's CSS has no light or dark branch. The six workspace colours become theme tokens; workspaces stay told apart by colour as far as the tokens allow (table below) the six workspace colours superseded by DQ-27Colour tokens: "Read colour only from lab tokens", "A theme flip overrides the same --jp-* names; no light or dark branch in extension CSS"; design-language Colour choiceACC-PANEL-203-TOKENS-ONLY, ACC-ACCORD-86-OWN-PALETTE, ACC-ACCORD-15-STRIP, ACC-ACCORD-150-COLOUR-SWATCH; rejected ACC-ACCORD-188-STRIP-SATURATION
DQ-02A card is an edge tab (DQ-29): 2 px from the panel's left edge and from the right edge of its list, square at the left with a 2 px right radius. The header carries the workspace hue at 30 % and the body the hue at 12 %, both over --jp-layout-color1, with a 1 px hue rule between them; a workspace with no colour paints the plain surfaces. The 4 px strip is the card's left border in the full-strength hue the 14 % wash superseded by DQ-28 earlier wording, superseded by DQ-29: A card has 2 px corners and a 1 px --jp-border-color1 border; the body is the plain --jp-layout-color1 with no wash, and the header carries the workspace's muted shade, which this window's card replaces with the active shade (DQ-28); a workspace with no colour paints the plain surfaces. The 4 px strip is the card's left border in the same shade and the card's only coloured border; the card has no horizontal margin, so the strip sits at the panel edgeCards & surfaces: "Card: --jp-layout-color1 body plus 1px var(--jp-border-color1)"; Spacing & radius: "Every corner is var(--jp-border-radius) (2px)"; the edge tab of DQ-29 departs from bothACC-PANEL-242-EDGE-TAB, ACC-ACCORD-69-CARD, ACC-ACCORD-128-STRIP-PLAIN, ACC-ACCORD-129-FLUSH, ACC-PANEL-227-FLUSH-WIDTH, ACC-PANEL-239-HEADER-SHADE; superseded ACC-ACCORD-226-CARD-WASH; rejected ACC-ACCORD-125-SELECTED-SHADE
DQ-03A section header is a band on --jp-layout-color2: 4 px above and below the text, the reference panel's content-sized ~24 px band, shorter than the 28 px panel header; the caret is the reference's text glyph, ▾ open and ▸ closed, in a 14 px column in --jp-ui-font-color2 on the 4 px inset, the label 18 px from the edge in weight 600, uppercase, 1 px letter spacing, --jp-ui-font-size0; the count in --jp-ui-font-color2 6 px after the label; hover --jp-layout-color3; no drop shadowSections & headers; the reference panel ../jupyterlab_ai_code_assistants_extension/style/base.css .jp-AiAssistantsPanel-sectionHeader (padding 4px var(--aica-inset)) and .jp-AiAssistantsPanel-caret (14 px in --jp-ui-font-color2), the glyph from src/core/panel.ts _renderSection; Spacing & radius ("In-flow surfaces take depth from layered --jp-layout-color*, never a drop shadow")ACC-PANEL-192-SECTION-TITLES, ACC-PANEL-228-BAND-HEIGHT, ACC-PANEL-74-TEXT-SIZE, ACC-PANEL-80-WS-COUNT, ACC-PANEL-168-COUNT-BRACKETS, ACC-PANEL-152-NARROW-LABELS
DQ-04The four sections open exclusively: at most one is open at a time; opening a collapsed section closes the one that is open; clicking the open section's header closes it and leaves all four closed; WORKSPACES is the default open section; the closed set is saved per panel in localStorage, read and written in try/catch; the focused band draws its focus ring inside the band (offset -1px), so the ring shows whole at the panel edge and no z-index rule is neededSections and scroll: "sections open exclusively, one at a time"; Sections & headers: "The state is saved per panel in localStorage"; WORKSPACES as the default open section is the Star Colonel's 2026-10-30 directionACC-PANEL-182-SECTION-HEADS, ACC-PANEL-208-SECTION-STORE, ACC-PANEL-8-POLL, ACC-PANEL-229-EXCLUSIVE; rejected ACC-PANEL-137-OTHERS-CLOSED
DQ-05Each section's list is its own scroll container (overflow-y: auto; min-height: 0), its header sticks at the top (position: sticky; top: 0), and it reserves no scrollbar strip (scrollbar-gutter: auto), so a card stands 2 px from both sides of the list. When a list overflows, its scrollbar takes its width and the cards narrow by that width. Never two scroll containers on one axis; every section row spans the panel width with the text inset as padding, and a card stands 2 px inside that width (DQ-29) earlier wording, superseded by this amendment on 2026-11-02: Each section's list is its own scroll container (overflow-y: auto; min-height: 0), its header sticks at the top (position: sticky; top: 0), scrollbar-gutter: stable as the reference panel keeps it, height clamp(5 rows, 33vh, 10 rows); never two scroll containers on one axis; every card and row surface spans the panel width with the text inset as paddingPanel construction, Sections and scrollACC-PANEL-90-SCROLL, ACC-PANEL-227-FLUSH-WIDTH, ACC-PANEL-8-POLL
DQ-06The panel header is a band 24 to 30 px tall on --jp-layout-color2; the title WORKBENCH is weight 600, uppercase, 1 px letter spacing, --jp-ui-font-size0Sections & headers: "Header 24-30px on --jp-layout-color2"; Panel construction, HeaderACC-PANEL-201-HEADER-BAND, ACC-PANEL-152-NARROW-LABELS
DQ-07The root and primary text are --jp-ui-font-color1; meta text, counts, a section caret, a plain card's caret and empty states are --jp-ui-font-color2. The 4.5:1 contrast floor of section 4 goes. One exception: on a coloured card header the name, the age, the counts, the purpose and the caret keep --jp-ui-font-color1, so the shade costs no contrast (DQ-28) the --jp-ui-font-color1 on a coloured card header superseded by DQ-29Panel construction, Theme contract and RootACC-PANEL-202-TEXT-COLOURS, ACC-PANEL-239-HEADER-SHADE; rejected ACC-PANEL-73-TEXT-CONTRAST
DQ-08An empty state is italic, --jp-ui-font-color2, --jp-ui-font-size0Panel construction, Rows (empty state)ACC-PANEL-75-NO-ITALIC, ACC-PANEL-74-TEXT-SIZE
DQ-09Ages read now, Nm ago, Nh ago, Nd ago, Nmo ago, Ny ago, and never without a time. Under 60 s the name and the time are --jp-brand-color1 with jp-mod-recentlyActive; over 7 days the row label alone is at opacity 0.65 with jp-mod-stale, and the card name keeps full opacity. The brand colour 2 dot before "now" goesLists & rows, Recency emphasis and Time labelsACC-ACCORD-20-AGE, ACC-ACCORD-130-NOW-DOT
DQ-10A hovered or selected row in a coloured card is the card hue at 12 % over --jp-layout-color2, so the row keeps the card's hue, and a stale label there takes full opacity; in a plain card and a section both are --jp-layout-color2; there is no veil of the text colour earlier wording, superseded for a coloured card by this amendment on 2026-11-02: A hovered row is --jp-layout-color2, with no veil of the text colour; a selected row is --jp-layout-color2Panel construction, Theme contract ("Header, band, hover"); Lists & rows ("selected on layout-color2"), which a coloured card's row departs fromACC-LISTS-211-ROW-HOVER, ACC-LISTS-210-ROW-SELECT, ACC-PANEL-249-CONTRAST
DQ-11Delete workspace draws label and icon in --jp-error-color1 at rest and while selected, through a danger class in its command's className; armed it reads Confirm delete with jp-mod-confirm in --jp-error-color1. The row entries Shut down terminal and Shut down kernel are destructive entries toodesign-language Destructive menu entry and Two-step destructive action; Dialogs & popups build notesACC-ACCORD-148-MENU-ICONS, ACC-ACCORD-155-ARMED-COLOUR, ACC-LISTS-212-DANGER-ENTRIES
DQ-12The card header counts as a header: every header and toolbar icon keeps its place on every view; an icon that does not apply is disabled, never removed. Open workspace, Close all tabs, the eye and ... show on every card at all timesdesign-language Header icons never hide between views; Panel construction, Icon states (Disabled: "Glyph holds its place")ACC-ACCORD-98-HOVER-ACTIONS, ACC-HIDDEN-213-EYE-TOGGLE, ACC-PANEL-214-HEADER-PLACE, ACC-ACCORD-167-NO-BUTTONS; rejected ACC-ACCORD-153-HOVER-NAME
DQ-13A status dot has its word in the line, in the title and in the aria-label, kernel rows in cards includedBadges & indicators ("Colour never carries meaning alone"); icon inventory, status dotACC-KERNEL-49-STATE, ACC-KERNEL-48-ROW
DQ-14In the New workspace, Set description and shutdown dialogs the affirmative action is the only filled button; Cancel is the surface button; a destructive action is unfilled with error-coloured text and border at the far left; the focus rim shows for keyboard focus onlydesign-language One-primary dialog footer; references/dialog-controls.md, footer classesACC-PANEL-204-DIALOG-FOOTER
DQ-15An inline panel message is a banner: color-mix(in srgb, var(--jp-error-color1) 15%, transparent) background and a border of the same token at 35 percent. A state line in a dialog has padding 6px 12px on --jp-layout-color2 with a 2 px left border in the state colour. The error-colour dot of section 5 goesBanners; design-language Dialog status accent lineACC-PANEL-96-LOAD-ERROR, ACC-PANEL-205-DIALOG-STATE
DQ-16A header button draws a 14 px glyph in a 24 px button; the card header's buttons as well, since the card header counts as a headerPanel construction, Header ("actions 24x24, glyph 14x14"); Icons ("14px in buttons")ACC-PANEL-147-HEADER-ORDER, ACC-PANEL-214-HEADER-PLACE
DQ-17Every row, KERNELS rows included, carries only a status dot, a name and a time; everything else - the terminal's process, the kernel type, the document, memory and CPU, a card's purpose and counts - appears on selection. Replaces the 2026-10-26 requirement that KERNELS rows show memory and CPU in the row the terminal's process superseded by DQ-24Side panel: "Default rows carry only a status dot, name and time; everything else appears on selection"ACC-LISTS-209-ROW-LINE, ACC-LISTS-210-ROW-SELECT, ACC-TERM-42-PROCESS, ACC-TERM-44-PROCESS-UNREAD, ACC-TERM-46-NAME, ACC-TERM-113-PROCESS-LIVE, ACC-KERNEL-48-ROW, ACC-KERNEL-156-DISPLAY-NAME, ACC-KERNEL-196-KERNEL-DETAILS, ACC-ACCORD-18-PURPOSE, ACC-ACCORD-22-COUNTS, ACC-ACCORD-70-COUNT-TABS, ACC-ACCORD-99-PURPOSE-DIALOG, ACC-PANEL-181-PURPOSE-WRAP, ACC-LISTS-154-TAB-SHRINK, ACC-DOCS-186-SHOT-CURRENT, ACC-PANEL-157-OTHERS-ACTIONS, ACC-LISTS-109-CONSOLE, ACC-ACCORD-97-ELLIPSIS, ACC-KERNEL-151-ROW-CLICK, ACC-LISTS-104-ROW-MENU
DQ-18Identifiers - the terminal names of the TERMINALS section, kernel ids, paths - are set in --jp-code-font-family. A card row's label is in the UI font, a terminal's included, because a card lists tabs marked by type and the icon and the word terminal already mark it earlier wording, superseded for a card row by this amendment on 2026-11-02: Identifiers - terminal names, kernel ids, paths - are set in --jp-code-font-familyPanel construction, Rows ("identifiers --jp-code-font-family")ACC-PANEL-206-CODE-FONT
DQ-19The focus outline sits 1 px outside the element, and 1 px inside it only within cards, where the card clips its content. On a coloured card header the ring takes --jp-ui-font-color1, because the brand ring falls under 3:1 on the shade; every other focus ring keeps --jp-brand-color1. This window's card paints its 2 px --jp-brand-color2 outline inside its own box (outline-offset: -2px), so the flush card loses no band to the section body's clip the outside focus outline of a section band and a section row superseded by DQ-26 the --jp-ui-font-color1 ring on a coloured card header superseded by DQ-29Panel construction, Icon states (Focus: "1px --jp-brand-color1 outline, offset 1px, :focus-visible only"); DQ-02's flush card, whose section body overflow clips anything drawn outside its boxACC-PANEL-93-FOCUS, ACC-PANEL-231-OUTLINE-INSIDE
DQ-20Shut down all on the KERNELS, TERMINALS and LANGUAGE SERVERS bands is a clear-console icon button: clearIcon from the extension's src/icons.ts, a circle outline with one diagonal stroke as the Clear console glyph of the Chrome developer tools, 22 px square with a 14 px glyph in --jp-inverse-layout-color3, no background and no border at rest, its accessible name Shut down all in aria-label and title, the band's height unchanged. Disabled it keeps that look at opacity 0.4. The error colour stays off the button at rest, because the design system gives it to destructive menu entries and to dialog actions, and this button opens the confirmation dialog the clear-console glyph superseded by DQ-29Panel construction, Icon states (Inactive: glyph --jp-inverse-layout-color3; Disabled: opacity 0.4, cursor default, glyph holds its place; Focus: 1 px --jp-brand-color1 outline at offset 1 px); Icons ("14px in buttons"); design-language Destructive menu entryACC-PANEL-157-OTHERS-ACTIONS, ACC-LISTS-110-SHUTDOWN-ALL, ACC-PANEL-240-CLEAR-CONSOLE
KERN-02Where a KERNELS row shows its document, a long file name shows whole at a 300 px panel, and the kernel type and the folder give way first. Replaces the 2026-10-26 shrink order "Type keeps a minimum"Panel construction, Rows ("only the text span ellipsises")ACC-KERNEL-196-KERNEL-DETAILS, ACC-LISTS-154-TAB-SHRINK
OPT-1The terminals route leaves out a terminal whose pty has ended (pty.ptyproc.terminated, or not isalive()). This replaces the panel's map of shut-down terminals, the route's fingerprint cache, fingerprint() and the fingerprint field; the row of a shut-down terminal leaves at the panel's next load in every windowdesign-language Timing independenceACC-TERM-200-ROW-LEAVES
OPT-2iconButton stops the propagation of Enter and Space only, so the arrow keys reach the row from a button inside itPanel construction, Rows ("one tab stop per section, roving tabindex")ACC-PANEL-207-BUTTON-ARROWS, ACC-LISTS-104-ROW-MENU
DQ-21Rows are neutral, as the share files extension draws them: its item name is --jp-ui-font-size1 in --jp-ui-font-color1 with no weight rule, its meta is --jp-ui-font-size0 in --jp-ui-font-color2, its row hover is --jp-layout-color2, and the only brand colour on a row is the focus ring. The workspace name is --jp-ui-font-size1 at normal weight in --jp-ui-font-color1; the purpose is --jp-ui-font-color2; recency is carried by the time label alone. This holds for a section row and a plain card; a coloured card takes the inverse-token ink and focus ring of DQ-29 and the row surface of DQ-10. The age in a card header and a hidden card's word are meta text at --jp-ui-font-size0, as a row's time is, so the name keeps that width. DQ-21 supersedes the colour clause of DQ-09 and nothing else of DQ-09 the neutral row on a coloured card superseded by DQ-29; the header age at the name's size superseded on 2026-11-02Lists & rows, Recency emphasis and Time labels; the share files extension's row (../jupyterlab_share_files_extension/style/base.css)ACC-ACCORD-20-AGE, ACC-ACCORD-130-NOW-DOT, ACC-PANEL-74-TEXT-SIZE
DQ-22The WORKSPACES band carries the same clear-console button as the three bands below it, named Clean up workspaces. It deletes every workspace except the one this window shows, closing their tabs; it keeps this window's workspace and empties it, closing its tabs and shutting down its kernels, terminals and language servers; a workspace another window shows is kept and named as kept; and nothing happens without a confirmation that lists, for every workspace, its name and what it holds - the tabs by path, the terminals and kernels by name. The button is disabled when there is nothing to clean the clear-console glyph superseded by DQ-29Icons (14 px in buttons); Panel construction, Icon states (Inactive and Disabled); design-language Destructive menu entry, Dialog status accent line and One-primary dialog footerACC-ACCORD-221-CLEAN-BUTTON, ACC-ACCORD-222-CLEAN-DIALOG, ACC-ACCORD-223-CLEAN-ACTION, ACC-PANEL-240-CLEAR-CONSOLE
DQ-23The panel body is one flex column of fixed height. KERNELS, TERMINALS and LANGUAGE SERVERS keep their DOM order after WORKSPACES and never scroll out of view; nothing renders below the LANGUAGE SERVERS band. The open section takes the height left between the panel header and the collapsed bands (flex: 1 1 auto; min-height: 0) and its body is the only scroll container; a collapsed section keeps only its band. When WORKSPACES is open its list fills that height with no row cap; an open lab section fills the same height with its rows. While a section is open no empty strip of panel background stands above the docked bands; with all four sections closed no section grows, so the free height stands between the WORKSPACES band and the docked lab bands, which an auto margin on the KERNELS band absorbs. The reserved scrollbar gutter stands. This row replaces the height and sticky-header clauses of DQ-05 and ACC-PANEL-90-SCROLL the reserved scrollbar gutter superseded by DQ-05 on 2026-11-02Sections and scroll: "one scroll container per section (overflow-y:auto; min-height:0)", "scrollbar-gutter: stable"; the docked bands and the flex height are the Star Colonel's 2026-10-30 directionACC-PANEL-230-DOCKED-BANDS, ACC-PANEL-232-ROW-CAP, ACC-PANEL-8-POLL
DQ-24A terminal row, in a card and in the TERMINALS section, always shows its name, its process name and its time, with no selection needed: terminal 1 claude now. The process text is --jp-ui-font-color2 and reuses the row's detail styling; selecting the row does not show it a second time; the tooltip stays; with no process known the row shows no placeholder; at a narrow width the process gives way first with an ellipsis, and the name and the time stay whole. Every other kind of row keeps DQ-17; DQ-24 supersedes the terminal's process clause of DQ-17 and nothing else of DQ-17. The card's tabs counter counts every tab open in the workspace, documents and terminals: 6 terminal tabs and no document show 6, and a terminal key in a saved layout whose terminal no longer runs does not count. The terminal and kernel counters and the groups TABS (N) and TERMINALS (N) stay, so no row is listed twice. The TABS column of workspaces list follows the same rule, and tabs list also prints the terminal tabs, with key terminal:N and an empty PATH. The Star Colonel's words, 2026-10-31: "critical defect - terminals do not have process name in them (only in tooltip) , there are 6 tabs opened - workspace shows exactly zero" the groups TABS (N) and TERMINALS (N) superseded by DQ-29The brief, Terminals: "Each terminal shows the name of the process running in it", "essentially the same thing as tab name"; the counter and the command-line rule are the Star Colonel's 2026-10-31 directionACC-TERM-42-PROCESS, ACC-TERM-44-PROCESS-UNREAD, ACC-TERM-46-NAME, ACC-TERM-113-PROCESS-LIVE, ACC-TERM-236-PROCESS-NARROW, ACC-LISTS-209-ROW-LINE, ACC-LISTS-210-ROW-SELECT, ACC-ACCORD-70-COUNT-TABS, ACC-CLI-171-LIST-OUT, ACC-CLI-218-TABS-LIST
DQ-25Each open tab gets its own count and row in the window that holds it, so an editor plus its Markdown preview shows 2 in the card and in the CLI. Two New View tabs of one document are two open tabs: two rows and a count of 2 in the window that holds them; a click and Close tab act on that row's own tab, and closing one view of an unsaved document behaves as JupyterLab's own close does, so only the last view that can edit asks. The CLI reads only the saved layout, so a tab JupyterLab does not restore, such as the Launcher or a second New View of a document, counts only in the card of the window that holds it. DQ-25 replaces the expected behaviour of DEF-PANEL-10-SHARED-VIEW. The Star Colonel's word, 2026-10-31, offered "Fix the code" and "Keep the code, state the limit": "Fix the code"The Star Colonel's 2026-10-31 decision on the difference between the card and the CLI that verify round 2 of the critical defect foundACC-ACCORD-70-COUNT-TABS, ACC-CLI-171-LIST-OUT
DQ-26Every section band's left and right equal the panel's, as the title band's do, at every width and whichever section is open. The section list has no side padding; text and icons stay where they are, because the inset is padding inside each surface, and the title label and the section labels stay on one vertical line. A section band and a section row draw their keyboard focus ring inside the surface (outline-offset: -1px), so it shows whole at the panel edge. Every section band has one 1 px --jp-border-color3 divider before and after it, the WORKSPACES band included, whichever section is open; with the filter field showing, the divider sits between the field and the WORKSPACES band; no other gap, margin or line stands between sections. The scrollbar gutter stays, and KERNELS, TERMINALS and LANGUAGE SERVERS stay docked at the panel bottom. DQ-26 supersedes the outside focus outline of DQ-19 for a section band and a section row and nothing else of DQ-19; this window's card keeps its inside outline. A row in this window's card draws its ring at outline-offset: -1px, as a row in any other card does, and the row ends 2 px short of the card's right edge, at the inner edge of the card's 2 px outline, which would paint over the right side of the ring and does not count as a side of it: the card's 1 px right border gives 1 px, margin-right: 1px the other, and the right padding falls from 10 px to 9 px, so no content moves. That card's header keeps its ring 2 px further in (outline-offset: -3px); on a row that offset crosses the file icon, which starts at the row's top (DEF-PANEL-72-RING-ROW). The defect is DEF-PANEL-70-BAND-SPAN. The Star Colonel's words, 2026-10-31: "tell me the difference; how is it that they don't span how they should" and "alos make the every section have this little spacing between previous / next"; his crop's arrows point at the 1 px lines between KERNELS, TERMINALS and LANGUAGE SERVERS, so "this little spacing" is that divider and not a new gap the scrollbar gutter superseded by DQ-05 on 2026-11-02design-language Full-width surfaces in a docked panel: "a panel's section bands and its rows and cards span the panel edge to edge"; the share files extension's section header (../jupyterlab_share_files_extension/style/base.css, outline-offset: -1px); the divider is the Star Colonel's 2026-10-31 directionACC-PANEL-192-SECTION-TITLES, ACC-PANEL-93-FOCUS, ACC-PANEL-237-SECTION-DIVIDER
DQ-27The six workspace colours are the coloured tabs palette's default light-theme active shades, in both themes, with no theme branch: rose #e39fb1, peach #d2ab82, lemon #bab56d, mint #87c086, sky #77bae0, lavender #bfa9da. The palette's dark-theme shades have contrast 1.00 to 1.33 on the panel colour #333840, so a 4 px strip or a 14 % wash in them cannot be seen; these have about 5.5, and all six read apart. The coloured tabs extension's own CSS variables cannot be used, because they switch to the dark shades in a dark theme, so the extension's stylesheet states each value once, and a palette edited in the coloured tabs settings is not followed. Besides the black of the recessed filter field these six are the only literal colours in the panel, and every other colour stays a token. The stored colour names, the records, the rotation, the 4 px strip at full strength, the 14 % wash and the swatch shape stay. The Colour submenu reads Yellow for lemon and Purple for lavender, the names the Tab Colour menu gives them, in place of Amber and Cyan, the hues of the tokens. DQ-27 supersedes the six workspace colours of DQ-01 and nothing else of DQ-01. The defect is DEF-PANEL-71-TAB-PALETTE. The Star Colonel's words, 2026-10-31: "also why colours aren't the smae as in coloured tabs colours? you have invented different colours". Asked to choose, he replied "work on all please" without naming an option, so the orchestrator took the option it had recommended the six values superseded by DQ-28The brief: "a coloured strip on the edge of the section (a tab colour placed on the side)", "the tab colour palettes the workspace colours resemble"; the palette default in ../jupyterlab_colourful_tab_extension/schema/plugin.json and that extension's style/base.css. For these six values alone it departs from Colour tokens: "Read colour only from lab tokens"ACC-ACCORD-238-PALETTE-SHADES, ACC-PANEL-203-TOKENS-ONLY, ACC-ACCORD-86-OWN-PALETTE, ACC-ACCORD-15-STRIP, ACC-ACCORD-150-COLOUR-SWATCH, ACC-ACCORD-226-CARD-WASH
DQ-28The six workspace hues are the extension's own palette, derived from the coloured tabs extension's default palette at 1.4 saturation, with rose 2 degrees pinker, peach 3 points darker, lemon 1 point lighter and 2 degrees cooler, and mint 2 points darker, so rose and peach stop reading as one pair: rose #f191ae, peach #dfa465, lemon #cbc061, mint #73c973, sky #62c0f5 and lavender #be9fe4. Each stands once on :root, with no theme branch. A card mixes its hue at 30 % for the header and 12 % for the body over --jp-layout-color1, so each theme sets its own tints, and paints the full hue on its 4 px strip and its 1 px rule; this window's card paints the same (DQ-29). A palette edited in the coloured tabs settings is not followed. DQ-28 supersedes the six values of DQ-27 and the wash of DQ-02 and nothing else of either earlier wording, superseded by DQ-29: The six workspace colours are the extension's own palette, derived from the coloured tabs extension's default palette at 1.4 saturation, with rose 2 degrees pinker, peach 3 points darker, lemon 1 point lighter and 2 degrees cooler, and mint 2 points darker, so rose and peach stop reading as one pair. The muted shade paints a card's header and its 4 px strip; this window's card paints the active shade. The light values stand on :root and the dark values in one [data-jp-theme-light='false'] block, the stylesheet's only theme branch. A palette edited in the coloured tabs settings is not followed. The card body stays the plain --jp-layout-color1, with no wash. On a coloured card header the name, the age, the counts, the purpose and the caret keep --jp-ui-font-color1, so the shade costs no contrast. Rose #f1b2c4 and #f191ae on #542b36 and #3f1e26; peach #e5ba90 and #dfa465 on #4a3827 and #342a1d; lemon #d5cea2 and #cbc061 on #57512e and #423e23; mint #a7cfa5 and #73c973 on #294d30 and #1d3924; sky #98cff2 and #62c0f5 on #213854 and #182a3d; lavender #cebbe7 and #be9fe4 on #402c54 and #30213e, each a muted and an active value. DQ-28 supersedes the six values of DQ-27 and the wash of DQ-02 and nothing else of eitherThe coloured tabs extension's scheme: its default palette in ../jupyterlab_colourful_tab_extension/schema/plugin.json and style/base.css, and the tuned third block of tmp/colour-design/index.html. The Star Colonel's words, 2026-11-01: the colourful tabs extension "does an excellent job at showing colours and the selected tab", then "slightly more saturated" and "peach and rose are too similar". For these six values alone it departs from Colour tokens: "Read colour only from lab tokens"ACC-PANEL-239-HEADER-SHADE, ACC-ACCORD-86-OWN-PALETTE, ACC-PANEL-203-TOKENS-ONLY, ACC-ACCORD-15-STRIP, ACC-ACCORD-150-COLOUR-SWATCH
DQ-29The workspace card is the edge tab of proposition 1, the Edge card of the ten edge-tab propositions, decided by the Star Colonel on 2026-11-02 after he rejected the 0.8.31 card. The card stands 2 px from the panel's left edge, square at the left with a 2 px right radius; the header carries the workspace hue at 30 % and the body the hue at 12 %, both over --jp-layout-color1; a 4 px full-strength hue strip runs down the left edge and a 1 px hue rule joins header and body. Every icon stays: the header keeps the triangle, the name, the age and the four action glyphs, and its second line carries the purpose and the tab, terminal and kernel counts with their glyphs. An open card lists one flat tab list with no TABS, TERMINALS or KERNELS group label: a terminal is a row with its glyph and process, a kernel rides on its document's row with its state word, dot and time, and the row menu carries Close tab, Stop terminal and Shut down kernel. The KERNELS, TERMINALS and LANGUAGE SERVERS tally sections stay with their counts and Shut down all, so a background terminal or a headless kernel stays visible and can be shut down. The WORKSPACES band draws an eraser and the three tally bands a power glyph. On a coloured card the ink is the inverse tokens: --jp-inverse-layout-color0 for the name, the row labels, the triangle, the glyphs and the focus ring, and --jp-inverse-layout-color1 for the age, the counts, the purpose and a row's time, state word, process and detail, because --jp-ui-font-color1 measures 4.82:1 on the Galaxa Steel base and 2.60:1 on a 30 % lemon tint, while the inverse tokens keep at least 6.40:1 on every 30 % tint. A plain card, the tally sections, menus and dialogs keep font colours 1 and 2. DQ-29 supersedes the card shape and the plain body of DQ-02, the glyphs of DQ-20 and DQ-22, the group labels of DQ-24, the shades of DQ-28 and the coloured-header ink of DQ-07, DQ-19 and DQ-28, and nothing else of those rowsThe Star Colonel's choice from the propositions page tmp/edge-tabs-design/index.html. Colour tokens: "Read colour only from lab tokens", for the ink and for the layout colour under each mix. It departs from Cards & surfaces: "Card: --jp-layout-color1 body plus 1px var(--jp-border-color1)" and Spacing & radius: "Every corner is var(--jp-border-radius) (2px)"ACC-PANEL-242-EDGE-TAB, ACC-PANEL-243-HEADER, ACC-PANEL-244-TAB-ROWS, ACC-PANEL-245-ROW-MENU, ACC-PANEL-246-TALLY, ACC-PANEL-247-ICONS, ACC-PANEL-248-COUNTS, ACC-PANEL-249-CONTRAST; defects DEF-PANEL-74-EDGE-TABS, DEF-PANEL-75-ERASER-INK

How this design reads the decisions

Each point below is a reading this stage made where a decision left a detail open. Each is stated in the criteria named and can be changed there.