12 KiB
title, date, supersedes, audience, status, repo-evidence
| title | date | supersedes | audience | status | repo-evidence | |||||
|---|---|---|---|---|---|---|---|---|---|---|
| Waggle DS Audit v2 — macOS-Style Desktop Paradigm Correction | 2026-04-23 | briefs/2026-04-23-ds-audit-honeycomb-and-stubs-findings.md (v1 misdiagnosed) | Marko (PM) — za paste u claude.ai/design chat (project ea934a60) | DRAFT audit findings v2 + paste-ready iteration prompt |
|
Korekcija na v1
v1 audit je proglasio Memories + ⌘K palette + left-sidebar-nav kao "solidan moderan OS shell" i preporučio da se ostalih 6 surfaces samo popune istim chrome-om. To je bilo pogrešno. Marko je već u Aprilu adjustao paradigmu ka "operating system design" i repo to dokumentuje crno-na-belo:
apps/web/src/components/os/apps/— kanonski folder sa 24 OS Apps (Chat, Memory, Files, Wiki, Settings, Marketplace, Cockpit, i ostale)apps/web/src/components/os/overlays/— overlay pattern za Onboarding i druge system-level panele- Tauri 2.0 = jedan native prozor koji wrapuje React web app; unutar tog native prozora živi desktop-metafora
- WAGGLE-SYSTEM-VISUAL.html arhitekturni diagram eksplicitno govori o User Layer kao Desktop sa Window paradigmom
Dakle trenutni DS mockup (left sidebar sa HIVE / SCOPES / SETTINGS i central Memories canvas) je zapravo Linear/Notion/Slack paradigma — SaaS dashboard, ne operating system. Zato je tvoja prva reakcija bila tačna: "app old UI/UX". Moja prva dijagnoza je zatvorila oči pred time jer je vizuelno polirano bilo i zvuči kao "cockpit" — ali cockpit nije chrome layout, cockpit je JEDNA od 24 OS aplikacija.
Šta kanonska paradigma stvarno znači
Unutar Tauri native prozora, Waggle treba da simulira macOS desktop:
Menubar na vrhu — sistemski meni levo (Waggle logo + File / Edit / View / Window / Help), status-cluster desno (provider pill + cost meter + policy indicator + sistemski čas + ⌘K spotlight trigger). Fiksiran, ne scroll-uje se.
Dock na dnu ili sa strane — 24 app ikonice, hover tooltip, running-app indicator ispod ikone, right-click za context menu, odvajač između system apps i user-pinned. Apps su: Chat, Memory, Files, Wiki, Settings, Marketplace, Cockpit, Graph, Agents, Provenance, Providers, Policy, Preferences, Skills, Scopes, Tasks, Timeline, Audit, Prompts, Search, Terminal, Notes, Export, About — 24 ukupno per repo evidence. Ne sve odmah MVP; prvi launch subset ali dock struktura mora podržati svih 24.
App windows — pravi draggable / resizable / minimizable / maximizable paneli koji se otvaraju kad user klik-ne app ikonu u dock-u. Title bar sa traffic-light dugmadima (close / minimize / maximize) levo (macOS konvencija), title centralno, app-specific controls desno. Z-order sa focus. Window state persist po session-u.
Desktop background — honeycomb texture PROMINENT (ne 8%, bliže 25-35% na background-u pošto je to brand defining moment). Opcionalno wallpaper per persona ili per scope kasnije, ali default je hive honeycomb.
⌘K palette — ostaje kao Spotlight equivalent (launch app / search memory / invoke command). Već je polirana u trenutnom DS-u, preživljava paradigm shift.
Overlays — OnboardingWizard, first-run tour, modal dialogs, global alerts, toast notifications. System-level layer iznad window-a a ispod palette-a.
Cockpit nije chrome, Cockpit je app — kad korisnik klikne Cockpit u dock-u, otvara se app window sa KPI-jima i agent activity (ono što trenutni mockup pokazuje kao "Memories surface"). Ali u pristojnoj paradigmi to je JEDAN window, nije šasija cele aplikacije.
Šta treba bri se odbaci iz trenutnog DS mockup-a
Levа HIVE / SCOPES / SETTINGS sidebar navigacija — ne ide. Scopes su filter (per-window), Settings je app (Preferences), HIVE elementi (Memories / Graph / Agents / Provenance) su 4 odvojene app ikonice u dock-u, ne navigation tree entries.
Central single-canvas Memories surface kao "main view" — ne ide. Memory je jedna app; kad je otvorena ona je window. User može da ima otvorena 3-4 app window-a istovremeno (Memory + Graph + Chat + Cockpit), tiled ili overlapping.
Fixed left sidebar "always visible" pattern — ne ide. macOS sidebar pattern postoji SAMO unutar app window-a (npr. Files app ima Finder-style sidebar za bookmarks), ne globalno na desktop-u.
Šta ostaje iz trenutnog DS rada
Design tokens — dark-first paleta, honey accent 400/500/600, typography scale, spacing scale, radii, elevation. Sve ratifikovano i koristi se; paradigm shift ne zahteva token overhaul.
⌘K palette component — Spotlight equivalent već izgleda dobro, samo promena konteksta (u pravom desktop-u ⌘K se otvara iznad svega, ne u sidebar overlay-u).
Bee textures + persona artwork — landing-only per LOCK (decisions/2026-04-22-landing-personas-ia-locked.md), ne injektovati u app chrome.
Typography i copy voice — voice (bee/hive/honey metaphor) zadržan, samo redistribuiran (menubar prazniji, dock tooltips brižniji, window title bars minimalistički).
Honeycomb texture — ažurirana preporuka
v1 preporuka (app-chrome 12-14% / empty-state 22-25% / footer 30%) je bila u pogrešnom kontekstu. Nova paradigma preraspoređuje gde texture živi:
- Desktop background (iza svih window-a) — 25-35% opacity, blend-mode overlay ili soft-light na dark base. Ovo je glavno mesto gde texture treba da PEVA.
- Window background (unutar app window-a) — 4-8% blago, dovoljno da se nasluti brand a ne ometa content density
- Empty states (kad app window nema podataka) — 15-20%, persona illustration accompanying
- Menubar / Dock chrome — 0% ili <3%, bez texture (chrome mora biti čist za legibility)
bees.html broken
Taj nalaz iz v1 ostaje validan bez izmene. Personas ostaju landing-only per LOCK; preview page mora da renderuje static grid of 13 bees kao DS reference. Fix identičan kao u v1.
Paste-ready iteration prompt v2 za DS chat
Kopiraj sledeći blok u claude.ai/design chat (project ea934a60), kao sledeću poruku. Ovo poništava prethodni prompt — novi chrome paradigm, ne iterativna popravka.
Važna korekcija paradigme. Trenutni mockup (Memories + ⌘K + left sidebar sa HIVE/SCOPES/SETTINGS) je SaaS dashboard layout. Waggle je "operating system" — konkretno macOS-style desktop UNUTAR jednog Tauri native window-a. Repo evidence:
- apps/web/src/components/os/apps/ = 24 OS Apps (Chat, Memory, Files, Wiki, Settings, Marketplace, Cockpit, Graph, Agents, Provenance, Providers, Policy, Preferences, Skills, Scopes, Tasks, Timeline, Audit, Prompts, Search, Terminal, Notes, Export, About)
- apps/web/src/components/os/overlays/ = system-level overlays (OnboardingWizard pattern)
- Cockpit NIJE chrome layout. Cockpit je JEDNA od 24 apps.
Odbaci left sidebar nav i central Memories canvas kao "main view". Redizajniraj chrome oko macOS paradigme:
1. MENUBAR (top, fixed) — Waggle logo levo, sistemski meniji (File / Edit / View / Window / Help), status cluster desno (active-provider pill, cost meter, policy indicator, sistemski sat, ⌘K spotlight trigger). Visina ~28-32px. Tanka, elegantna, bez texture.
2. DOCK (bottom ili side-left, toggleable) — ikonice 24 apps, hover tooltip sa app name, running indicator dot ispod aktivne ikone, right-click context menu (hide, quit, show in Finder-equivalent). Odvajač između system apps i user-pinned. Magnification hover effect opciono ali poželjno. Honey accent na active app indicator.
3. APP WINDOWS — pravi draggable / resizable / minimizable / maximizable paneli. Title bar sa traffic-light dugmadima (close / minimize / maximize) levo po macOS konvenciji, centralni title, app-specific controls desno. Z-order sa focus. Window shadow + subtle border radius. Multi-window moguć (npr. Memory + Graph + Cockpit otvoreni istovremeno, tiled ili overlapping).
4. DESKTOP BACKGROUND — honeycomb texture PROMINENT, 25-35% opacity sa blend-mode overlay ili soft-light. Ovo je brand-defining canvas. Per-scope wallpaper kasnije, za MVP default je hive honeycomb.
5. ⌘K PALETTE — ostaje kao Spotlight equivalent. Otvara se iznad svega (modal layer). Trenutna vizuelna kvaliteta preživljava paradigm shift. Launch app, search memory, invoke command.
6. OVERLAYS LAYER — između window-a i palette-a, za OnboardingWizard, modal dialogs, toast notifications, global alerts.
Apps za MVP prvi launch (subset od 24, ostali dolaze kasnije):
• Cockpit (KPI dashboard, agent activity — ono što trenutni mockup pokazuje kao Memories surface, ali kao app window ne kao main chrome)
• Memory (browse, search, tag, edit memories; side panel sa filters)
• Graph (force-directed bitemporal KG, node-click side panel)
• Agents (status table + cards, last-run, model badge, activity sparkline)
• Chat (agent conversation interface, multi-provider)
• Provenance (audit log stream, compliance_trigger filters, CSV export)
• Providers (4-card grid, model list, latency meters, routing toggle)
• Policy (YAML rule editor + natural-language summary + diff preview)
• Preferences (Appearance / Defaults / Keyboard sections)
• Settings (system-level: account, sync, backup, about)
• Files (browse .mind files, imports, exports)
• Wiki (compiled wiki pages view)
12 apps za MVP dock. Preostalih 12 docked-but-unavailable ili sakrivenih iza "Show all apps" razrešavaju se kasnije.
Texture opacity ramp:
• Desktop BG: 25-35%, blend-mode overlay ili soft-light
• Window BG: 4-8% (blago nasluti, ne ometa)
• Empty states unutar window-a: 15-20% + persona illustration
• Menubar / Dock chrome: 0-3% (čisto)
Bees/personas ostaju landing-only per decisions/2026-04-22-landing-personas-ia-locked.md. NE injektovati bees u app chrome. preview/bees.html samo popraviti (trenutno blank) kao static grid of 13 bees za DS reference.
Dizajn tokeni (honey accent, dark palette, typography, spacing, radii) zadržani — samo rearhitektura chrome paradigme.
Renderuj:
1. Novi ui_kits/waggle-app/index.html sa macOS-style menubar + dock + desktop + 2-3 otvorena window-a (Cockpit primary, Memory i Graph kao sekundarni, jedan od njih floating iznad drugog da pokažeš z-order)
2. preview/desktop-chrome.html kao izolovan referenčni prikaz samo chrome-a (menubar + empty desktop + dock)
3. preview/window-variants.html sa pet window states: normal / focused / blurred (not focused) / minimized preview / maximized
4. preview/texture.html ažuriran sa novim opacity cell-ovima (desktop BG 30% overlay, window BG 6%, empty state 18%, menubar 0%)
5. preview/bees.html popravljen (static 13-bee grid)
Ako treba reference: macOS Sonoma/Sequoia chrome + dock behavior je polazna tačka; ne kopirati pixel-by-pixel ali preuzeti grammar (traffic lights levo, dock magnification, menubar density, window shadow).
Šta NIJE predmet ove iteracije
Ne dirati design tokens (already ratified). Ne redizajnirati personas (landing-only per LOCK). Ne menjati voice ili copy u ⌘K palette. Ne menjati bee/honey metaforu. Ne menjati Tauri tehnički stack. Ne otvarati diskusiju o multi-window tilting/Mission Control/Stage Manager — to je v1.5+ scope.
Posle DS outputa
Kad DS chat vrati iteraciju: screenshot svih 4 nova preview-a + novi index.html sa 2-3 window-a otvorena. Ako paradigma hvata — ratifikuj i prelazi na per-app deep dive (Memory, Graph, Agents, Provenance konkretizacija). Ako ne hvata — još jedna iteracija sa konkretnijim macOS grammar pinning-om.
CC-1 paralelno nastavlja Sprint 12 Task 2 C3 mini. Ovaj DS rad je nezavisan stream i ne blokira benchmark critical path.