diff --git a/DESIGN.md b/DESIGN.md
index 60021b55..0c6e724b 100644
--- a/DESIGN.md
+++ b/DESIGN.md
@@ -11,50 +11,50 @@ colors:
warm-graphite: "oklch(26.78% 0.0097 355.6)"
muted-graphite: "oklch(51.33% 0.0088 345.6)"
quiet-border: "oklch(90.93% 0.0035 354.7)"
- success-mint: "oklch(75.77% 0.1581 165)"
+ success-mint: "oklch(46% 0.095 160)"
navigation-active: "oklch(92.5% 0.052 23.2)"
navigation-active-hover: "oklch(89.5% 0.071 23.2)"
navigation-active-foreground: "oklch(36.5% 0.11 23.2)"
navigation-active-border: "oklch(60% 0.135 23.2)"
- warning-amber: "oklch(85.23% 0.1386 78.9)"
- information-blue: "oklch(70.35% 0.1128 221.3)"
+ warning-amber: "oklch(48% 0.09 70)"
+ information-neutral: "oklch(51.33% 0.0088 345.6)"
typography:
display:
- fontFamily: "Fraunces, Source Serif Pro, Georgia, Times New Roman, serif"
- fontSize: "3rem"
+ fontFamily: "Manrope Variable, Manrope, system-ui, sans-serif"
+ fontSize: "1.5rem"
fontWeight: 600
lineHeight: 1.03
letterSpacing: "-0.025em"
headline:
- fontFamily: "Fraunces, Source Serif Pro, Georgia, Times New Roman, serif"
- fontSize: "1.875rem"
+ fontFamily: "Manrope Variable, Manrope, system-ui, sans-serif"
+ fontSize: "1.5rem"
fontWeight: 600
lineHeight: 1.15
letterSpacing: "-0.015em"
title:
- fontFamily: "Fraunces, Source Serif Pro, Georgia, Times New Roman, serif"
- fontSize: "1.2rem"
+ fontFamily: "Manrope Variable, Manrope, system-ui, sans-serif"
+ fontSize: "1.25rem"
fontWeight: 600
lineHeight: 1.25
letterSpacing: "-0.01em"
body:
- fontFamily: "Manrope, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, Arial, sans-serif"
- fontSize: "0.9375rem"
+ fontFamily: "Manrope Variable, Manrope, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, Arial, sans-serif"
+ fontSize: "1rem"
fontWeight: 400
lineHeight: 1.65
letterSpacing: "normal"
control:
- fontFamily: "Manrope, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, Arial, sans-serif"
+ fontFamily: "Manrope Variable, Manrope, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, Arial, sans-serif"
fontSize: "0.875rem"
fontWeight: 600
lineHeight: 1.25
letterSpacing: "0.005em"
label:
- fontFamily: "ui-monospace, SF Mono, Cascadia Code, Menlo, Consolas, monospace"
- fontSize: "0.6875rem"
+ fontFamily: "Manrope Variable, Manrope, system-ui, sans-serif"
+ fontSize: "0.75rem"
fontWeight: 600
lineHeight: 1.25
- letterSpacing: "0.06em"
+ letterSpacing: "normal"
rounded:
xs: "4px"
sm: "6px"
@@ -113,6 +113,16 @@ components:
# Design System: ThothII
+## Visual review branch, September 2026
+
+The revision on `codex/ui-visual-review` is approved for implementation and Docker visual review,
+not yet for adoption on `main`. The previous look remains recoverable from the base commit and
+the preserved Docker image. Historical prototypes must remain untouched.
+
+This revision follows Impeccable's product register: one locally bundled Manrope family for the
+whole UI, five fixed size roles, red as the sole brand accent and additional color only for meaningful
+state. The primary scene remains an analyst reading data and SQL in a well-lit office.
+
## Overview
**Creative North Star: "The Clinical Workbench"**
@@ -134,7 +144,7 @@ disciplined and tactile, never playful, sluggish, or visually unstable.
**Key Characteristics:**
- Warm, restrained surfaces with one scarce red accent.
-- Editorial headings paired with highly legible operational body text.
+- One sans-serif family, with hierarchy expressed through size, weight and spacing.
- Dense information organized through hierarchy, rhythm, and progressive disclosure.
- Persisted artifacts and reviewer decisions presented as the visual source of truth.
- Fast state feedback with reduced-motion parity.
@@ -178,7 +188,8 @@ frontend uses OKLCH tokens directly.
foreground. It shares Instrument Red's hue but uses a lighter, lower-chroma fill, so location is
visible without carrying the full weight of a primary action.
- **Warning Amber** (`warning-amber`): waiting, attention, and in-progress states.
-- **Information Blue** (`information-blue`): informational state when red would imply action.
+- **Information**: neutral text and indicators for dates, protocols and ordinary status. The legacy
+ `--info` token resolves to muted foreground, not an additional blue accent.
The dark theme keeps the same semantic mapping with neutral near-black surfaces and a slightly
lighter red accent. Do not introduce a second visual identity for dark mode.
@@ -191,30 +202,33 @@ for their named states. Color is never the only state indicator.
## Typography
-**Display Font:** Fraunces, with Source Serif Pro, Georgia, and Times New Roman fallbacks
-**Body Font:** Manrope, with native system sans-serif fallbacks
-**Label/Mono Font:** SF Mono or Cascadia Code, with Menlo and Consolas fallbacks
+**UI Font:** locally bundled Manrope Variable, with Manrope and native sans-serif fallbacks.
+**Technical Font:** SF Mono or Cascadia Code, with Menlo and Consolas fallbacks.
-**Character:** Fraunces gives persisted artifacts and key headings editorial authority. Manrope
-keeps dense controls and prose calm and readable. The mono register separates machine identity,
-metadata, SQL, identifiers, and micro-labels from natural-language content.
+Manrope covers headings, labels, controls, navigation and document reading. Monospace is reserved
+for SQL, code, paths and machine identifiers, never for ordinary UI labels or status headings.
### Hierarchy
-- **Display** (600, `3rem`, `1.03`): authentication and exceptional page-level statements only.
-- **Headline** (600, `1.875rem`, `1.15`): major page or artifact titles.
-- **Title** (600, `1.2rem`, `1.25`): panel and document section hierarchy.
-- **Body** (400, `0.9375rem`, `1.65`): operational prose, with a target line length of 65 to 75
+- **Headline** (600, `1.5rem`, `1.3`): page or artifact titles, `--text-page`.
+- **Title** (600, `1.25rem`, `1.4`): section hierarchy, `--text-section`.
+- **Body** (400, `1rem`, `1.6`): operational prose, `--text-body`, with a target line length of 65 to 75
characters where the surface controls width.
-- **Control** (600, `0.875rem`, `1.25`): buttons, inputs, tabs, and compact actions.
-- **Label** (600, `0.6875rem`, `0.06em` tracking): uppercase micro-labels, state metadata, and panel
- headers. Labels use the mono family.
+- **Control** (400–600, `0.875rem`, `1.5`): buttons, inputs, tables, tabs and compact subheadings,
+ `--text-control`.
+- **Metadata** (400–600, `0.75rem`, `1.5`): secondary status, counts and timestamps, `--text-meta`.
+ Labels use sentence case and normal tracking. Ordinary operational text never falls below 12px.
Typography uses fixed sizes. Responsive changes happen at structural breakpoints, not through fluid
type scaling. Numeric data and identifiers use tabular numerals where comparison matters.
-**The Three Registers Rule.** Serif means authority, sans means interaction and reading, mono means
-machine identity. Do not exchange these roles for novelty.
+**Application wordmark:** ThothII is a brand mark, not a page title: use Manrope semibold at
+48px (`3rem`) in the Core welcome area and 32px (`2rem`) in the session sidebar, with the
+`II` suffix in brand red. Preserve these sizes across responsive layouts.
+
+**The One Family Rule.** The UI and document readers use sans-serif throughout. The legacy
+`--font-heading` alias resolves to `--font-sans`. Preserve technical monospace without turning it
+into a second decorative hierarchy. Do not shrink text to solve layout constraints.
**The Read Once Rule.** A heading, label, and body must be distinguishable on first glance through
size and weight. Do not repeat headings in explanatory copy.
@@ -279,25 +293,26 @@ default, hover, focus, active, disabled, loading, and error behavior where those
- **Focus:** three-pixel Instrument Red ring with a clear border shift.
- **Error / Disabled:** errors combine destructive color with explanatory text; disabled controls
retain readable contrast and use 50 percent opacity.
-- **Metadata catalog model:** Database Management keeps one compact, installation-level
- metadata-generation LLM selector in the application header. The selection persists across
- database, table, column, and relationship views; when no usable profile is configured, the
- disabled control explains: “No metadata-generation LLM model is configured for this installation.”
+- **Global context:** the collapsible top shelf is the sole workspace/model selector for Core and
+ Admin. Preserve independent remembered choices, installation defaults, operation locks and unsaved
+ edit guards. Never introduce a separate metadata-generation default or selector.
### Navigation
- **Style:** compact session rows use `8px` corners and restrained vertical padding.
- **Default / Hover / Active:** porcelain at rest, Sunken Surface on hover, and a muted Navigation
Active red with a defined border when current. Exactly one top-level navigation control is current.
-- **Administrative controls:** the admin-only Administration accordion groups Database management,
- Memory management, Evidence management, a structural divider, Workspace management, and Pi
- management in that order. Its trigger exposes
+- **Administrative controls:** the admin-only Administration accordion groups Database,
+ Memory, Evidence, a structural divider, Workspace, and Pi configuration in that order. Its trigger exposes
expanded state and starts collapsed by default, while non-admin users do not receive the accordion
or its navigation actions.
- **Responsive:** collapse navigation structurally at the application breakpoint. Do not shrink
labels into illegibility. Below 768px, Memory and Evidence management use the full content
width; a Navigation button opens the shared accessible dialog. Selecting another archive
- page or pressing Escape closes it. Desktop retains the session sidebar.
+ page or pressing Escape closes it. Desktop retains the right session sidebar and its My sessions /
+ All sessions tabs. Core retains question/answer, eight phases, reviewer gates and the left log.
+ The portal owns the red header and left sidebar; ThothII must not duplicate them. Size to the
+ actual application container. Narrow session document panels may use the available width.
### Tabs
@@ -347,7 +362,8 @@ paths with copy controls, never browser file links to container-only locations.
- **Do** preserve information density with headings, rhythm, and progressive disclosure.
- **Do** keep keyboard focus explicit and pair color with text, shape, icon, or position.
- **Do** respect `prefers-reduced-motion` while preserving immediate non-kinetic feedback.
-- **Do** use English for interface chrome and the workspace language for persisted document content.
+- **Do** use the selected interface language (English by default) for chrome and preserve the
+ workspace language for persisted domain content. Session interaction language remains pinned.
- **Do** render curated metadata and scope as Markdown prose or lists, never as a frontmatter table.
- **Do** break long curated rules into paragraphs, labelled subsections, and lists at existing
punctuation boundaries while preserving the exact canonical text for machines.
diff --git a/PROJECT_STATE.md b/PROJECT_STATE.md
index 6c6d3a95..e1c88317 100644
--- a/PROJECT_STATE.md
+++ b/PROJECT_STATE.md
@@ -26,13 +26,37 @@ independent reviews, local browser checks and rollback details.
## Current product shape
+### Visual review integrated with the full/embedded shell
+
+At the owner's request, the seven commits through `a59624a6` from
+`codex/ui-visual-review` are integrated with the shell/i18n work in this checkout,
+`codex/prototype-administration-pages`. Both branches started at `2d1b714e`; the
+first full-shell build omitted that lateral branch and regressed the installed UI.
+The integrated source retains bundled Manrope, shared type roles, catalog/context
+alignment, wordmark sizes and composer autosizing alongside full/embedded and EN/IT.
+
+Local Docker was updated at 12:54 UTC on 2026-09-13: frontend image `605a6e6bba68`,
+healthy; Core and all data-service containers were unchanged. Mac remains full/en.
+The immediate pre-merge frontend is retained as
+`thothii-frontend:before-visual-shell-merge-20260913`.
+
+Verification: 755 frontend tests, 11 Playwright visual/interaction scenarios at five
+widths, translation-catalog checks, typecheck and production build. See
+`docs/reports/2026-09-13-visual-shell-integration.md` for delivery, provenance and
+rollback details. The separate visual-review worktree and its rollback images are
+retained. No merge to `main`, push or production deployment is part of this delivery.
+
Gitea #28–#31 follow-up is implemented in this checkout: Workspace's four tabs,
Database list-first entry without the preparation footer, full-height Pi instructions
with installation-host OS selection, and short Admin navigation labels. Core and
-session behavior are retained. These follow-up changes are **not yet rebuilt into
-local Docker**; see `docs/reports/2026-09-12-admin-issues-28-31.md` for test/review results.
-The host CLI must regenerate its Compose projection on the destination installation
-to identify the physical host OS correctly when the backend runs in Docker.
+session behavior are retained. At the owner's request, these changes were rebuilt into
+local Docker on 2026-09-12 at 18:31 UTC. Core/frontend are healthy and the UI at
+`http://127.0.0.1:8080` serves the updated bundle. The host projection now supplies
+`THT_HOST_PLATFORM=darwin`, so Pi selects macOS rather than the container's Linux OS.
+Persistent dependency containers and volumes were unchanged. Rollback images are tagged
+`thothii-core:before-admin-28-31-20260912` and
+`thothii-frontend:before-admin-28-31-20260912`. See
+`docs/reports/2026-09-12-admin-issues-28-31.md` for verification and deployment details.
The latest context-shelf A and five Administration pages are implemented locally.
At the owner's request, local Docker project `thothii-18998cca7b0a` was rebuilt and
diff --git a/deploy/compose.visual-review-rollback.yaml b/deploy/compose.visual-review-rollback.yaml
new file mode 100644
index 00000000..2b25659d
--- /dev/null
+++ b/deploy/compose.visual-review-rollback.yaml
@@ -0,0 +1,4 @@
+# The image is tagged from the running frontend before the visual review is published.
+services:
+ frontend:
+ image: thothii-frontend:before-visual-review-20260912
diff --git a/deploy/compose.visual-review.yaml b/deploy/compose.visual-review.yaml
new file mode 100644
index 00000000..abaa77f7
--- /dev/null
+++ b/deploy/compose.visual-review.yaml
@@ -0,0 +1,8 @@
+# Local-only review override. Apply after the existing local installation profiles.
+# Changes only the frontend image; Core, configuration and volumes remain unchanged.
+services:
+ frontend:
+ image: thothii-frontend:visual-review-20260912
+ build:
+ context: /Users/mp/projects/ThothII-visual-review
+ dockerfile: docker/frontend.Dockerfile
diff --git a/deploy/compose.visual-shell-rollback.yaml b/deploy/compose.visual-shell-rollback.yaml
new file mode 100644
index 00000000..d8aa8e51
--- /dev/null
+++ b/deploy/compose.visual-shell-rollback.yaml
@@ -0,0 +1,5 @@
+# Local-only rollback to the full-shell frontend before visual integration.
+# Apply after local installation profiles, with --no-build and --no-deps.
+services:
+ frontend:
+ image: thothii-frontend:before-visual-shell-merge-20260913
diff --git a/docs/reports/2026-09-12-admin-issues-28-31.md b/docs/reports/2026-09-12-admin-issues-28-31.md
index 36fd1128..80dcfa34 100644
--- a/docs/reports/2026-09-12-admin-issues-28-31.md
+++ b/docs/reports/2026-09-12-admin-issues-28-31.md
@@ -52,7 +52,7 @@ projecting the host platform, and shortening navigation labels.
initially exposed horizontal page overflow at 390 pixels; constrained grid children
and narrow definition lists corrected it. Database QA used an empty synthetic catalog;
the unit suites exercise populated tables, columns, edits and operation guards.
-- Docker and real-stack Playwright acceptance were not run for this follow-up.
+- Docker and real-stack Playwright acceptance were not run during initial implementation.
The preview is synthetic and read-only, not a deployment or provider smoke test.
## Standards
@@ -73,5 +73,24 @@ The independent follow-up review confirmed both findings resolved, with no new r
Review summary: Standards 2 findings resolved, 0 outstanding; Spec 2 findings resolved,
0 outstanding. Both reviews were read-only, relative to the user-approved baseline.
-Docker has not been rebuilt for this follow-up; the read-only QA preview uses the changed source.
+## Local Docker deployment
+
+At the owner's request, core and frontend were rebuilt from this checkout and recreated
+on 2026-09-12 at 18:31 UTC using `/private/tmp/thothii-memory-preview.sh`, with
+`--no-deps --force-recreate --wait`. Both are healthy. Database, Qdrant and embedding
+containers retained their original IDs; no persistent volumes were deleted or recreated.
+
+The normal model projection generator was run on this Mac before recreation; the running
+core now receives `THT_HOST_PLATFORM=darwin`. The authored installation configuration and
+credentials were unchanged. Before the update, images were retained as
+`thothii-core:before-admin-28-31-20260912` and
+`thothii-frontend:before-admin-28-31-20260912`; the prior projection directory was copied to
+`/private/tmp/thoth-admin-28-31-docker.5ebAo8/generated`.
+
+HTTP checks for the real UI (`http://127.0.0.1:8080/`), its `/api/health` proxy, and
+the core `/health` returned 200. Served bundle `/index-Bsz7otBx.js` contains Workspace
+areas and Pi configuration, and no longer contains the preparation footer or persisted
+Database child-screen key. Authenticated end-to-end operator workflows were not rerun.
+
+The Vite preview remains separate from Docker. Remote server deployment was not performed.
No Gitea issue state or remote branch was changed.
diff --git a/docs/reports/2026-09-12-ui-survey-and-graphic-revision-plan.md b/docs/reports/2026-09-12-ui-survey-and-graphic-revision-plan.md
new file mode 100644
index 00000000..a97826fa
--- /dev/null
+++ b/docs/reports/2026-09-12-ui-survey-and-graphic-revision-plan.md
@@ -0,0 +1,191 @@
+# ThothII: survey e piano di revisione grafica
+
+Data: 12 settembre 2026. Stato: **proposta, da approvare; nessuna modifica all'interfaccia**.
+
+## Sintesi e direzione consigliata
+
+L'incoerenza segnalata è confermata. Non dipende soltanto da dettagli sfuggiti nelle singole pagine: il design system attuale prescrive tre registri tipografici, ai quali alcuni componenti aggiungono un secondo stack serif. Titoli, etichette operative, documenti e istruzioni finiscono così per sembrare parti di prodotti diversi.
+
+Propongo una direzione unica: **interfaccia operativa interamente sans-serif, rosso istituzionale come accento, colori aggiuntivi soltanto quando comunicano uno stato, maggiore coerenza senza impoverire le informazioni**. Non serve una nuova impaginazione del Core né una nuova collocazione delle sessioni.
+
+Ho usato **Impeccable**, nel registro product, per orientare la valutazione di gerarchia, tipografia, densità, colore e microcopy. La varietà visiva dovrà venire da spaziatura, pesi e organizzazione, non dall'alternanza di famiglie tipografiche. Le grazie non sono intrinsecamente incompatibili con un prodotto tecnologico, ma qui contrastano con la direzione richiesta e non svolgono una funzione necessaria: le eliminerei dalla UI, compresi i lettori di documenti.
+
+## 1. Metodo, copertura e limiti
+
+Verifica tramite Playwright nel browser dell'app, con screenshot, navigazione e lettura degli stili CSS calcolati. La survey principale riguarda la **versione Docker reale su `http://127.0.0.1:8080/`**, autenticata con l'account autorizzato. Una precedente esplorazione dell'anteprima sintetica non è usata come prova dei dati o del funzionamento del Docker.
+
+| Area | Verifica sulla versione reale |
+| --- | --- |
+| Workspace | Preparation, Specific actions, About, Authentication |
+| Database | Elenco database, navigazione alle tabelle e alle colonne |
+| Memory | Elenco vuoto e apertura del form New card, chiuso senza modifiche |
+| Evidence | Fonti/importazione, elenco, dettaglio di un documento |
+| Pi | Runtime e Host maintenance, scheda macOS |
+| Core | Stato iniziale, compositore e controlli presenti senza avviare una domanda |
+| Sessioni | My sessions, All sessions, archivio e lettura di una sessione archiviata |
+| Navigazione | Drawer responsive, accessi Admin e contesto globale |
+
+Non ho salvato form, lanciato elaborazioni, ripreso sessioni, importato documenti o modificato configurazioni. Il controllo del Core attivo, delle fasi, dei gate e del log è limitato alla lettura del codice: non è stato eseguito un ciclo LLM per una survey grafica.
+
+Il viewport misurato nel pannello browser era **649 × 1091 CSS px**. Questo offre evidenza concreta del comportamento a larghezza ridotta, ma non sostituisce una matrice desktop/mobile. Tema scuro, contrasto numerico, navigazione completa da tastiera, zoom e integrazione effettiva in Omics Portal restano da verificare. Non è una certificazione WCAG né un audit automatizzato completo. Le famiglie riportate sono gli stack CSS calcolati, non una verifica del font effettivamente caricato dal sistema.
+
+## 2. Problemi riscontrati
+
+### Tipografia: quattro stack e gerarchie variabili
+
+| Esempio osservato | Trattamento attuale | Problema |
+| --- | --- | --- |
+| Titoli delle pagine Admin | Fraunces/serif, 30 px | Registro editoriale molto più marcato del resto dell'app |
+| Sources and imports; titolo del form Memory | Altro stack `ui-serif`, 18–20 px | Nemmeno i titoli serif usano tutti la stessa famiglia |
+| Evidence library; Original question; Revised question | Monospace, 11 px | Etichette ordinarie trattate come identificatori tecnici |
+| Working context | Monospace maiuscolo, 10 px | Informazione globale importante resa molto piccola |
+| Guida Pi Host maintenance | Testo 12 px, interlinea 16 px; titoletti serif 12 px | Istruzioni lunghe troppo dense e gerarchia debole |
+| Sessione archiviata | Titolo sessione serif 14 px; titolo nel documento serif 23,2 px | Il contenuto sovrasta il contesto del pannello |
+
+La causa è documentata in `DESIGN.md`, nella regola dei tre registri. Nel codice, `frontend/src/index.css` assegna globalmente il font heading a `h1`–`h6` e ai titoli della prosa; Memory ed Evidence aggiungono classi `font-serif`. Il problema ricompare quindi anche quando un componente non richiede esplicitamente un titolo decorativo.
+
+### Colore: troppi significati impliciti
+
+- In Database il tipo di connessione REST e la data di aggiornamento ricevono accenti blu pur essendo informazioni ordinarie.
+- La guida ordinaria di manutenzione Pi è racchiusa in una cornice ambra, visivamente simile a un avviso. Il colore non distingue un pericolo concreto.
+- Gli stati Ready in Pi usano anche testo verde molto chiaro: è un rischio di leggibilità da misurare, non una violazione numericamente accertata in questa survey.
+- Stato operativo, azione primaria, contenitore informativo e semplice categoria non seguono una grammatica cromatica sufficientemente riconoscibile.
+
+Non eliminerei invece indiscriminatamente verde e ambra: successo, errore, attesa di revisione e avvertimento devono restare distinguibili, sempre anche tramite testo o icona.
+
+### Spazio e linguaggio
+
+| Area | Evidenza | Intervento proposto |
+| --- | --- | --- |
+| Workspace | Identità e descrizioni ripetute fra contesto, selezione e intestazioni; molte gerarchie prima delle azioni | Mantenere le quattro schede, ridurre ripetizioni e uniformare sezioni e azioni |
+| Database | Intestazione, stato, cronologia, Fleet summary, breadcrumb e toolbar precedono i dati; a 649 px il riepilogo occupa più righe | Compattare il riepilogo, dare priorità alla griglia; sostituire il gergo Fleet con un nome corrispondente al suo ambito |
+| Memory | Stato vuoto formulato come assenza di risultati filtrati anche senza carte; ampie aree vuote e paginazione disabilitata | Distinguere libreria vuota da ricerca senza risultati; stesso linguaggio visivo di toolbar e form del resto dell'Admin |
+| Evidence | Percorso tecnico e istruzioni di importazione dominano la parte superiore; ricerca compressa rispetto agli altri filtri | Istruzioni brevi con dettagli espandibili; percorso secondario ma copiabile; filtri che si dispongono su più righe prima di diventare illeggibili |
+| Pi | Guida molto lunga e piccola; spiegazioni dell'architettura mescolate con istruzioni all'operatore | Separare stato, azioni e guida; rendere la guida leggibile e consultabile per attività |
+| Sessioni | Molti registri tipografici; a 649 px il pannello documenti è stretto e tronca il titolo | Coerenza dei titoli e dei documenti; adeguare il pannello alla larghezza disponibile senza cambiare la gestione delle sessioni |
+| Core e navigazione | Branding ripetuto, microetichette e controlli di taglie diverse | Riallineare la gerarchia e i componenti condivisi, conservando struttura e comportamento |
+
+Gli stili comunicativi oscillano fra introduzione promozionale nel Core, manuale tecnico in Pi/Evidence e terminologia da dashboard infrastrutturale in Database. La soluzione è un tono operativo unico, non la rimozione delle informazioni tecniche necessarie.
+
+## 3. Regole del sistema visivo proposto
+
+### Una famiglia UI, cinque ruoli dimensionali
+
+Consiglio di **mantenere Manrope**, già adottato per l'interazione, e usarlo per tutta la UI. Non aggiungerei una nuova famiglia per il solo gusto di cambiare. Pesi ordinari 400, 500 e 600; monospace soltanto per SQL, codice, percorsi e identificatori quando serve riconoscerli o copiarli.
+
+| Ruolo | Dimensione proposta | Uso |
+| --- | --- | --- |
+| Titolo pagina | 24 px / 1,5 rem, peso 600 | Core/Admin, senza effetto copertina |
+| Titolo sezione | 20 px / 1,25 rem, peso 600 | Sezioni principali e pannelli di lettura |
+| Lettura | 16 px / 1 rem, peso 400 | Risposte, documenti, istruzioni articolate; interlinea circa 1,5 |
+| Interazione e dati | 14 px / 0,875 rem, peso 400–600 | Form, tab, pulsanti, griglie; sottosezioni compatte in peso 600 |
+| Metadati secondari | 12 px / 0,75 rem, peso 400–500 | Timestamp, conteggi e indicazioni accessorie |
+
+Sono ruoli, non l'obbligo di rendere ogni titolo di sezione grande: una sottosezione compatta può usare il ruolo da 14 px in semibold. Niente ridimensionamento fluido che faccia oscillare continuamente i caratteri con la larghezza. Prima si riorganizza il layout, poi si valutano eccezioni documentate.
+
+Ulteriori regole:
+
+- Eliminare Fraunces e le classi serif dall'interfaccia e dalla resa dei documenti. Non riscrivere il contenuto dei documenti.
+- Usare etichette sans-serif in sentence case; limitare maiuscole e spaziatura espansa.
+- Nessun testo operativo ordinario sotto 12 px; non far stare più contenuto riducendolo a 8–11 px.
+- Numeri tabulari nelle colonne numeriche; testo libero proporzionale; codice monospace leggibile.
+- Distribuire il font con l'app, evitando che Google Fonts sia necessario alla coerenza della UI in un ambiente intranet. Verificare fallback e caricamento, senza presumere che oggi il font remoto non funzioni.
+
+### Palette: neutri e rosso, con eccezioni semantiche
+
+| Ruolo | Regola |
+| --- | --- |
+| Superfici | Bianco e pochi grigi neutri, bordi leggeri; niente colorazione per ogni sezione |
+| Testo | Grafite per testo principale, grigio leggibile per secondario |
+| Rosso istituzionale | Azione primaria, selezione e focus; tonalità coerente con il tema Omics, da verificare nell'integrazione |
+| Successo | Indicatore verde sobrio con testo sufficientemente scuro; non interi paragrafi verde pallido |
+| Avvertimento/attesa umana | Ambra soltanto quando occorre attenzione, con motivazione esplicita |
+| Errore/distruzione | Trattamento distinto tramite icona, etichetta e conferma dove prevista; non affidarsi al solo rosso condiviso con il brand |
+| Informazioni ordinarie | Neutre: timestamp, protocollo, conteggi, guide e configurazione non sono automaticamente stati colorati |
+
+SQL, grafici e visualizzazioni possono mantenere colori utili alla comprensione dei dati. Questa revisione non impone un monocromo indiscriminato. Gli stati del workflow conserveranno il loro significato; ogni modifica cromatica dovrà avere una mappatura esplicita.
+
+### Componenti e testi condivisi
+
+- Un'unica famiglia di intestazioni Admin, toolbar, tab, campi, pulsanti, badge e messaggi.
+- Scala di spaziatura comune basata su multipli di 4 px, con distinzione chiara fra spazio dentro un gruppo e spazio fra gruppi.
+- Una primaria per il compito locale; azioni secondarie neutre, pericolose riconoscibili senza rendere tutto rosso.
+- Tab allo stesso livello con lo stesso trattamento. Le schede OS di una guida possono essere più compatte, ma non appartenere a un altro sistema grafico.
+- Istruzione essenziale accanto all'azione; procedure e dettagli di implementazione in una sezione di aiuto espandibile.
+- Testi UI in inglese; documenti e dati conservano la propria lingua. I titoli italiani di Evidence e sessioni non sono un errore di uniformità.
+
+Esempi di microcopy da affinare nell'implementazione:
+
+| Attuale | Proposta |
+| --- | --- |
+| Fleet summary | Catalog summary, se confermato l'ambito del riepilogo |
+| No cards match these filters… in una libreria vuota | No memory cards yet. Create a card to add reusable knowledge. |
+| Session models in Pi | Available models, con indicazione dell'effettiva idoneità Core/Admin |
+| Spiegazione che la pagina “never creates a second model default” | Installation default, con breve indicazione di dove modificarlo e dettagli tecnici separati |
+
+Il pulsante che prova il default d'installazione deve continuare a dichiarare **quale modello testa**: non va confuso con il modello selezionato nel contesto globale. Anche la distinzione fra importazione, revisione e consolidamento Evidence deve rimanere esplicita.
+
+## 4. Vincoli funzionali e integrazione
+
+La revisione deve conservare:
+
+1. Core originale: domanda/risposta, otto fasi in alto, gate di revisione, log sul lato sinistro e controlli esistenti.
+2. Sessioni nella navigazione destra con **My sessions / All sessions**, archivio e azioni attuali. Nessuna sezione sostitutiva in fondo alla pagina.
+3. Contesto globale A espandibile in alto: workspace e modello unici per tutta l'app; scelte ricordate indipendentemente e default esistenti.
+4. Blocco delle attività senza contesto valido e del cambio contesto durante un'elaborazione; protezione delle modifiche Admin non salvate.
+5. Cinque pagine Admin, preprocessing in Workspace Preparation e gestione database/tabelle/campi/relazioni in Database.
+6. Unificazione già realizzata della configurazione LLM, senza introdurre selettori o default alternativi.
+7. Prototipi precedenti conservati e recuperabili.
+
+**Omics Portal possiede header rosso e sidebar sinistra.** ThothII non deve duplicarli. Le regole globali attuali su `:root`, `body` e titoli richiedono una verifica di isolamento: se l'integrazione avviene nello stesso DOM, gli stili vanno circoscritti alla radice ThothII; se avviene in iframe, vanno verificati dimensionamento, tema e scrolling. È un rischio di integrazione da verificare, non una sovrapposizione già osservata sul portale.
+
+A larghezze ridotte pannelli e filtri devono adattarsi alla larghezza del contenitore reale, non soltanto della finestra. Nel lettore della sessione il testo non dovrebbe restare confinato in una colonna di circa 195 px come nello screenshot a 649 px: prevedere un pannello più ampio o sovrapposto nella modalità compatta, mantenendo accessi e funzione originali.
+
+## 5. Sequenza di lavoro proposta
+
+### Fase 1: regole e campione rappresentativo
+
+Dopo approvazione, aggiornare `DESIGN.md` eliminando la regola dei tre registri e allineando gli eventuali riferimenti superati ai modelli e alla navigazione. Definire token tipografici, colori semantici e componenti comuni.
+
+Applicare un primo campione a **Workspace e Pi**: insieme verificano form, stato operativo, selezioni, istruzioni lunghe e codice. Mostrare il confronto prima/dopo mantenendo stessi contenuti e viewport. Non servono tre nuovi design alternativi: serve validare un sistema coerente.
+
+### Fase 2: shell e tutte le pagine Admin
+
+Uniformare contesto globale, navigazione, titoli, tab e controlli; estendere il sistema a Database, Memory ed Evidence. Compattare riepiloghi e istruzioni senza eliminare funzionalità. Correggere stati vuoti, larghezze dei filtri e formattazione dei blocchi di codice nella guida Pi.
+
+### Fase 3: Core, documenti e sessioni
+
+Applicare gli stessi token a compositore, fasi, log, widget di revisione, documenti e navigazione sessioni. Nessuna nuova struttura del workflow. Controllare separatamente liste, documento aperto, sessione attiva e pannelli nella modalità compatta.
+
+### Fase 4: verifica e consegna
+
+Eseguire typecheck, test dei componenti interessati e regressione Playwright con dati di test, senza consumare chiamate LLM reali soltanto per verificare gli stili. Includere prove di flusso per navigazione con modifiche non salvate e blocco del contesto durante un'operazione.
+
+Preparare screenshot comparabili e verifiche a 390, 649, 768, 1280 e 1600 px, oltre alla larghezza effettiva assegnata da Omics con sidebar presente. Verificare tema chiaro/scuro, zoom 200%, tastiera, focus, testo lungo, stato vuoto/errore/caricamento e griglie larghe. L'integrazione finale nel server resta una fase distinta, secondo le decisioni già prese.
+
+## 6. Criteri di accettazione
+
+- Una sola famiglia sans per la UI; monospace solo per contenuto tecnico. Nessuna classe serif residua nei componenti operativi o nei lettori.
+- Dimensioni e pesi derivati dai ruoli condivisi; ogni eccezione ha un motivo documentato.
+- Colori dei componenti da token semantici; nessun blu decorativo per date o protocolli e nessuna cornice di warning intorno a una guida ordinaria.
+- Contrasto del testo almeno 4,5:1, salvo le eccezioni previste per testo grande e altri casi specifici; non assumere che ogni semibold sia testo grande. Riferimento: [W3C, Contrast Minimum](https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html).
+- Contrasto almeno 3:1 per informazioni visive necessarie a identificare controlli e stati, nei casi applicabili; non è un obbligo per ogni bordo decorativo. Riferimento: [W3C, Non-text Contrast](https://www.w3.org/WAI/WCAG22/Understanding/non-text-contrast.html).
+- Stato e azione distinguibili anche senza colore; focus visibile e controlli utilizzabili da tastiera.
+- Nessuna sovrapposizione o scroll orizzontale dell'intera pagina ai viewport concordati; scroll locale consentito per tabelle e codice quando necessario.
+- Nessuna regressione funzionale di Core, sessioni, Admin, selezione globale o salvataggio; test dei flussi critici invariati o rafforzati.
+- Nessuna modifica del contenuto scientifico, dei default LLM, delle autorizzazioni o delle procedure di manutenzione mascherata da intervento grafico.
+
+## 7. Punti principali del codice interessati in una futura implementazione
+
+- `DESIGN.md`: regole tipografiche e cromatiche.
+- `frontend/index.html`: caricamento delle famiglie di caratteri.
+- `frontend/src/index.css`: token, titoli globali, etichette e prosa.
+- `frontend/src/shell/WorkingContextShelf.css`: contesto globale e microtipografia.
+- `frontend/src/shell/administration/AdministrationPage.css`: intestazioni comuni.
+- `frontend/src/shell/WorkspaceManager.css`: gerarchie e densità Workspace.
+- `frontend/src/shell/database-management/FleetLedgerShell.css`: riepiloghi, toolbar e griglie.
+- Componenti Memory/Evidence: override serif di titoli e form.
+- Componenti Pi: guida, stati, tab OS e microcopy operativo.
+- Componenti Core/sessioni: fasi, lettura documenti, log, navigazione e pannelli responsive.
+
+**Decisione richiesta:** approvare questa direzione visiva e il campione Workspace/Pi prima di estenderla. Questa survey non crea ticket, non aggiorna il design normativo e non ricostruisce Docker.
diff --git a/docs/reports/2026-09-12-ui-visual-review-delivery.md b/docs/reports/2026-09-12-ui-visual-review-delivery.md
new file mode 100644
index 00000000..739e0820
--- /dev/null
+++ b/docs/reports/2026-09-12-ui-visual-review-delivery.md
@@ -0,0 +1,181 @@
+# Revisione grafica: consegna su worktree e Docker
+
+Stato: **pubblicata per revisione visiva, non integrata in main**.
+
+Aggiornamento 2026-09-13: i sette commit di questa revisione sono ora integrati con
+full/embedded e i18n nel ramo `codex/prototype-administration-pages`, su richiesta
+del proprietario. Per lo stato corrente e il rollback usare il
+[rapporto di integrazione](2026-09-13-visual-shell-integration.md).
+Il seguito conserva la cronologia della consegna isolata originale.
+
+## Dove provarla
+
+- Docker locale: .
+- Worktree: `/Users/mp/projects/ThothII-visual-review`.
+- Ramo: `codex/ui-visual-review`.
+- Base preservata: `2d1b714ebe31419d712e9c3324a5e171d5f0317d`.
+- Checkout originale: `/Users/mp/projects/ThothII`, ramo `codex/prototype-administration-pages`, lasciato intatto, incluse le note non ancora committate e i prototipi.
+
+Non è stato eseguito alcun merge, push o aggiornamento di Gitea. Questa consegna richiede la revisione ottica del proprietario prima dell'adozione.
+
+## Interventi
+
+Impeccable, registro product, ha guidato le scelte: Manrope sans-serif locale per tutta la UI; niente serif nei componenti o nei documenti; cinque ruoli tipografici condivisi; monospace conservato per contenuto tecnico. I font non dipendono più da Google Fonts.
+
+Le etichette ordinarie non usano più monospace maiuscolo. Le piccole dimensioni arbitrarie dei componenti sono state ricondotte a 12, 14 o 16 px. Titoli Admin a 24 px; intestazioni, controlli e prosa sono coerenti fra superfici.
+
+Il rosso resta l'accento principale. Date e protocolli sono neutri. Verde e ambra usano token semantici leggibili anche in tema scuro. La guida Pi non è più presentata come un grande avviso ambra. Il tema delle utility segue il tema dell'app/portale, non autonomamente quello del sistema operativo. Placeholder e focus sono più leggibili.
+
+Interventi specifici:
+
+- Workspace: tipografia e stati uniformati, mantenute quattro schede e preprocessing.
+- Database: riepilogo più compatto, Catalog summary al posto di Fleet summary, intestazioni delle griglie senza monospace maiuscolo, selezioni compatibili con il tema scuro.
+- Memory: titoli e form sans-serif; messaggio distinto per libreria vuota e nessun risultato filtrato; paginazione mostrata quando serve.
+- Evidence: istruzioni tecniche espandibili, percorso host sempre disponibile e copiabile nella relativa sezione, filtri responsive con ricerca di larghezza utile.
+- Pi: guida leggibile a 16 px, codice correttamente su più righe, tab OS coerenti, testo che distingue default d'installazione e modello selezionato, Available models.
+- Core/sessioni: uniformazione estetica senza modifiche al workflow; otto fasi, gate, log, input e gestione sessioni conservati. Nei layout compatti il lettore documenti usa lo spazio disponibile anziché una colonna illeggibile.
+
+Il modello globale, i default, le autorizzazioni e i blocchi di navigazione non sono stati ridisegnati. Non sono state eseguite elaborazioni LLM o mutate informazioni applicative per questa verifica.
+
+## Follow-up: marchio applicativo (2026-09-13)
+
+Su richiesta dell'utente, ripristinato ThothII a 48 px nel Core e ingrandito a 32 px nella
+sidebar destra. Manrope semibold e suffisso II rosso restano coerenti con Impeccable;
+il marchio è un'eccezione esplicita alla scala dei titoli ordinari in DESIGN.md.
+Nessuna modifica funzionale. Build e 7 scenari Playwright superati, con controlli delle
+dimensioni del marchio alle cinque larghezze. Pubblicato nuovamente il solo frontend
+Docker usando il medesimo tag di revisione; immagine di ripristino invariata, nessun merge.
+La nuova immagine sostituisce quella identificata nella prima consegna sotto:
+`sha256:f576ee4882456b4d2d338dbb2228d301f9ffd8d0c7de541842c767bbe8d02dad`.
+
+## Follow-up: indicatori del catalogo (2026-09-13)
+
+Spostati i pallini dopo le etichette Catalog, Operations e Metadata updated, mantenendo
+il rientro del testo e l'allineamento con i valori sottostanti. Spaziatura uniforme e
+centratura verticale secondo Impeccable. I 7 scenari Playwright passano, inclusi nuovi
+controlli geometrici per tutte e tre le etichette alle cinque larghezze responsive.
+Il successivo aggiornamento del medesimo tag frontend include questa correzione;
+il digest del follow-up precedente identifica quindi una versione superata.
+
+## Follow-up: altezza del prompt Core (2026-09-13)
+
+Riprodotto con Playwright il campo schiacciato: altezza inline 0 px, spazio utile 8 px,
+a fronte di 31 px necessari per la prima riga. L'autosizing misurava il Core ancora
+nascosto durante il caricamento del contesto e non reagiva alla successiva apertura.
+Il reset isolato dell'altezza ad auto riportava immediatamente il campo a 31 px.
+
+Il composer ora evita misure nascoste, ricalcola al cambio di larghezza/visibilità e
+al caricamento dei font, conserva un minimo di 32 px e cresce fino a 160 px con scroll.
+Il focus usa il contorno esterno esistente, senza il secondo bordo interno.
+Nessuna modifica all'invio o al workflow. Passati 9 scenari Playwright e 17 test Vitest
+mirati; coperti ingresso dal Core e dall'Admin, Shift+Enter, testo lungo, mobile,
+navigazione con bozza conservata e svuotamento. Build Docker frontend aggiornata;
+branch di revisione isolato, immagine di ripristino invariata.
+
+## Follow-up: griglia di allineamento del catalogo (2026-09-13)
+
+Catalog condivide il margine di Catalog summary; sui layout ampi Metadata updated
+condivide l'asse di Description coverage e Operations occupa il punto medio fra i due.
+Usati margini condivisi e gli stessi cinque riferimenti di colonna dei KPI, senza offset
+assoluti. Sulle larghezze ridotte gli stati continuano a disporsi senza sovrapposizioni.
+Passati 9 scenari Playwright, con assert geometrici sugli allineamenti richiesti.
+Pubblicazione limitata al frontend Docker del worktree di revisione, nessun merge.
+
+## Follow-up: margini esterni e assi interni (2026-09-13)
+
+La verifica geometrica iniziale rilevava 20 px di differenza fra il bordo sinistro
+del riepilogo e quello della tabella. In accordo con Impeccable, introdotti due token:
+margine esterno condiviso di 20 px e padding interno di 16 px. Catalog summary,
+navigazione Databases e tabella hanno bordi sinistro/destro coincidenti; riepilogo,
+Tables, Databases e Workspace databases condividono l'asse testuale a 36 px.
+Header, toolbar azioni e stati seguono lo stesso asse. Conservato l'allineamento
+Metadata updated/Description coverage e Operations al punto medio sui layout ampi.
+Passati 9 scenari Playwright con assert geometrici a 390, 649, 768, 1280 e 1600 px.
+Nessuna modifica funzionale; aggiornamento Docker limitato al frontend di revisione.
+
+## Follow-up: pannello del contesto globale (2026-09-13)
+
+Il pannello espanso Workspace/Model ora usa gli stessi token di margine esterno (20 px)
+e padding interno (16 px) del catalogo, con superficie rientrata e controlli sull'asse
+testuale a 36 px. Allineamento curato con Impeccable e verificato alle cinque larghezze.
+Rimosse la frase sulle ultime scelte e le indicazioni di provenienza sotto i selettori
+(Installation default / Last choice). Logica di selezione, persistenza, default,
+blocchi operativi e messaggi di errore invariati. Passati 9 scenari Playwright con
+controlli sul pannello aperto, sui margini e sull'assenza delle diciture rimosse.
+
+## Verifica
+
+| Verifica | Esito |
+| --- | --- |
+| Frontend, suite Vitest | 679 test passati |
+| TypeScript + build produzione | Passati |
+| Playwright dedicato | 7 scenari passati, nessun retry |
+| Larghezze | 390, 649, 768, 1280, 1600 CSS px |
+| Superfici Playwright | Cinque Admin, guida Pi, Core iniziale, My/All sessions e lettore archivio |
+| Interazioni | Tab OS da tastiera, modifica Memory trattenuta durante tentativo di navigazione, ritorno al Core dopo annullamento |
+| Tema | Chiaro indipendente dal tema OS; scuro tramite attributo del portale |
+| Spazio host | Simulazione di 240 px riservati al menu sinistro e 72 px all'header, con utility concorrente |
+| Docker reale | Accesso e navigazione fra le cinque pagine Admin; titolo sans-serif 24 px e nessun overflow dell'intera pagina nel viewport verificato |
+
+I test visuali usano fixture e intercettano tutte le richieste API prima che possano raggiungere un'installazione. Nessuna scrittura è ammessa: ogni scenario controlla che non ne siano state tentate. Gli screenshot sono negli output locali ignorati da Git, `frontend/test-results/visual-review/`.
+
+Comandi di verifica nel worktree:
+
+```sh
+cd /Users/mp/projects/ThothII-visual-review/frontend
+npm test -- --maxWorkers=2 --minWorkers=1
+npm run build
+npx playwright test --config playwright.visual.config.ts
+```
+
+Contrasti calcolati sulle coppie di token opachi di riferimento, non su ogni possibile composizione/hover:
+
+| Coppia | Chiaro | Scuro |
+| --- | --- | --- |
+| Testo principale / card | 15,16:1 | 13,61:1 |
+| Testo secondario / card | 5,67:1 | 8,40:1 |
+| Successo / card | 6,76:1 | 8,69:1 |
+| Avvertimento / card | 6,64:1 | 9,44:1 |
+| Bordo input / card | 3,36:1 | 4,56:1 |
+| Testo pulsante primario / riempimento | 5,03:1 | 6,83:1 |
+
+Limiti: non è una certificazione WCAG completa; non è stata eseguita una nuova sessione LLM sul Docker reale. La prova con geometria host non equivale all'integrazione nel vero Omics Portal. Lo zoom browser 200% e tutte le combinazioni di hover/trasparenza non sono stati verificati esaustivamente. I test funzionali già esistenti coprono fasi, sessioni e protezioni; le modifiche non cambiano la loro logica.
+
+## Docker e ripristino
+
+Progetto Compose: `thothii-18998cca7b0a`. È stato ricreato **solo frontend** con `--no-deps --no-build` dopo una build esplicita dal nuovo worktree.
+
+| Elemento | Valore verificato |
+| --- | --- |
+| Immagine nuova | `thothii-frontend:visual-review-20260912` |
+| Digest immagine nuova | `sha256:eeccb28f5c5cd78da08fd007e259e3fb88f26b4f1415a825a3b5829061f79ed3` |
+| Immagine precedente conservata | `thothii-frontend:before-visual-review-20260912` |
+| Digest precedente | `sha256:635f25477f11a476034052e87b2129ae26a9a049c4bedde0ada3a1d65e4ee924` |
+| Container frontend nuovo | `50dd012cd400`, healthy |
+| Core invariato | `0dcce917be0c`, healthy |
+| Catalog DB invariato | `89755e439dc7`, healthy |
+| Qdrant invariato | `52ebd5c47955`, healthy |
+| Embedding invariato | `7f690e534eda`, healthy |
+| Bundle servito | `/index-Cd-Ma0ye.js`, `/index-CptC2K6s.css` |
+
+Per tornare al look precedente, senza rebuild e senza modificare dati o Core:
+
+```sh
+bash /private/tmp/thothii-memory-preview.sh \
+ -f /Users/mp/projects/ThothII-visual-review/deploy/compose.visual-review-rollback.yaml \
+ up -d --no-deps --no-build frontend
+```
+
+Per ripubblicare il look di revisione già costruito:
+
+```sh
+bash /private/tmp/thothii-memory-preview.sh \
+ -f /Users/mp/projects/ThothII-visual-review/deploy/compose.visual-review.yaml \
+ up -d --no-deps --no-build frontend
+```
+
+Questi override sono deliberatamente locali e usano il launcher dell'installazione già presente; non vanno applicati sul server PSD. Il launcher in `/private/tmp` dipende dai profili locali esistenti: se rimosso, ricostruire l'invocazione dai profili dell'installazione, senza sostituire configurazioni o volumi. Le immagini di review e rollback restano taggate: non eseguire una pulizia delle immagini prima della decisione.
+
+## Decisione successiva
+
+Il proprietario valuta il look su Docker. Solo dopo approvazione si procederà con l'integrazione su `main`, verificando anche l'eventuale differenza fra `main` e il ramo di partenza. Un rifiuto della revisione richiede soltanto il ripristino frontend sopra indicato; codice e prototipi precedenti sono preservati.
diff --git a/docs/reports/2026-09-13-full-shell-implementation.md b/docs/reports/2026-09-13-full-shell-implementation.md
index 68eefb28..fac6db58 100644
--- a/docs/reports/2026-09-13-full-shell-implementation.md
+++ b/docs/reports/2026-09-13-full-shell-implementation.md
@@ -3,6 +3,11 @@
Data: 2026-09-13. Specifica: [Full shell, integrazione Omics e interfaccia bilingue](../plans/2026-09-13-full-shell-spec.md).
I cinque ticket e le loro dipendenze sono elencati nel [piano](../plans/2026-09-13-full-shell-and-portal-integration.md).
+Correzione della base grafica: la prima build descritta qui non includeva i sette
+commit del ramo `codex/ui-visual-review` già installati sul Mac. Il
+[rapporto di integrazione](2026-09-13-visual-shell-integration.md) documenta il
+recupero di font, allineamenti e layout, mantenendo le funzionalità di questa consegna.
+
## Risultato
- Configurazione pubblica generata dal descrittore installato; full ed embedded
diff --git a/docs/reports/2026-09-13-visual-shell-integration.md b/docs/reports/2026-09-13-visual-shell-integration.md
new file mode 100644
index 00000000..09aa76d0
--- /dev/null
+++ b/docs/reports/2026-09-13-visual-shell-integration.md
@@ -0,0 +1,125 @@
+# Integrazione della revisione grafica con full/embedded
+
+Data: 2026-09-13. Ambito autorizzato: integrazione locale e aggiornamento del Mac,
+senza push, merge in `main` o deploy sul server PSD.
+
+## Causa della regressione
+
+La revisione full/embedded `d8a29bfb` e il ramo `codex/ui-visual-review` partivano
+entrambi da `2d1b714e`. La prima build full è stata eseguita dal primo ramo senza
+integrare i sette commit grafici già presenti nell'immagine installata sul Mac.
+La corrispondenza è verificata anche sulle immagini: il backup
+`thothii-frontend:before-full-shell-20260913` e
+`thothii-frontend:visual-review-20260912` identificano entrambi `7dceaafcd9ee`.
+
+Commit recuperati, in ordine:
+
+| Commit | Modifica |
+| --- | --- |
+| `c8d276dd` | Manrope locale, scala tipografica condivisa, leggibilità delle pagine operative |
+| `eed398e5` | Marchio ThothII a 48 px nel Core e 32 px nella sidebar |
+| `8c819968` | Indicatori del catalogo dopo le rispettive etichette |
+| `803e9e92` | Ricalcolo dell'altezza del campo domanda dopo la riapertura del Core |
+| `e088abd6` | Allineamento degli stati alla griglia del riepilogo |
+| `5af44081` | Margini e assi interni dei blocchi Database |
+| `a59624a6` | Allineamento del pannello del contesto e rimozione delle spiegazioni ridondanti |
+
+## Criteri di riconciliazione
+
+- Conservati traduzioni, protezione delle bozze, autenticazione, gestione delle
+ sessioni e isolamento dell'adapter Omics introdotti dalla revisione full.
+- Recuperati font locale, classi e geometria approvati nel ramo grafico.
+ Impeccable, registro product, ha guidato la verifica della coerenza; nessun
+ ridisegno delle pagine o nuovo accorciamento dei loro titoli.
+- Il reset e i token CSS restano circoscritti al mount di ThothII e ai suoi popup:
+ la revisione grafica non reintroduce un reset del documento del portale.
+- Conservati tema, traduzioni e stato di AG Grid; le colorazioni degli avvisi
+ rimangono leggibili nei due temi.
+- Tradotte le nuove etichette e le spiegazioni introdotte dalla revisione grafica.
+- Il mock di ResizeObserver dei test ora emette le misure degli elementi osservati,
+ come richiesto anche dal ridimensionamento del campo domanda recuperato.
+- I test visuali configurano esplicitamente full oppure embedded. La simulazione
+ embedded fornisce le preferenze del portale e il suo reset del margine del body;
+ ThothII non deve applicare quel reset al documento esterno.
+
+## Verifiche
+
+| Controllo | Esito |
+| --- | --- |
+| Suite frontend completa | 755 test passati, zero fallimenti |
+| Playwright visuale/interazione | 11 scenari passati, zero saltati o instabili |
+| Larghezze della revisione grafica | 390, 649, 768, 1280 e 1600 px |
+| Combinazione lingua/tema/full | EN/IT, chiaro/scuro, persistenza al reload e margini simmetrici a 390 e 1280 px |
+| Caricamento font | Verificata una font face Manrope Variable effettivamente caricata |
+| Embedded | Nessun header ThothII, contenimento sotto header e sidebar del portale simulato |
+| Cataloghi | 1681 messaggi italiani, 1706 riferimenti statici; nessuna chiave mancante o interpolazione incoerente |
+| Typecheck e build | Superati, inclusa la regressione sul CSS compilato prima della build |
+| Documentazione | Build MkDocs strict superata |
+
+Le verifiche Playwright usano dati sintetici e bloccano tutte le richieste API;
+gli scenari non avviano modelli reali né modificano dati dell'installazione.
+Gli screenshot sono in `frontend/test-results/visual-review/`, ignorati da Git.
+Backend, harness e Omics non sono modificati da questa integrazione; le loro
+verifiche precedenti restano nel rapporto full-shell. Non viene rivendicata una
+nuova verifica end-to-end sul portale di produzione.
+
+La verifica indipendente dell'integrazione di CSS, shell e reset non ha segnalato
+rilievi aperti. Il controllo della pagina reale ha inoltre rilevato l'etichetta
+predefinita «Administration» non tradotta: è stata corretta nel componente condiviso
+e coperta dallo scenario EN/IT. Nessun nuovo testo JSX o attributo di accessibilità
+non tradotto è stato introdotto dal merge, secondo il confronto statico con `d8a29bfb`.
+
+## Aggiornamento e rollback locali
+
+Contesto di build: `/Users/mp/projects/ThothII`; launcher dell'installazione:
+`/private/tmp/thothii-memory-preview.sh`. Il launcher termina con l'override
+`/private/tmp/thothii-context-a.compose.yaml`, che seleziona questo checkout.
+Non applicare l'override della precedente revisione isolata: selezionerebbe di nuovo
+il worktree senza l'integrazione full/embedded.
+
+Comandi usati per costruire e sostituire il solo frontend:
+
+```sh
+bash /private/tmp/thothii-memory-preview.sh build frontend
+bash /private/tmp/thothii-memory-preview.sh up -d --no-deps --no-build --wait frontend
+```
+
+Configurazione Mac conservata: modalità `full`, lingua predefinita `en`.
+Aggiornamento completato alle 12:54 UTC: immagine frontend `605a6e6bba68`, container
+`9489a5765f7b`, stato healthy. Core (`3c3c0739b9af`), catalogo (`89755e439dc7`),
+Qdrant (`52ebd5c47955`) ed embedding (`7f690e534eda`) conservano gli stessi container,
+immagini e tempi di avvio rilevati prima dell'aggiornamento; sono tutti healthy.
+Il controllo dal browser usa l'accesso locale già presente, senza logout, modifica
+del catalogo o avvio di una sessione del modello. Sul viewport reale da 771 px:
+titolo Manrope Variable a 24 px, margini full sinistro/destro di 24 px, tre blocchi
+Database con identica posizione x=45 e larghezza 681 px; nessun overflow della pagina.
+Verificati italiano e tema scuro; ripristinati inglese e tema chiaro.
+
+L'immagine prima del merge è conservata come
+`thothii-frontend:before-visual-shell-merge-20260913` (`781650644192`). Per ripristinare
+quella versione full precedente, senza toccare Core o i volumi:
+
+```sh
+bash /private/tmp/thothii-memory-preview.sh \
+ -f /Users/mp/projects/ThothII/deploy/compose.visual-shell-rollback.yaml \
+ up -d --no-deps --no-build --wait frontend
+```
+
+Quel rollback reintroduce volutamente l'aspetto precedente al recupero grafico.
+Per tornare alla versione integrata usare il launcher senza l'override di rollback.
+Le immagini della revisione grafica isolata rimangono disponibili, ma non includono
+le nuove funzionalità full/embedded: non sono il rollback equivalente di questa consegna.
+
+## Conservazione del lavoro locale e prevenzione
+
+Le tre modifiche documentali locali preesistenti sono state protette nello stash
+`436d59225869aa3d93ee04077c566d371bde4099`. I due rapporti erano identici alle versioni
+del ramo grafico; tutte le aggiunte di PROJECT_STATE erano già contenute nel merge.
+Non è stato necessario riapplicarle o sovrascrivere le versioni integrate. Lo stash
+è conservato come ulteriore copia recuperabile.
+
+Prima di un successivo rebuild, confrontare il ramo corrente con gli altri worktree
+attivi e controllare il contesto di build effettivo del launcher. Un'immagine locale
+può provenire da un ramo laterale più recente del checkout principale. Il passaggio
+delle sole suite funzionali non certifica che la build contenga la revisione grafica
+già accettata: verificare anche l'ascendenza Git e i test visuali recuperati qui.
diff --git a/frontend/e2e/ui-visual-review.spec.ts b/frontend/e2e/ui-visual-review.spec.ts
new file mode 100644
index 00000000..46687b9a
--- /dev/null
+++ b/frontend/e2e/ui-visual-review.spec.ts
@@ -0,0 +1,337 @@
+import { expect, test, type Page } from "@playwright/test";
+import { canonicalWorkspaceFixture, workspaceRevisionFixture, workspaceSummaryFixture } from "../src/test/workspace-fixtures";
+
+// These tests never forward API requests to an installation or invoke a real model.
+const workspace = "visual-fixture";
+const title = "Clinical research workspace";
+const model = { provider: "test", id: "review-model", name: "Review model", reasoning: true };
+const revision = workspaceRevisionFixture(workspace);
+const evidence = {
+ id: "evidence:cohort", title: "Cohort definition", kind: "domain", language: "en",
+ purposes: ["sql_generation"], applies_to: { concepts: ["cohort"], tables: [], columns: [] },
+ payload: { rule: "# Approved cohort\n\nInclude eligible patients. Review the inclusion criteria before generating SQL." },
+ provenance: { source_file: "research-guide.md", supporting_excerpts: ["Eligibility is evaluated at admission."] },
+ review_items: [], file: "curated/domain/cohort.md", status: "active", revision: "1",
+};
+const evidencePage = {
+ items: [evidence], total: 1, page: 1, page_size: 25, errors: [], initialized: true,
+ active_revision: "1", pending_revision: null, source_reviews: [],
+ location: { repository: "/installation/workspaces", workspace: "/installation/workspaces/clinical-research",
+ runtime_workspace: "/data/workspaces/clinical-research", host: "installation", command: "tht workspace consolidate",
+ git_commands: ["git status", "git diff"] },
+};
+
+async function fixtures(page: Page, mode: "full" | "embedded" = "full") {
+ const writes: string[] = [];
+ await page.route("**/config.js", route => route.fulfill({
+ contentType: "application/javascript",
+ body: `window.__THOTHII_CONFIG__ = ${JSON.stringify({ backendBaseUrl: "/api", shell: { mode, defaultLocale: "en" } })};
+ ${mode === "embedded" ? `
+ document.documentElement.setAttribute("data-bs-theme", "light");
+ const language = document.createElement("select");
+ language.className = "omics-language-select";
+ language.dataset.lang = "en";
+ language.hidden = true;
+ document.body.prepend(language);
+ ` : ""}`,
+ }));
+ await page.route("http://127.0.0.1:5183/api/**", async route => {
+ const path = new URL(route.request().url()).pathname.replace(/^\/api/, "");
+ if (route.request().method() !== "GET") {
+ writes.push(path);
+ return route.fulfill({ status: 503, json: { message: "Visual fixture: no writes" } });
+ }
+ let body: unknown;
+ if (path === "/auth/config") body = { mode: "mock", localLogin: false, oidcLogin: false };
+ else if (path === "/me") body = { issuer: "test", subject: "admin", displayName: "Review administrator", isAdmin: true,
+ roles: ["admin"], permissions: ["session.use", "session.read_all", "session.manage_all", "database.manage", "workspace.manage", "workspace.secrets.manage", "memory.manage", "evidence.manage", "pi.manage"], csrfToken: null, session: null };
+ else if (path === "/settings") body = { workspace, provider: model.provider, model: model.id, thinking: "high" };
+ else if (path === "/models") body = { models: [model] };
+ else if (path === "/workspaces") body = [workspaceSummaryFixture(workspace, { displayName: title })];
+ else if (path === `/workspaces/${workspace}`) body = { workspace: canonicalWorkspaceFixture(workspace), revision };
+ else if (path.endsWith("/runtime-configuration")) body = { workspaceId: workspace, revision, configurationState: "ready", requirements: [] };
+ else if (path.endsWith("/preprocessing")) body = { schemaVersion: 1, workspaceId: workspace, state: "ready", actionable: true, clearable: true,
+ detail: "Catalog revision 1 is indexed.", metadataRevision: 1, preprocessedMetadataRevision: 1 };
+ else if (path === "/workspace-registry/status") body = { branch: "main", ahead: 0, behind: 0, degraded: false };
+ else if (path.endsWith("/memory/pending")) body = [];
+ else if (path.endsWith("/memory")) body = { items: [], total: 0, page: 1, page_size: 25 };
+ else if (path.endsWith("/evidence")) body = evidencePage;
+ else if (path.includes("/evidence/")) body = { ...evidencePage, item: evidence };
+ else if (path === "/pi-management/status") body = { ready: true, credentials: "present", hostPlatform: "macos", version: "0.80.3",
+ config: { provider: model.provider, model: model.id, reasoning: "high" } };
+ else if (path === "/sessions") body = [{ id: "archived-fixture", status: "finalized", question: "How many eligible patients?", name: "Cohort review",
+ archived: true, active: false, workspace, created_at: "2026-09-01T12:00:00Z", updated_at: null, author: null, group: null, summary: null }];
+ else if (path.endsWith("/documents")) body = [{ key: "question", title: "Original question", phase: "F1", format: "markdown", content: "# Cohort review\n\nHow many eligible patients were admitted in 2025?" }];
+ else if (path === "/health/dwh") body = { ok: true, detail: "Available" };
+ else if (path === "/catalog/databases") body = [];
+ else if (path === "/catalog/metrics") body = { scope: "global", databaseId: null, tables: 0, columns: 0, sensitiveColumns: 0, relationships: 0,
+ descriptionTargets: 0, describedTargets: 0, descriptionCoverage: 0, updatedAt: null };
+ else if (path === "/catalog/metadata-generation/models") body = { models: [], default: null };
+ else if (path.endsWith("-runs")) body = [];
+ else return route.fulfill({ status: 404, json: { message: `Missing visual fixture: ${path}` } });
+ return route.fulfill({ json: body });
+ });
+ return writes;
+}
+
+async function navigation(page: Page) {
+ const trigger = page.getByRole("button", { name: "Navigation", exact: true });
+ if (await trigger.isVisible()) await trigger.click();
+}
+
+async function admin(page: Page, name: string) {
+ await navigation(page);
+ const toggle = page.getByRole("button", { name: "Administration", exact: true });
+ if (await toggle.getAttribute("aria-expanded") !== "true") await toggle.click();
+ await page.getByRole("button", { name, exact: true }).click();
+}
+
+async function inspect(page: Page) {
+ return page.evaluate(() => {
+ const visible = (e: Element) => {
+ const box = e.getBoundingClientRect();
+ return box.width > 0 && box.height > 0 && getComputedStyle(e).visibility !== "hidden" && !e.closest("[hidden]");
+ };
+ return {
+ overflow: document.documentElement.scrollWidth - innerWidth,
+ serif: [...document.querySelectorAll("h1,h2,h3,h4,button,label")].filter(visible)
+ .filter(e => /Fraunces|Georgia|Times|ui-serif/.test(getComputedStyle(e).fontFamily)).map(e => e.textContent?.slice(0,60)),
+ tiny: [...document.querySelectorAll("h1,h2,h3,h4,button,label,small")].filter(visible)
+ .filter(e => parseFloat(getComputedStyle(e).fontSize) < 12).map(e => e.textContent?.slice(0,60)),
+ };
+ });
+}
+
+for (const width of [390, 1280]) {
+ test(`full shell keeps the visual revision across language and theme changes at ${width}px`, async ({ page }) => {
+ await page.setViewportSize({ width, height: 1000 });
+ const writes = await fixtures(page);
+ await page.goto("/");
+ const header = page.locator(".thot-full-header");
+ await expect(header).toBeVisible();
+ await page.evaluate(() => document.fonts.ready);
+ expect(await page.evaluate(() => [...document.fonts].some(font =>
+ font.family.includes("Manrope Variable") && font.status === "loaded",
+ ))).toBe(true);
+ const layout = await page.locator(".thot-context-layout").boundingBox();
+ expect(layout!.x).toBeGreaterThanOrEqual(20);
+ expect(Math.abs(layout!.x - (width - layout!.x - layout!.width))).toBeLessThan(1);
+ await admin(page, "Database");
+ await expect(page.getByRole("heading", { name: "Database management", exact: true })).toBeVisible();
+ await header.getByRole("combobox").selectOption("it");
+ await expect(page.getByRole("heading", { name: "Gestione database", exact: true })).toBeVisible();
+ await expect(page.locator(".thot-administration-eyebrow")).toHaveText("Amministrazione");
+ await expect(page.locator(".thot-context-summary small")).toHaveText("Contesto di lavoro");
+ await page.getByRole("button", { name: "Usa il tema scuro", exact: true }).click();
+ await expect(page.locator(".thot-host")).toHaveAttribute("data-theme", "dark");
+ expect(await inspect(page)).toEqual({ overflow: 0, serif: [], tiny: [] });
+ await page.reload();
+ await expect(page.getByRole("heading", { name: "Gestione database", exact: true })).toBeVisible();
+ await expect(header.getByRole("combobox")).toHaveValue("it");
+ await expect(page.locator(".thot-host")).toHaveAttribute("data-theme", "dark");
+ await page.getByRole("button", { name: "Usa il tema chiaro", exact: true }).click();
+ await header.getByRole("combobox").selectOption("en");
+ await expect(page.getByRole("heading", { name: "Database management", exact: true })).toHaveCSS("font-size", "24px");
+ expect(await inspect(page)).toEqual({ overflow: 0, serif: [], tiny: [] });
+ expect(writes).toEqual([]);
+ });
+}
+
+for (const route of ["/", "/?thoth_route=administration%2Fdatabase"]) {
+ test(`Core prompt remains readable after loading ${route}`, async ({ page }, testInfo) => {
+ const writes = await fixtures(page);
+ await page.goto(route);
+ if (route !== "/") {
+ await navigation(page);
+ await page.getByRole("button", { name: "Return to session", exact: true }).click();
+ }
+ const prompt = page.getByRole("textbox", { name: "New question", exact: true });
+ await expect(prompt).toBeVisible();
+ await prompt.focus();
+ const readable = async () => {
+ await expect.poll(() => prompt.evaluate(el => {
+ const style = getComputedStyle(el);
+ return el.clientHeight >= parseFloat(style.lineHeight) + parseFloat(style.paddingTop) + parseFloat(style.paddingBottom);
+ })).toBe(true);
+ };
+ await readable();
+ await expect(prompt).toHaveCSS("outline-style", "none");
+ await page.screenshot({ path: testInfo.outputPath("Prompt-focused.png") });
+ // Full-mode gutters can wrap the empty placeholder on a narrow viewport.
+ // Compare clearing with that same viewport's initial height, not a single-line constant.
+ await page.setViewportSize({ width: 390, height: 900 });
+ await readable();
+ const emptyHeight = await prompt.evaluate(el => el.clientHeight);
+ await prompt.fill("First line");
+ await prompt.press("Shift+Enter");
+ await prompt.press("a");
+ await expect(prompt).toHaveValue("First line\na");
+ await expect.poll(() => prompt.evaluate(el => el.clientHeight)).toBeGreaterThan(40);
+ const question = "Compare eligible patients across the available cohorts. ".repeat(30);
+ await prompt.fill(question);
+ await page.setViewportSize({ width: 390, height: 900 });
+ await readable();
+ await expect.poll(() => prompt.evaluate(el => el.clientHeight)).toBe(160);
+ expect(await prompt.evaluate(el => el.scrollHeight > el.clientHeight)).toBe(true);
+ await admin(page, "Database");
+ await navigation(page);
+ await page.getByRole("button", { name: "Return to session", exact: true }).click();
+ await expect(prompt).toHaveValue(question);
+ await readable();
+ await page.screenshot({ path: testInfo.outputPath("Prompt-multiline-mobile.png") });
+ await prompt.fill("");
+ await readable();
+ await expect.poll(() => prompt.evaluate(el => el.clientHeight)).toBe(emptyHeight);
+ expect(writes).toEqual([]);
+ });
+}
+
+for (const width of [390, 649, 768, 1280, 1600]) {
+ test(`all surfaces retain shared typography at ${width}px`, async ({ page }, testInfo) => {
+ await page.setViewportSize({ width, height: 1000 });
+ const writes = await fixtures(page);
+ await page.goto("/");
+ await expect(page.getByTestId("app-shell")).toBeVisible();
+ await expect(page.getByRole("button", { name: /Working context/ })).toContainText(title);
+ for (const name of ["Workspace", "Database", "Memory", "Evidence", "Pi configuration"]) {
+ await admin(page, name);
+ const heading = page.getByRole("heading", { name: `${name === "Pi configuration" ? "Pi" : name} management`, exact: true });
+ await expect(heading).toBeVisible();
+ await expect(heading).toHaveCSS("font-size", "24px");
+ expect(await inspect(page)).toEqual({ overflow: 0, serif: [], tiny: [] });
+ if (name === "Memory") await expect(page.getByText("No memory cards yet.", { exact: false })).toBeVisible();
+ if (name === "Database") {
+ const statuses = page.locator(".thot-fleet-ledger__header-status .thot-fleet-ledger__status-item");
+ await expect(statuses).toHaveCount(3);
+ const catalog = await statuses.nth(0).boundingBox();
+ const operations = await statuses.nth(1).boundingBox();
+ const metadata = await statuses.nth(2).boundingBox();
+ const summary = await page.locator(".thot-fleet-ledger__kpi-section > h2").boundingBox();
+ const summaryBlock = await page.locator(".thot-fleet-ledger__kpi-section").boundingBox();
+ const navigationBlock = await page.locator(".thot-fleet-ledger__navigation").boundingBox();
+ const gridBlock = await page.locator(".thot-fleet-ledger__content").boundingBox();
+ const databasesLabel = await page.locator(".thot-fleet-ledger__navigation").getByText("Databases", { exact: true }).boundingBox();
+ const tablesLabel = await page.locator(".thot-fleet-ledger__kpi-label").getByText("Tables", { exact: true }).boundingBox();
+ expect(Math.abs(summaryBlock!.x - gridBlock!.x)).toBeLessThan(1);
+ expect(Math.abs(navigationBlock!.x - gridBlock!.x)).toBeLessThan(1);
+ expect(Math.abs(summary!.x - databasesLabel!.x)).toBeLessThan(1);
+ expect(Math.abs(summary!.x - tablesLabel!.x)).toBeLessThan(1);
+ const gridLabel = await page.locator(".thot-fleet-grid-toolbar").getByText("Workspace databases", { exact: true }).boundingBox();
+ expect(Math.abs(summary!.x - gridLabel!.x)).toBeLessThan(1);
+ expect(Math.abs(summaryBlock!.width - gridBlock!.width)).toBeLessThan(1);
+ expect(Math.abs(navigationBlock!.width - gridBlock!.width)).toBeLessThan(1);
+ const contextTrigger = page.getByRole("button", { name: /Working context/ });
+ await contextTrigger.click();
+ const contextBody = page.locator(".thot-context-body");
+ await expect(contextBody).toBeVisible();
+ await expect(contextBody).not.toContainText("Your last choices take precedence");
+ await expect(contextBody).not.toContainText("Installation default");
+ await expect(contextBody).not.toContainText("Last choice");
+ const contextBlock = await contextBody.boundingBox();
+ const workspaceSelect = await contextBody.getByRole("combobox", { name: "Workspace", exact: true }).boundingBox();
+ expect(Math.abs(contextBlock!.x - summaryBlock!.x)).toBeLessThan(1);
+ expect(Math.abs(workspaceSelect!.x - summary!.x)).toBeLessThan(1);
+ expect(await inspect(page)).toEqual({ overflow: 0, serif: [], tiny: [] });
+ await page.screenshot({ path: testInfo.outputPath("Context-expanded.png") });
+ await contextBody.getByRole("button", { name: "Done", exact: true }).click();
+ expect(Math.abs(catalog!.x - summary!.x)).toBeLessThan(1);
+ const workArea = await page.locator(".thot-fleet-ledger__workspace").boundingBox();
+ if (workArea!.width >= 768) {
+ const coverage = await page.locator(".thot-fleet-ledger__kpi-label").filter({ hasText: "Description coverage" }).boundingBox();
+ expect(Math.abs(metadata!.x - coverage!.x)).toBeLessThan(1);
+ expect(Math.abs(operations!.x - (catalog!.x + metadata!.x) / 2)).toBeLessThan(1);
+ }
+ for (const status of await statuses.all()) {
+ const label = await status.locator(".thot-fleet-ledger__status-label > span:first-child").boundingBox();
+ const mark = await status.locator(".thot-fleet-ledger__status-mark").boundingBox();
+ const value = await status.locator(".thot-fleet-ledger__status-value").boundingBox();
+ expect(mark!.x - (label!.x + label!.width)).toBeGreaterThanOrEqual(7);
+ expect(Math.abs(label!.x - value!.x)).toBeLessThan(1);
+ }
+ }
+ if (name === "Evidence") {
+ const search = await page.getByRole("textbox", { name: "Search Evidence" }).boundingBox();
+ expect(search!.width).toBeGreaterThan(180);
+ }
+ await page.screenshot({ path: testInfo.outputPath(`${name.replaceAll(" ", "-")}.png`) });
+ }
+ await page.getByRole("button", { name: "Host maintenance", exact: true }).click();
+ await expect(page.getByRole("tab", { name: "macOS", exact: true })).toHaveAttribute("aria-selected", "true");
+ await expect(page.getByRole("region", { name: "Pi operator workflow" })).toHaveCSS("font-size", "16px");
+ await page.screenshot({ path: testInfo.outputPath("Pi-guide.png") });
+ await navigation(page);
+ await page.getByRole("tab", { name: "All sessions", exact: true }).click();
+ await expect(page.locator(".thot-wordmark--sidebar")).toHaveCSS("font-size", "32px");
+ await page.getByRole("button", { name: /Archive \(1\)/ }).click();
+ await page.getByRole("button", { name: "Cohort review", exact: true }).click();
+ const documents = page.getByRole("complementary", { name: "Session summary" });
+ await expect(documents).toBeVisible();
+ await expect(documents.getByRole("heading", { name: "Original question" })).toBeVisible();
+ const bounds = await documents.boundingBox();
+ expect(bounds!.width).toBeGreaterThanOrEqual(Math.min(width, 300));
+ expect(await inspect(page)).toEqual({ overflow: 0, serif: [], tiny: [] });
+ await page.screenshot({ path: testInfo.outputPath("Sessions.png") });
+ await page.getByRole("button", { name: "Close panel", exact: true }).click();
+ await expect(page.getByRole("textbox", { name: "New question", exact: true })).toBeVisible();
+ await expect(page.locator(".thot-wordmark--core")).toHaveCSS("font-size", "48px");
+ await page.screenshot({ path: testInfo.outputPath("Core.png") });
+ expect(writes).toEqual([]);
+ });
+}
+
+test("theme follows the app, not an unrelated OS preference; keyboard tabs and dirty guard remain", async ({ page }, testInfo) => {
+ await page.setViewportSize({ width: 1280, height: 900 });
+ const writes = await fixtures(page);
+ await page.emulateMedia({ colorScheme: "dark" });
+ await page.goto("/");
+ await expect(page.getByTestId("app-shell")).toBeVisible();
+ await expect(page.getByRole("banner", { name: "Application header" })).toBeVisible();
+ await admin(page, "Pi configuration");
+ const testButton = page.getByRole("button", { name: "Test catalog default", exact: true });
+ await expect(testButton).toHaveCSS("background-color", "oklch(0.9985 0.0006 17.2)");
+ await page.getByRole("button", { name: "Use dark theme", exact: true }).click();
+ await expect(page.locator(".thot-context-trigger")).toHaveCSS("color", "oklch(0.931 0 90)");
+ await expect(testButton).toHaveCSS("background-color", "oklch(0.62 0.008 23.2 / 0.3)");
+ await page.screenshot({ path: testInfo.outputPath("Pi-dark.png") });
+ const guideButton = page.getByRole("button", { name: "Host maintenance", exact: true });
+ await guideButton.click();
+ const mac = page.getByRole("tab", { name: "macOS", exact: true });
+ await mac.focus(); await page.keyboard.press("ArrowRight");
+ await expect(page.getByRole("tab", { name: "Windows", exact: true })).toBeFocused();
+ await expect(page.getByRole("tab", { name: "Windows", exact: true })).toHaveAttribute("aria-selected", "true");
+ await admin(page, "Memory");
+ await page.getByRole("button", { name: "New card", exact: true }).click();
+ await page.getByRole("textbox", { name: "Title", exact: true }).fill("Keep this draft");
+ await page.getByRole("button", { name: "Return to session", exact: true }).click();
+ await expect(page.getByRole("textbox", { name: "Title", exact: true })).toHaveValue("Keep this draft");
+ await page.screenshot({ path: testInfo.outputPath("Memory-dark-unsaved.png") });
+ await page.getByRole("button", { name: "Cancel", exact: true }).click();
+ await page.getByRole("button", { name: "Return to session", exact: true }).click();
+ await expect(page.getByRole("textbox", { name: "New question", exact: true })).toBeVisible();
+ expect(writes).toEqual([]);
+});
+
+test("host header and left rail leave the application a bounded working area", async ({ page }, testInfo) => {
+ await page.setViewportSize({ width: 1280, height: 1000 });
+ await fixtures(page, "embedded");
+ await page.goto("/");
+ await expect(page.getByTestId("app-shell")).toBeVisible();
+ await expect(page.locator(".thot-full-header")).toHaveCount(0);
+ // Geometry fixture, not a replacement for acceptance inside the real Omics deployment.
+ await page.addStyleTag({ content: `
+ body { margin: 0; }
+ #root { margin-left: 240px; margin-top: 72px; --thoth-app-height: calc(100dvh - 72px); }
+ .px-4 { padding-left: 2.25rem !important; padding-right: 2.25rem !important; }
+ ` });
+ await admin(page, "Workspace");
+ const shell = await page.getByTestId("app-shell").boundingBox();
+ expect(shell!.x).toBe(240);
+ expect(shell!.x + shell!.width).toBeLessThanOrEqual(1280);
+ expect(shell!.y + shell!.height).toBeLessThanOrEqual(1000);
+ expect(await inspect(page)).toEqual({ overflow: 0, serif: [], tiny: [] });
+ await page.screenshot({ path: testInfo.outputPath("Host-bounded-Workspace.png") });
+ await admin(page, "Evidence");
+ const search = await page.getByRole("textbox", { name: "Search Evidence" }).boundingBox();
+ expect(search!.width).toBeGreaterThan(180);
+ expect(await inspect(page)).toEqual({ overflow: 0, serif: [], tiny: [] });
+});
diff --git a/frontend/index.html b/frontend/index.html
index 07fe9ee2..c753c8b9 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -4,12 +4,6 @@
ThothII
-
-
-
diff --git a/frontend/package-lock.json b/frontend/package-lock.json
index ea95bad0..09b7bc45 100644
--- a/frontend/package-lock.json
+++ b/frontend/package-lock.json
@@ -9,6 +9,7 @@
"@ag-grid-community/locale": "36.0.0",
"@base-ui/react": "^1.6.0",
"@fontsource-variable/geist": "^5.2.9",
+ "@fontsource-variable/manrope": "5.3.0",
"@tanstack/react-query": "^5.59.0",
"ag-grid-community": "^36.0.0",
"ag-grid-react": "^36.0.0",
@@ -1491,6 +1492,15 @@
"url": "https://github.com/sponsors/ayuhito"
}
},
+ "node_modules/@fontsource-variable/manrope": {
+ "version": "5.3.0",
+ "resolved": "https://registry.npmjs.org/@fontsource-variable/manrope/-/manrope-5.3.0.tgz",
+ "integrity": "sha512-6D5dgokHsWDDMtmXHznKa0hK229NN+1a4BLPmUCLqcO1Pw5EEhWY5RFt0AcXnVRAljFFPfRtLkJePQj6LSsV6g==",
+ "license": "OFL-1.1",
+ "funding": {
+ "url": "https://github.com/sponsors/ayuhito"
+ }
+ },
"node_modules/@hono/node-server": {
"version": "1.19.17",
"resolved": "https://registry.npmjs.org/@hono/node-server/-/node-server-1.19.17.tgz",
diff --git a/frontend/package.json b/frontend/package.json
index e94c4bc7..f7a7a262 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -21,6 +21,7 @@
"@ag-grid-community/locale": "36.0.0",
"@base-ui/react": "^1.6.0",
"@fontsource-variable/geist": "^5.2.9",
+ "@fontsource-variable/manrope": "5.3.0",
"@tanstack/react-query": "^5.59.0",
"ag-grid-community": "^36.0.0",
"ag-grid-react": "^36.0.0",
diff --git a/frontend/playwright.visual.config.ts b/frontend/playwright.visual.config.ts
new file mode 100644
index 00000000..749d0083
--- /dev/null
+++ b/frontend/playwright.visual.config.ts
@@ -0,0 +1,16 @@
+import { defineConfig, devices } from "@playwright/test";
+
+export default defineConfig({
+ testDir: "./e2e",
+ testMatch: "ui-visual-review.spec.ts",
+ timeout: 45_000,
+ workers: 2,
+ outputDir: "test-results/visual-review",
+ use: { ...devices["Desktop Chrome"], baseURL: "http://127.0.0.1:5183", trace: "retain-on-failure" },
+ webServer: {
+ command: "npm run dev -- --host 127.0.0.1 --port 5183 --strictPort",
+ url: "http://127.0.0.1:5183",
+ reuseExistingServer: !process.env.CI,
+ env: { VITE_BACKEND_URL: "/api" },
+ },
+});
diff --git a/frontend/src/components/ErrorBoundary.tsx b/frontend/src/components/ErrorBoundary.tsx
index f1e816b3..490a2546 100644
--- a/frontend/src/components/ErrorBoundary.tsx
+++ b/frontend/src/components/ErrorBoundary.tsx
@@ -89,8 +89,9 @@ function DefaultFallback({
{error.message && (
- {translate("Details")}
-
+ {translate("Details")}
+
+
{error.message}
diff --git a/frontend/src/components/ui/button.tsx b/frontend/src/components/ui/button.tsx
index 67f606aa..68c3ea78 100644
--- a/frontend/src/components/ui/button.tsx
+++ b/frontend/src/components/ui/button.tsx
@@ -25,8 +25,8 @@ const buttonVariants = cva(
default:
"h-8 gap-1.5 px-3.5 has-data-[icon=inline-end]:pr-2.5 has-data-[icon=inline-start]:pl-2.5",
xs: "h-6 gap-1 px-2.5 text-xs has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3",
- sm: "h-7 gap-1 px-3 text-[0.8rem] has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2 [&_svg:not([class*='size-'])]:size-3.5",
- lg: "h-10 gap-1.5 px-5 text-[0.9rem] has-data-[icon=inline-end]:pr-3.5 has-data-[icon=inline-start]:pl-3.5",
+ sm: "h-8 gap-1.5 px-3 text-sm has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2 [&_svg:not([class*='size-'])]:size-3.5",
+ lg: "h-10 gap-1.5 px-5 text-sm has-data-[icon=inline-end]:pr-3.5 has-data-[icon=inline-start]:pl-3.5",
icon: "size-8",
"icon-xs": "size-6 [&_svg:not([class*='size-'])]:size-3",
"icon-sm": "size-7",
diff --git a/frontend/src/i18n/locales/it-admin.ts b/frontend/src/i18n/locales/it-admin.ts
index 83fe03c0..607cb022 100644
--- a/frontend/src/i18n/locales/it-admin.ts
+++ b/frontend/src/i18n/locales/it-admin.ts
@@ -1,5 +1,18 @@
// English gettext message IDs. Workspace content, SQL and identifiers are never translated.
export const itAdmin: Record = {
+ "Import sources, then review proposed changes before activation.": "Importa le fonti, poi rivedi le modifiche proposte prima dell'attivazione.",
+ "Which sources are imported?": "Quali fonti vengono importate?",
+ "Place new Markdown drafts in": "Inserisci le nuove bozze Markdown in",
+ ". Import also checks original local documents and configured remote sources. Review changes before they enter recall.": ". L'importazione controlla anche i documenti locali originali e le fonti remote configurate. Rivedi le modifiche prima che diventino disponibili per il recupero delle conoscenze.",
+ "No memory cards yet. Create a card to add reusable knowledge.": "Non ci sono ancora schede di memoria. Crea una scheda per aggiungere conoscenze riutilizzabili.",
+ "Run these commands on the installation host. Choose its operating system.": "Esegui questi comandi sul computer dell'installazione. Scegli il suo sistema operativo.",
+ "Used for Core and Administration when no model has been chosen. The test below checks this default, not your current selection.": "Usato per Core e Amministrazione quando non è stato scelto un modello. Il test qui sotto verifica questo modello predefinito, non la selezione corrente.",
+ "Change the installation default": "Cambia il modello predefinito dell'installazione",
+ "Update": "Aggiorna",
+ "in the installation YAML, then reload Pi. See Host maintenance for instructions.": "nel file YAML dell'installazione, poi ricarica Pi. Le istruzioni sono in Manutenzione host.",
+ "Available models": "Modelli disponibili",
+ "Choose your working model in the context bar. Each enabled model should be verified for both Core and Administration.": "Scegli il modello di lavoro nella barra del contesto. Ogni modello abilitato deve essere verificato sia per Core sia per Amministrazione.",
+ "Catalog summary": "Riepilogo del catalogo",
"{database}: {diagnostic}": "{database}: {diagnostic}",
"{succeeded} succeeded. Failed: {databases}.": "{succeeded} riuscite. Non riuscite: {databases}.",
"{count} of {total}": "{count} di {total}",
diff --git a/frontend/src/i18n/locales/it-core.ts b/frontend/src/i18n/locales/it-core.ts
index 860b00f6..9feebd19 100644
--- a/frontend/src/i18n/locales/it-core.ts
+++ b/frontend/src/i18n/locales/it-core.ts
@@ -1,4 +1,6 @@
export const itCore: Record = {
+ "Type your question below. Review each step before creating your datamart.": "Scrivi la domanda qui sotto. Rivedi ogni passaggio prima di creare il datamart.",
+ "Working context": "Contesto di lavoro",
"Session startup failed. Check configuration and connectivity, then Resume the session.": "Avvio della sessione non riuscito. Controlla configurazione e connessione, quindi riprendi la sessione.",
"Session services are not ready. Check configuration and connectivity, then try again.": "I servizi della sessione non sono pronti. Controlla configurazione e connessione, quindi riprova.",
"Session could not be resumed. Check configuration and connectivity, then try again.": "Impossibile riprendere la sessione. Controlla configurazione e connessione, quindi riprova.",
diff --git a/frontend/src/index.css b/frontend/src/index.css
index a08f4e89..c360856a 100644
--- a/frontend/src/index.css
+++ b/frontend/src/index.css
@@ -10,7 +10,7 @@
body.thot-full-document { margin: 0; }
/*
- * GSD theme — mirrors the Omics Portal design system (Manrope + Fraunces, warm
+ * Product theme — shares the Omics Portal identity (Manrope, warm
* off-white surfaces, #cb333b red). Tokens are RAW OKLCH triplets (L C H) so the
* Tailwind v3 config can wrap them as `oklch(var(--token) / )` and
* opacity utilities (bg-primary/80, …) keep working. Dark tokens follow either a
@@ -20,9 +20,14 @@ body.thot-full-document { margin: 0; }
@layer base {
#root, [data-base-ui-portal] {
color-scheme: light;
- --font-sans: "Manrope", -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, Arial, sans-serif;
- --font-heading: "Fraunces", "Source Serif Pro", Georgia, "Times New Roman", serif;
+ --font-sans: "Manrope Variable", "Manrope", -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, Arial, sans-serif;
+ --font-heading: var(--font-sans);
--font-mono: ui-monospace, "SF Mono", "Cascadia Code", Menlo, Consolas, monospace;
+ --text-page: 1.5rem;
+ --text-section: 1.25rem;
+ --text-body: 1rem;
+ --text-control: 0.875rem;
+ --text-meta: 0.75rem;
/* Layered elevation, tinted with the foreground hue so depth reads warm on
warm surfaces. Borders mark structure; shadows mark elevation. */
@@ -49,11 +54,11 @@ body.thot-full-document { margin: 0; }
--destructive: 0.5587 0.1881 23.2;
--destructive-foreground: 0.9918 0.0011 17.2;
--border: 0.9093 0.0035 354.7;
- --input: 0.9093 0.0035 354.7;
+ --input: 0.64 0.008 354.7;
--ring: 0.5587 0.1881 23.2;
- --success: 0.7577 0.1581 165.0;
- --warning: 0.8523 0.1386 78.9;
- --info: 0.7035 0.1128 221.3;
+ --success: 0.46 0.095 160;
+ --warning: 0.48 0.09 70;
+ --info: var(--muted-foreground);
/* Current navigation shares Instrument Red's hue, with lower chroma and
higher lightness so selection reads as a muted location signal. */
--nav-active: 0.9250 0.0520 23.2;
@@ -80,8 +85,8 @@ body.thot-full-document { margin: 0; }
--card-foreground: 0.9310 0 90;
--popover: 0.2350 0 90;
--popover-foreground: 0.9310 0 90;
- --primary: 0.6023 0.1848 20.3;
- --primary-foreground: 0.9310 0 90;
+ --primary: 0.73 0.15 23.2;
+ --primary-foreground: 0.2178 0.005 23.2;
--primary-hover: 0.6897 0.1779 16.9;
--secondary: 0.2972 0 90;
--secondary-foreground: 0.9310 0 90;
@@ -89,11 +94,13 @@ body.thot-full-document { margin: 0; }
--muted-foreground: 0.7826 0 90;
--accent: 0.3485 0 90;
--accent-foreground: 0.9310 0 90;
- --destructive: 0.6023 0.1848 20.3;
+ --destructive: 0.73 0.15 23.2;
--destructive-foreground: 0.9310 0 90;
--border: 0.3715 0 90;
- --input: 0.3715 0 90;
+ --input: 0.62 0.008 23.2;
--ring: 0.6897 0.1779 16.9;
+ --success: 0.78 0.10 160;
+ --warning: 0.82 0.10 75;
--nav-active: 0.3350 0.0550 20.3;
--nav-active-hover: 0.3750 0.0650 20.3;
--nav-active-foreground: 0.8900 0.0700 20.3;
@@ -150,7 +157,22 @@ body.thot-full-document { margin: 0; }
font-feature-settings: "ss01", "cv11";
}
- :where(#root, [data-base-ui-portal]) :is(h1, h2, h3, h4) {
+ :where(#root, [data-base-ui-portal]) :is(input, textarea)::placeholder {
+ color: oklch(var(--muted-foreground));
+ opacity: 1;
+ }
+
+ :where(#root, [data-base-ui-portal]) :is(button, input, select, textarea, summary):focus-visible {
+ outline: 2px solid oklch(var(--ring));
+ outline-offset: 2px;
+ }
+
+ /* The composer already exposes keyboard focus on its enclosing focus-within frame. */
+ #root textarea.thot-composer-input:focus-visible {
+ outline: none;
+ }
+
+ :where(#root, [data-base-ui-portal]) :where(h1, h2, h3, h4, h5, h6) {
font-family: var(--font-heading);
font-optical-sizing: auto;
letter-spacing: -0.015em;
@@ -221,8 +243,8 @@ body.thot-full-document { margin: 0; }
}
.thot-full-header__brand { font: 600 1.25rem/1.2 var(--font-heading); }
.thot-full-header__controls { display: flex; align-items: center; flex-wrap: wrap; gap: 0.25rem; min-width: 0; }
- .thot-full-header__user { max-width: 15rem; min-width: 0; font-size: 0.8125rem; }
- .thot-full-header__error { flex-basis: 100%; font-size: 0.8125rem; color: oklch(var(--destructive)); }
+ .thot-full-header__user { max-width: 15rem; min-width: 0; font-size: var(--text-control); }
+ .thot-full-header__error { flex-basis: 100%; font-size: var(--text-control); color: oklch(var(--destructive)); }
.thot-shell-select {
min-height: 2rem;
max-width: 9rem;
@@ -231,7 +253,7 @@ body.thot-full-document { margin: 0; }
border-radius: var(--radius);
background: oklch(var(--background));
color: oklch(var(--foreground));
- font: 600 0.8125rem/1.5 var(--font-sans);
+ font: 600 var(--text-control)/1.5 var(--font-sans);
}
.thot-shell-select:focus-visible { outline: 3px solid oklch(var(--ring) / 0.5); outline-offset: 2px; }
.thot-user-menu {
@@ -269,22 +291,21 @@ body.thot-full-document { margin: 0; }
padding: 0 1rem 0.75rem;
}
- /* Standard micro-label: panel headers, nav sections, meta rows. Set in the
- mono register so labels/meta read as a distinct typographic layer from the
- sans body prose (mono needs less tracking than the sans did). */
+ /* UI labels use the same family as controls; monospace is for technical data. */
.thot-label {
- font-family: var(--font-mono);
- font-size: 0.6875rem;
+ font-family: var(--font-sans);
+ font-size: var(--text-meta);
font-weight: 600;
- letter-spacing: 0.06em;
- text-transform: uppercase;
+ letter-spacing: normal;
+ text-transform: none;
color: oklch(var(--muted-foreground));
}
.thot-prose {
color: oklch(var(--foreground));
- font-size: 0.9375rem;
- line-height: 1.65;
+ font-size: var(--text-body);
+ line-height: 1.6;
+ overflow-wrap: anywhere;
}
.thot-prose > :first-child { margin-top: 0; }
.thot-prose > :last-child { margin-bottom: 0; }
@@ -296,9 +317,10 @@ body.thot-full-document { margin: 0; }
margin: 1.1em 0 0.5em;
letter-spacing: -0.01em;
}
- .thot-prose h1 { font-size: 1.45rem; }
- .thot-prose h2 { font-size: 1.2rem; }
- .thot-prose h3 { font-size: 1.02rem; }
+ .thot-prose h1 { font-size: var(--text-page); }
+ .thot-prose h2 { font-size: var(--text-section); }
+ .thot-prose h3 { font-size: var(--text-body); }
+ .thot-prose :where(p, ul, ol, blockquote) { max-width: 75ch; }
.thot-prose ul, .thot-prose ol { margin: 0.6em 0; padding-left: 1.3em; }
.thot-prose li { margin: 0.25em 0; }
.thot-prose a { color: oklch(var(--primary)); text-decoration: underline; text-underline-offset: 2px; }
@@ -320,8 +342,10 @@ body.thot-full-document { margin: 0; }
}
.thot-prose pre code { background: transparent; padding: 0; }
.thot-prose blockquote {
- border-left: 2px solid oklch(var(--border));
- padding-left: 0.9em;
+ border: 1px solid oklch(var(--border));
+ border-radius: var(--radius);
+ background: oklch(var(--muted) / 0.4);
+ padding: 0.75em 1em;
color: oklch(var(--muted-foreground));
margin: 0.7em 0;
}
@@ -339,10 +363,10 @@ body.thot-full-document { margin: 0; }
.thot-prose td { border-top: 1px solid oklch(var(--border) / 0.6); font-variant-numeric: tabular-nums; }
.thot-prose th {
background: oklch(var(--muted));
- font-size: 0.72rem;
+ font-size: var(--text-control);
font-weight: 600;
- letter-spacing: 0.06em;
- text-transform: uppercase;
+ letter-spacing: normal;
+ text-transform: none;
color: oklch(var(--muted-foreground));
}
.thot-activity-prose,
@@ -409,7 +433,7 @@ body.thot-full-document { margin: 0; }
.thot-database-grid, .thot-preview-grid,
:is(.thot-database-grid, .thot-preview-grid) .ag-theme-alpine {
--ag-font-family: var(--font-sans);
- --ag-font-size: 0.8125rem;
+ --ag-font-size: var(--text-control);
--ag-background-color: oklch(var(--card));
--ag-foreground-color: oklch(var(--foreground));
--ag-header-background-color: oklch(var(--muted) / 0.72);
diff --git a/frontend/src/main.tsx b/frontend/src/main.tsx
index 4bdfec2f..7ea4ff0b 100644
--- a/frontend/src/main.tsx
+++ b/frontend/src/main.tsx
@@ -1,6 +1,7 @@
import { StrictMode } from "react";
import { createRoot } from "react-dom/client";
import { App } from "./App";
+import "@fontsource-variable/manrope";
import "./index.css";
import "./widgets";
diff --git a/frontend/src/shell/AppShell.administration.test.tsx b/frontend/src/shell/AppShell.administration.test.tsx
index 505bdba3..1283627e 100644
--- a/frontend/src/shell/AppShell.administration.test.tsx
+++ b/frontend/src/shell/AppShell.administration.test.tsx
@@ -125,7 +125,7 @@ test("option A has one collapsible global context and preserves the Core draft a
renderShell();
const composer = await screen.findByRole("textbox", { name: /new question/i });
await userEvent.type(composer, "Keep my original Core question");
- await userEvent.click(screen.getByRole("button", { name: /WORKING CONTEXT/ }));
+ await userEvent.click(screen.getByRole("button", { name: /Working context/ }));
expect(screen.getAllByRole("combobox", { name: "Workspace" })).toHaveLength(1);
expect(screen.getAllByRole("combobox", { name: "Model" })).toHaveLength(1);
await userEvent.selectOptions(screen.getByRole("combobox", { name: "Workspace" }), "beta");
@@ -159,7 +159,7 @@ test("invalid remembered choices do not silently fall back and gate both Core an
test("workspace and model stay locked during Core and unlock after it finishes", async () => {
renderShell();
await screen.findByRole("textbox", { name: /new question/i });
- await userEvent.click(screen.getByRole("button", { name: /WORKING CONTEXT/ }));
+ await userEvent.click(screen.getByRole("button", { name: /Working context/ }));
act(() => useSessionStore.getState().setAgentActive(true));
expect(screen.getByRole("combobox", { name: "Workspace" })).toBeDisabled();
expect(screen.getByRole("combobox", { name: "Model" })).toBeDisabled();
@@ -182,7 +182,7 @@ test("dirty Memory blocks workspace and model changes, including after a failed
const page = await screen.findByRole("main", { name: "Memory management" });
await userEvent.click(within(page).getByRole("button", { name: "New card" }));
await userEvent.type(within(page).getByLabelText("Title"), "Do not lose this");
- await userEvent.click(screen.getByRole("button", { name: /WORKING CONTEXT/ }));
+ await userEvent.click(screen.getByRole("button", { name: /Working context/ }));
await userEvent.selectOptions(screen.getByRole("combobox", { name: "Workspace" }), "beta");
await userEvent.selectOptions(screen.getByRole("combobox", { name: "Model" }), "test/other");
expect(workspacePreferences.load()).toMatchObject({ workspaceId: "alpha", model: "test" });
@@ -240,7 +240,7 @@ test("a successful Memory save releases the navigation guard and the context loc
await userEvent.click(within(page).getByRole("button", { name: "New card" }));
await userEvent.type(within(page).getByLabelText("Title"), "Saved card");
await userEvent.type(within(page).getByLabelText("Scope"), "This workspace");
- await userEvent.click(screen.getByRole("button", { name: /WORKING CONTEXT/ }));
+ await userEvent.click(screen.getByRole("button", { name: /Working context/ }));
await userEvent.click(within(page).getByRole("button", { name: "Save card" }));
expect(screen.getByRole("combobox", { name: "Model" })).toBeDisabled();
await userEvent.click(screen.getByRole("button", { name: "Return to session" }));
@@ -257,7 +257,7 @@ test("Admin generation locks the context and Core submission across page navigat
renderShell(client);
const composer = await screen.findByRole("textbox", { name: /new question/i });
await userEvent.type(composer, "Wait for Admin to finish");
- await userEvent.click(screen.getByRole("button", { name: /WORKING CONTEXT/ }));
+ await userEvent.click(screen.getByRole("button", { name: /Working context/ }));
await act(async () => {
client.setQueryData(["description-generation-runs", 50], [{ id: "r1", status: "running" }]);
});
diff --git a/frontend/src/shell/AppShell.auth.test.tsx b/frontend/src/shell/AppShell.auth.test.tsx
index e1375924..0ae00502 100644
--- a/frontend/src/shell/AppShell.auth.test.tsx
+++ b/frontend/src/shell/AppShell.auth.test.tsx
@@ -65,7 +65,7 @@ describe("authenticated shell permissions", () => {
const memory = screen.getByRole("main", { name: "Memory management" });
expect(memory).toBeVisible();
expect(within(memory).queryByRole("combobox", { name: "Workspace" })).not.toBeInTheDocument();
- await userEvent.click(screen.getByRole("button", { name: /WORKING CONTEXT/ }));
+ await userEvent.click(screen.getByRole("button", { name: /Working context/ }));
expect(screen.getByRole("combobox", { name: "Workspace" })).toHaveValue("default");
});
test("does not use the legacy installation default as a preprocessing workspace", async () => {
diff --git a/frontend/src/shell/AppShell.new-session.test.tsx b/frontend/src/shell/AppShell.new-session.test.tsx
index d0df2552..ca8f73f6 100644
--- a/frontend/src/shell/AppShell.new-session.test.tsx
+++ b/frontend/src/shell/AppShell.new-session.test.tsx
@@ -177,7 +177,7 @@ test("model selector shows the three Pi-enabled models and stores the selected p
renderShell();
await screen.findByRole("textbox", { name: /new question/i });
- await userEvent.click(screen.getByRole("button", { name: /WORKING CONTEXT/ }));
+ await userEvent.click(screen.getByRole("button", { name: /Working context/ }));
const select = screen.getByRole("combobox", { name: "Model" });
await waitFor(() => {
expect(within(select).getAllByRole("option").map((option) => option.textContent)).toEqual([
diff --git a/frontend/src/shell/AppShell.session-mgmt.test.tsx b/frontend/src/shell/AppShell.session-mgmt.test.tsx
index 388e3bcc..7641568f 100644
--- a/frontend/src/shell/AppShell.session-mgmt.test.tsx
+++ b/frontend/src/shell/AppShell.session-mgmt.test.tsx
@@ -36,13 +36,21 @@ const resumeResult = (id: string, alreadyActive = false) =>
class ControlledResizeObserver {
static instances: ControlledResizeObserver[] = [];
+ private targets = new Set();
constructor(private readonly callback: ResizeObserverCallback) {
ControlledResizeObserver.instances.push(this);
}
- observe = vi.fn();
- disconnect = vi.fn();
+ observe = vi.fn((target: Element) => { this.targets.add(target); });
+ disconnect = vi.fn(() => { this.targets.clear(); });
trigger() {
- this.callback([], this as unknown as ResizeObserver);
+ const entries: ResizeObserverEntry[] = [...this.targets].map(target => ({
+ target,
+ contentRect: new DOMRect(0, 0, target.clientWidth, target.clientHeight),
+ borderBoxSize: [],
+ contentBoxSize: [],
+ devicePixelContentBoxSize: [],
+ }));
+ if (entries.length) this.callback(entries, this as unknown as ResizeObserver);
}
}
diff --git a/frontend/src/shell/AppShell.tsx b/frontend/src/shell/AppShell.tsx
index c9e9a092..76df283e 100644
--- a/frontend/src/shell/AppShell.tsx
+++ b/frontend/src/shell/AppShell.tsx
@@ -884,7 +884,7 @@ export function AppShell({ canLogout }: AppShellProps) {
{activeSession?.question && (