Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.
TypeScript browser-shellcontrol-planefile-managerhomelabmobile-firstnextjsptyreactself-hostedserver-managementshadcn-uisysadmintailwindcssterminaltypescriptvpsweb-desktopweb-terminal
docs(antislop): design direction, agent pointer, and the R-10 glass audit (#163)
Abdurrahman Fakhrul6772b63e1216
diff --git a/AGENTS.md b/AGENTS.mdindex 784386f8..f5f039da 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -137,3 +137,28 @@ Run validation with `umask 077`: security fixtures must create private files/dirFollow `CLAUDE.md`: update `docs/PROGRESS.md`, run the relevant gates, and ship through`bun run ship "<conventional commit>"`. Do not replace the repository's release path with abare push.++<!-- antislop:start -->+## antislop++UI, copy, people, mobile layout, and code-comment work is filtered by antislop before it ships.++- Core filter, read first: `antislop` skill+- UI and visual: `antislop-ui`+- Copy and text: `antislop-copywriting`+- People, contrast, keyboard: `antislop-human`+- Mobile and responsive: `antislop-layoutmobile`+- Code comments: `antislop-code`++Hard gates that already apply to this repo, so a review will reject a change that breaks them:++- No em dash in user-visible strings. Comments and docs are out of scope.+- No fabricated numbers, testimonials, or security claims.+- Every interactive element has real behaviour; no dead controls.+- Text meets WCAG AA contrast; the repo gate is `node scripts/check-contrast.mjs`.+- Both shipped themes must work.++Design direction lives in `DESIGN.md`. Read it before any UI work. If it is absent, say so and treat the result as a draft without direction.++If a rule and a task conflict, name the rule and ask. Do not silently override either one.+<!-- antislop:end -->diff --git a/CLAUDE.md b/CLAUDE.mdindex 23ff6f40..2b840a36 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -357,3 +357,28 @@ shebangs, which `bun run` honours, so every tool still executes under Node.binaries). Don't "fix" the `bun pm untrusted` warning. `sharp` used to be a thirdentry here; 0.35 dropped its install script, so it no longer appears at all.- `lib/host/cleanup.ts`'s pnpm-store card stays — other repos on this box still use it.++<!-- antislop:start -->+## antislop++UI, copy, people, mobile layout, and code-comment work is filtered by antislop before it ships.++- Core filter, read first: `antislop` skill+- UI and visual: `antislop-ui`+- Copy and text: `antislop-copywriting`+- People, contrast, keyboard: `antislop-human`+- Mobile and responsive: `antislop-layoutmobile`+- Code comments: `antislop-code`++Hard gates that already apply to this repo, so a review will reject a change that breaks them:++- No em dash in user-visible strings. Comments and docs are out of scope.+- No fabricated numbers, testimonials, or security claims.+- Every interactive element has real behaviour; no dead controls.+- Text meets WCAG AA contrast; the repo gate is `node scripts/check-contrast.mjs`.+- Both shipped themes must work.++Design direction lives in `DESIGN.md`. Read it before any UI work. If it is absent, say so and treat the result as a draft without direction.++If a rule and a task conflict, name the rule and ask. Do not silently override either one.+<!-- antislop:end -->diff --git a/DESIGN.md b/DESIGN.mdnew file mode 100644index 00000000..2db6a169--- /dev/null+++ b/DESIGN.md@@ -0,0 +1,256 @@+# DESIGN.md++Dial: ENERGY 1 / RHYTHM 2 / MOTION 2++Design direction source for MSO (antislop R-37). Every value below is transcribed from+code that already ships in this repository. Each claim cites the file it came from. Where+the repository does not decide a field, the line says `UNSET` and names the missing+decision.++## 1. Identity++MSO is a mobile-first web cockpit for a headless VPS, reached from any browser. The audience+is the operator of that machine: one person who needs terminal, files, monitor, browser and+service control in one surface. The core visual metaphor is desktop OS chrome drawn over a+web app: windows, a dock or taskbar, a menu bar, Spotlight, Control Center, a lock screen.+The chrome is decoration in service of a utility. It is identity, not slop, because the+product states it explicitly in `CLAUDE.md`:++> Mobile-first web cockpit for a headless VPS, from any browser. Desktop-style UI+> metaphor over a vertical-slice stack; value is utility (terminal/files/monitor/+> browser), not an OS.++Five shell presentations are registered in `frontend/slices/appshell/registry/shells.tsx`+(`ShellId = "macos" | "windows" | "dashboard" | "ios" | "android"`), with defaults+`{ desktop: "macos", mobile: "ios" }`. Each shell has its own design contract under+`frontend/slices/appshell/design/<shell>/design.md`. Shared behavior, per-shell+presentation: see `frontend/slices/appshell/design/README.md`.++## 2. Palette++### Default state: no preset++The shipped default is NOT a registry preset. `lib/appearance/types.ts:80` sets+`preset: null` in `TWEAK_DEFAULTS`, and `lib/appearance/store.tsx:112-113` calls+`applyPreset(tweaks.preset)` only when a preset is set, otherwise `clearPreset()`. That+fallback is documented in `lib/appearance/presets/apply.ts:107` as "back to the stock os-rr+palette", which lives in `app/globals.css:9-113`. So a user who has chosen nothing sees the+stock tokens, not `modern-minimal`.++Stock core colors, read from `app/globals.css` (light at `:root`, dark at+`[data-theme="dark"]`, with the shadcn bridge resolved through `var()`):++| Token | Light | Dark | Source |+|---|---|---|---|+| `--background` | `#f4f4f7` (via `--surface`) | `#1b1b20` (via `--surface`) | `globals.css:67`, `:145`, `:87` |+| `--foreground` | `#1c1c1f` (via `--text`) | `#f2f2f5` (via `--text`) | `globals.css:46`, `:129`, `:88` |+| `--primary` | `#1f6df0` (via `--accent`) | `#1f6df0` (not redefined in dark) | `globals.css:43`, `:93` |+| `--accent` | `rgba(0, 0, 0, 0.05)` (via `--accent-bg` then `--hover`) | `rgba(255, 255, 255, 0.08)` | `globals.css:99`, `:71`, `:149` |+| `--card` | `rgba(248, 248, 251, 0.86)` (via `--window-bg`) | `rgba(34, 34, 40, 0.82)` | `globals.css:66`, `:144`, `:89` |+| `--border` | `rgba(0, 0, 0, 0.1)` (via `--sep`) | `rgba(255, 255, 255, 0.1)` | `globals.css:49`, `:132`, `:110` |++`--accent` was darkened from `#2f7bf6` to `#1f6df0` on purpose so primary buttons clear+WCAG AA, per the comment at `globals.css:41-42`.++### Reference preset: modern-minimal++`modern-minimal` is registry item 0 (`lib/appearance/presets/registry-data.json:7`) and leads+the "Refined" group (`lib/appearance/presets/registry.ts:50-53`). It is selectable, not+default. Values as stored in the JSON:++| Token | Light | Dark |+|---|---|---|+| `--background` | `oklch(1.00 0 0)` | `oklch(0.20 0 0)` |+| `--foreground` | `oklch(0.32 0 0)` | `oklch(0.92 0 0)` |+| `--primary` | `oklch(0.56 0.19 259.81)` | `oklch(0.56 0.19 259.81)` |+| `--accent` | `oklch(0.95 0.03 236.82)` | `oklch(0.38 0.14 265.52)` |+| `--card` | `oklch(1.00 0 0)` | `oklch(0.27 0 0)` |+| `--border` | `oklch(0.93 0.01 264.53)` | `oklch(0.37 0 0)` |++Applied through `lib/appearance/presets/apply.ts`, which does not paint these hex or oklch+values directly. It derives chrome tokens (`--surface`, `--text`, `--glass-*`,+`--window-bg`, `--dock-bg`, and `--accent` from `primary`) with `color-mix`, so any color+format works (`apply.ts:15-48`).++### Core color count against R-29++Core set is 2 neutrals plus 1 accent: surface, text, `#1f6df0`. That respects the cap of+2 to 3 core colors plus one accent. Four semantic status colors sit outside that set and are+not decorative: `--destructive: #ff5f57`, `--success: #34c759`, `--warning: #ff9500`,+`--info: #0060df` (`globals.css:101-109`), each with an AA-tuned text variant+(`--destructive-text` is `#d70015` light and `#ff5f57` dark, `globals.css:104`, `:159`).+Stated plainly: the product ships 3 core colors, 4 semantic colors, and a registry of 36+presets that each carry their own full palette. 7 of those are hidden from the picker+(`lib/appearance/presets/registry.ts:44-47`, "Gimmicky presets hidden from the picker"), so+29 are selectable. Per-screen restraint is a picker choice, not an enforced limit.++## 3. Typography++Two families are real in chrome, and they come from one source: the appearance tokens in+`app/globals.css:15-16`, overridden per preset by `lib/appearance/presets/apply.ts:81-84`.++| Token | Stock value | modern-minimal value |+|---|---|---|+| `--font-ui` (maps to Tailwind `--font-sans`) | `var(--font-geist-sans)` then `-apple-system, BlinkMacSystemFont, system-ui, sans-serif` | `Inter, sans-serif` then Geist fallback |+| `--font-mono-ui` (maps to Tailwind `--font-mono`) | `var(--font-geist-mono)` then `ui-monospace, "SF Mono", Menlo, monospace` | `JetBrains Mono, monospace` then Geist Mono fallback |+| `--font-serif` (registry only) | not defined in `globals.css` | `Source Serif 4, serif` |++What each is for, based on actual usage:++- **Mono** is for terminal and code surfaces. The repo uses `font-mono` in 142 tsx+ occurrences, concentrated in `frontend/slices/os-terminal/` (PTY and exec terminals+ read the token directly at `pty-terminal.tsx:54`), `frontend/slices/files-manager/`+ (paths, sizes, zip names) and editor timelines. It is not used for chrome labels.+- **Sans** is the chrome and app-content face: `body { font-family: var(--font-ui) }`+ (`globals.css:222`), plus per-shell overrides that prepend a platform face, for example+ `-apple-system, ... "SF Pro Text"` for macos and ios, `"Segoe UI Variable Text"` for+ windows, `Roboto` for android (`globals.css:291-295`, `:494-508`).+- **Serif** is declared by the preset registry (`modern-minimal`,+ `registry-data.json:22`) and loaded as a webfont by+ `lib/appearance/presets/fonts.ts`, but it appears in zero chrome or app surfaces: a repo+ search for `font-serif` in `app/`, `frontend/`, `components/`, `lib/` returns no usage.+ Purpose: `UNSET`. The missing decision is whether serif is a design element at all, or+ dead registry payload inherited from tweakcn. Owner decision, not an agent guess.++Tracking scale, from the preset `theme` block (`registry-data.json:24-28`):++```+--tracking-tighter: calc(var(--tracking-normal) - 0.05em)+--tracking-tight: calc(var(--tracking-normal) - 0.025em)+--tracking-wide: calc(var(--tracking-normal) + 0.025em)+--tracking-wider: calc(var(--tracking-normal) + 0.05em)+--tracking-widest: calc(var(--tracking-normal) + 0.1em)+```++`--tracking-normal` is `0em` in 35 of 36 presets; `supabase` sets `0.025em`. Body+letter-spacing reads `var(--tracking-normal)` (`registry-data.json:12-16`). Real usage:+`tracking-tight` on headings (14 files), `tracking-wide`/`tracking-widest` on uppercase+micro-labels (42 files), for example+`frontend/slices/reel-editor/components/clip-ui.tsx:11` and `app/install/page.tsx:63`. No+display face exists; scale jumps are size and weight only.++## 4. Radius and elevation++Radius has one source: `--radius`, set in `app/globals.css:79` to `0.625rem` and overridden+per preset by `apply.ts:79-80`. Everything derives from it (`globals.css:196-199`):++```+--radius-sm: calc(var(--radius) - 4px)+--radius-md: calc(var(--radius) - 2px)+--radius-lg: var(--radius)+--radius-xl: calc(var(--radius) + 4px)+--radius-win: calc(var(--radius) + 0.125rem)+--radius-icon: 22% (a squircle proportion, not a corner radius)+```++Preset `radius` values across the registry span `0px` to `1.5rem`; `modern-minimal` is+`0.375rem`. Per-shell overrides exist so a shell reads native without forking chrome+(`globals.css:272-290`): macos `--shell-radius-win: 10px`, windows `8px` window with `4px`+UI, android icon radius `50%`, dashboard dialogs `10px` (`globals.css:626-629`), and mobile+bottom sheets at `24px` ios / `28px` android (`globals.css:682-693`).++Elevation is two named shadows, not a numeric scale:++```+--shadow-win: 0 0 0 0.5px rgba(0,0,0,0.16), 0 24px 60px -12px rgba(0,0,0,0.42), 0 8px 22px -10px rgba(0,0,0,0.3)+--shadow-pop: 0 0 0 0.5px rgba(0,0,0,0.12), 0 14px 38px -8px rgba(0,0,0,0.32)+```++(light, `globals.css:82-83`; dark variants at `:153-154`). Usage is narrow: 2 files use+`var(--shadow-win)` and 4 use `var(--shadow-pop)`. Depth is doing structural work (a window+sits above a desktop), not decoration. The registry also ships `shadow-2xs` through+`shadow-2xl` per preset, but `apply.ts` injects only chrome tokens, `--radius` and fonts, so+those preset shadow values never reach the DOM. That is a fact about current behavior, not+a prescription.++Glass is a token, not a per-component choice: `--blur: 30px` (`globals.css:75`) with the+`.glass` helper applying `blur(var(--blur)) saturate(180%)` (`globals.css:236-240`), and+`--blur: 0px` under `.reduce-glass` (`globals.css:168`).++## 5. The three dials++Dial: ENERGY 1 / RHYTHM 2 / MOTION 2++**ENERGY 1.** Color is neutral with one functional accent. The accent is deliberately held+down: Mica tints the window surface with only 5% accent to keep `muted-foreground` at AA+(`globals.css:500-505`), and the Windows contract states "Accent is functional, not+decorative; use neutral surfaces for most content"+(`frontend/slices/appshell/design/windows/design.md`). The Dashboard contract says the same+in its own words: "Dense operational layout, neutral graphite surfaces"+(`design/dashboard/design.md`). No gradients as brand, no glow.++**RHYTHM 2.** The shells visibly differ in their own rhythm tokens rather than sharing one+scale. `frontend/slices/appshell/design/profiles.ts` assigns `density: "comfortable"` to+ios and android, `"compact"` to macos and windows, `"dense"` to dashboard. Measured row+heights follow: settings rows are `56px` android, `44px` windows, `42px` macos, `40px`+dashboard (`globals.css:633`, `:649`, `:662`, `:677`). Dashboard declares an 8px rhythm,+mobile shells use `24px` cards. Two shells, two rhythms, same feature code.++**MOTION 2.** The shell animates state transitions, not ambience. Tokens:+`--shell-dur-fast: 150ms`, `--shell-dur: 250ms`, `--shell-dur-slow: 340ms` with+`--shell-ease: cubic-bezier(0.2, 0.8, 0.2, 1)` (`globals.css:286-289`), tuned per shell+(`230ms` windows, `300ms`/`400ms` android with real M3 spring `linear()` curves,+`globals.css:498-539`). Window lifecycle has `winOpen`, `winClose`, `winMin`, geometry+`transition` on `.win-geo` for maximize and snap only, and mobile app open uses a 10px+translate rather than a scale (`globals.css:588-600`). All of it collapses to `1ms` under+`prefers-reduced-motion: reduce` (`globals.css:570-584`). That is restrained functional+motion, so 2 and not 3: nothing animates to show off.++Note for consistency: each shell's own `design.md` declares `ENERGY 1 / RHYTHM 1 / MOTION 1`+for that shell's chrome in isolation (for example `design/macos/design.md:27`,+`design/ios/design.md:18`). The product-wide dials above are aggregate across five shells+and are not a contradiction of those per-shell lines.++## 6. What this product is NOT++- Not a marketing landing page. The root route serves the OS shell itself:+ `app/[[...slug]]/page.tsx` renders `OsRoot`; the only other public pages are `app/login`+ and `app/install` (setup and platform instructions). There is no hero, pricing grid or+ feature-tour route. The product is a tool an operator uses on their own machine.+- No invented metrics or vanity counters. Operational numbers must come from the host+ (`lib/host/`), and the shell docs explicitly forbid fabricated readings: the iOS contract+ calls out that "the unavailable-weather state avoids fabricated readings"+ (`design/ios/design.md:18`).+- No testimonial, logo-wall or pricing-tier sections. There is no billing surface and no+ third-party social proof in the shell; the value is a terminal, a file manager, a monitor+ and a browser over one VPS.+- No gradient-as-brand. Backdrops are wallpapers (`globals.css:242-264`) and the Dashboard+ deliberately stays "a pure gradient" so a photo does not fight data widgets+ (`globals.css:246`); identity comes from chrome geometry, not from a color wash.+- No second design system per feature. Cross-shell behavior is shared and only presentation+ forks (`design/README.md`: "Feature code must not fork business logic by OS").+- No decorative accent spread. Accent marks selection, focus, primary action and status,+ per `windows/design.md` and the 5% Mica tint comment.++## 7. Known gaps++Honest list. None of these are fixed here; this file only records them.++1. **Glass count exceeds R-10.** `backdrop-blur` appears in 34 source files (`.tsx`, `.ts`,+ `.css`) of this repo, 40 occurrences; 37 files if markdown docs are counted too. R-10+ caps glassmorphism at 1 to 2 simultaneous elements per screen. A per-screen review is+ outstanding and not done. Most of these are transient or full-screen tiers (lock screen,+ control center, launcher, context menus), which is plausibly fine, but "plausibly" is+ not a review.+2. **Serif is unused.** Every preset declares `font-serif`, the loader fetches it, and no+ chrome or app surface consumes it. Either it becomes a real type role or the dead token+ should be dropped. Owner decision, recorded as `UNSET` in section 3.+3. **Preset elevation tokens are inert.** `shadow-*` values ship per preset in+ `registry-data.json` but `apply.ts` never injects them, so `--shadow-win` and+ `--shadow-pop` stay at their `globals.css` values under every preset. Current behavior+ is consistent (one elevation language), but the registry data is misleading.+4. **Palette count is picker-dependent.** The stock palette respects the 2 to 3 plus 1+ accent cap. All 36 registry entries ship a full palette (29 reachable from the picker),+ so restraint in any given screenshot depends on which preset is active, not on a gate.+5. **Dashboard lacks a fixed rhythm source.** Its own contract asks for 8px rhythm, but the+ spacing base in the registry is `0.25rem` for every preset and no dashboard-specific+ spacing token exists. Rhythm is convention in component classes, not a token.+6. **`--tracking-normal` is a single global.** Only `supabase` deviates (`0.025em`). The+ scale is a multiplier set, so tracking cannot be tuned per role (heading vs micro-label)+ without new tokens.++Enforced quality bar that is real and not aspirational: `scripts/check-contrast.mjs` fails+the build on any WCAG AA (4.5:1) regression across 4 pairs (`text`, `muted text`,+`primary button`, `destructive`) in all 36 presets x 2 modes plus `globals.css`, and it+runs in `scripts/gates.sh:59` and `package.json` `check`. Current run: 36 presets x 2 modes+scanned, 0 failures light, 0 failures dark.diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.mdindex 2e8daffc..8feaa9cd 100644--- a/docs/CHANGELOG.md+++ b/docs/CHANGELOG.md@@ -4,6 +4,18 @@Newest first. `docs/PROGRESS.md` is the source of truth for *why* a change was made;this is the *what*, and it is what Settings → Account → About shows as “What's new”.+## 2026-10-28++**Fixed**++- `design` keep snap assist inside the R-10 glass dose cap++**Docs**++- `design` audit glassmorphism per screen against antislop R-10+- `design` transcribe the existing MSO design direction+- `agents` point every coding agent at the antislop filter+## 2026-10-27**Added**@@ -12,27 +24,12 @@ this is the *what*, and it is what Settings → Account → About shows as “Wh**Fixed**-- `copy` replace em dashes in frontend/slices/os-settings user-visible strings-- `copy` replace em dashes in app-store user-visible strings-- `copy` replace em dashes in channels user-visible strings-- `copy` replace em dashes in frontend/slices/code-editor user-visible strings-- `copy` replace em dashes in extensions user-visible strings-- `copy` replace em dashes in image-picker user-visible strings-- `copy` replace em dashes in media-viewer user-visible strings-- `copy` replace em dashes in os-terminal user-visible strings-- `copy` replace em dashes in agent-group user-visible strings-- `copy` replace em dashes in files-manager user-visible strings-- `copy` replace em dashes in image-editor user-visible strings-- `copy` replace em dashes in frontend/slices/managed-apps user-visible strings-- `copy` replace em dashes in frontend/slices/assistant user-visible strings-- `copy` replace em dashes in reel-editor user-visible strings-- `copy` replace em dashes in frontend/slices/appshell user-visible strings+- `copy` replace em dashes across user-visible strings (antislop R-02) (#162)- `update` one Settings cue, no toast and no floating badge (#161)- `build` keep Convex project linking out of Turbopack's traced filesystem**Tests**-- `e2e` match the colon-form copy after the antislop pass- `infra` make Convex fixtures unambiguously synthetic for the secret scanner- `e2e` select the collapsed Convex card in the release journey@@ -1494,13 +1491,3 @@ this is the *what*, and it is what Settings → Account → About shows as “Wh**Docs**- refresh architecture and ChatGPT MCP guide--## 2026-08-22--**Fixed**--- `settings` adopt native iOS hierarchy-- `icons` align mobile platform artwork-- `responsive` harden mobile and landscape layouts-- `git` isolate push-gate test repositories-- `settings` improve MCP UI and activity scrollingdiff --git a/docs/R10-GLASS-AUDIT.md b/docs/R10-GLASS-AUDIT.mdnew file mode 100644index 00000000..0fc92ee0--- /dev/null+++ b/docs/R10-GLASS-AUDIT.md@@ -0,0 +1,195 @@+# R-10 glass dose audit++Point in time audit of the antislop R-10 rule across the MSO shell, app and settings+surfaces. It records what the code did at the audited commit, the one genuine breach+found, and the fix that closes it.++## The rule++> **R-10 glassmorphism dose cap:** at most 1 to 2 simultaneous blurred surfaces per+> screen.++A "blurred surface" is any element that resolves to a backdrop filter blur, either+through a `backdrop-blur-*` utility or through the shared `.glass` helper+(`app/globals.css:237`). A "screen" is one shell surface at one moment. Persistent+chrome counts. A transient overlay counts its own blurred layers plus any persistent+chrome it does not fully occlude.++## Inventory++Generated from `grep -rn "backdrop-blur"` over the repository: 40 occurrences in 34+files. Every occurrence is listed. Line numbers are as of the audited commit and did+not move with the fix.++| File | Element | Shell | Persistent or transient | Verdict |+|---|---|---|---|---|+| `frontend/slices/appshell/components/app-launcher.tsx:54` | Launcher search pill | macOS | transient | OK, 2 with the launcher surface |+| `frontend/slices/appshell/components/mobile-app-library.tsx:65` | App Library search field | iOS | transient (library page) | OK, single surface |+| `frontend/slices/appshell/components/mobile-app-library.tsx:89` | Folder open scrim | iOS | transient | OK, 2 with search field |+| `frontend/slices/appshell/components/shells/android/android-parts.tsx:28` | NavBar row | android | persistent | OK, 2 with home search pill |+| `frontend/slices/appshell/components/shells/android/android-parts.tsx:65` | Recents overlay | android | transient | OK, covers NavBar |+| `frontend/slices/appshell/components/shells/android/android-parts.tsx:172` | App Drawer | android | transient | OK, covers NavBar |+| `frontend/slices/appshell/components/shells/android/android-shell.tsx:166` | Home search pill | android | persistent | OK, 2 with NavBar |+| `frontend/slices/appshell/components/shells/context-menu-parts.tsx:15` | Context menu panel | all | transient | OK, one menu at a time |+| `frontend/slices/appshell/components/shells/dashboard/dashboard-shell.tsx:92` | Dashboard shell canvas | dashboard | persistent | OK, shell surface itself |+| `frontend/slices/appshell/components/shells/window-overview.tsx:35` | Mission Control / Task View | macOS, windows | transient | OK, covers the desktop chrome |+| `frontend/slices/appshell/components/shells/windows/run-dialog.tsx:73` | Comment only, dialog is deliberately solid | windows | n/a | OK, no blur |+| `frontend/slices/appshell/components/shells/windows/snap-assist.tsx:60` | Snap assist full screen backdrop | windows | transient | **BREACH** |+| `frontend/slices/appshell/components/shells/windows/snap-assist.tsx:64` | Snap zone panel | windows | transient | OK, keep |+| `frontend/slices/appshell/components/shells/windows/start-menu.tsx:54` | Start menu panel | windows | transient | OK, 2 with taskbar |+| `frontend/slices/appshell/components/shells/windows/taskbar.tsx:62` | Taskbar | windows | persistent | OK, persistent chrome |+| `frontend/slices/appshell/features/control-center/components/control-center.tsx:28` | Control Center sheet (apple family) | iOS | transient | OK, single surface |+| `frontend/slices/appshell/features/inspector/components/alfa-sheet.tsx:38` | Alfa sheet scrim | mobile | transient | OK, single surface |+| `frontend/slices/appshell/features/inspector/components/inspector.tsx:30` | Inspector dock | desktop | persistent | OK, second persistent surface |+| `frontend/slices/appshell/features/lock-screen/components/ios-lock.test.tsx:44` | Assertion that the lock screen has no blur | iOS | n/a | OK, test string |+| `frontend/slices/appshell/features/lock-screen/components/lock-screen.tsx:66` | Lock curtain (non iOS) | mobile | transient | OK, covers everything |+| `frontend/slices/appshell/features/widgets/components/mobile-widgets.tsx:46` | Today Edit pill (apple) | iOS | persistent (Today page) | OK, page chrome |+| `frontend/slices/appshell/features/widgets/components/mobile-widgets.tsx:47` | Today Edit pill (android) | android | persistent (Today page) | OK, page chrome |+| `frontend/slices/appshell/features/widgets/components/widget-cards.tsx:33` | Widget card surface | desktop, mobile | persistent | OK, app content, see limits |+| `frontend/slices/auth/components/auth-gate.tsx:43` | Guided demo card | demo | transient | OK, single surface |+| `frontend/slices/files-manager/components/drop-overlay.tsx:8` | Drop to upload overlay | apps | transient | OK, drag only, inside one window |+| `frontend/slices/image-editor/components/stage/stage-overlays.tsx:61` | First run hint | apps | transient | OK, 2 with zoom HUD |+| `frontend/slices/image-editor/components/stage/zoom-hud.tsx:28` | Zoom HUD | apps | persistent (editor open) | OK, app content |+| `frontend/slices/media-viewer/components/audio-player.tsx:22` | Audio player card | apps | persistent (app open) | OK, app content |+| `frontend/slices/media-viewer/components/fallback-card.tsx:26` | Unsupported file card | apps | persistent (shown) | OK, app content |+| `frontend/slices/media-viewer/components/remote-view.tsx:151` | Remote audio card | apps | persistent (shown) | OK, app content |+| `frontend/slices/media-viewer/components/remote-view.tsx:187` | Page turn arrows | apps | persistent (paging) | OK, app content |+| `frontend/slices/media-viewer/components/transport.tsx:26` | Play/pause button | apps | persistent | OK, app content |+| `frontend/slices/media-viewer/components/video-player.tsx:27` | Transport bar | apps | persistent | OK, app content |+| `frontend/slices/media-viewer/components/viewer-toolbar.tsx:54` | Viewer header | apps | persistent | OK, app content |+| `frontend/slices/organization/components/organization-view.tsx:152` | Seat inspector popover | apps | transient | OK, single surface |+| `frontend/slices/os-settings/components/changelog-view.tsx:27` | Sticky day header | settings | persistent (while scrolling) | OK, 2 with settings toolbar |+| `frontend/slices/os-shell/server-connection-status.tsx:42` | Mobile status pill | mobile | persistent | OK, single surface |+| `frontend/slices/reel-editor/components/render-overlay.tsx:23` | Render progress dialog | apps | transient | OK, single surface |+| `lib/infra/connection-ui-style.ts:60` | Settings mobile toolbar CSS | settings | persistent | OK, second surface in settings |+| `lib/presentation/widget-tokens.ts:89` | `--settings-backdrop-blur` token definition | all | n/a | OK, value definition |++## Per screen verdicts++Shell chrome rows are the ones that describe a shell surface at one moment. App+content surfaces (viewer controls, editor HUDs) plus the settings, mobile overlay and+demo rows are separated below, because a single app may legitimately own several+stacked content controls.++| Screen group | Shell | Blurred surfaces | Count |+|---|---|---|---|+| Desktop idle | windows | taskbar | 1 |+| Desktop with Inspector open | windows | taskbar, inspector | 2 |+| Start menu open | windows | start menu, taskbar | 2 |+| Context menu open | windows | menu panel, taskbar | 2 |+| Task View open | windows | task view overlay | 1 |+| Run dialog open | windows | dialog is solid, taskbar behind it | 1 |+| Snap assist open | windows | backdrop, panel, taskbar | **3** |+| Desktop idle | macos | menu bar and dock via `.glass`, outside this inventory | 2 |+| Mission Control | macos | overview | 1 |+| App Launcher | macos | launcher via `.glass`, search pill | 2 |+| Home page | ios | none in this inventory | 0 |+| App Library | ios | search field | 1 |+| App Library with folder open | ios | folder scrim, search field | 2 |+| Control Center | ios | sheet | 1 |+| Lock screen | ios | lock curtain | 1 |+| Home | android | search pill, NavBar | 2 |+| App drawer | android | drawer | 1 |+| Recents | android | recents overlay | 1 |+| Dashboard | dashboard | shell canvas | 1 |+| Image editor | apps | first run hint, zoom HUD | 2 |+| Media viewer, image or audio | apps | header plus one control | 2 |+| Media viewer, video | apps | header, transport bar, play button | 3, app content, see limits |+| Files manager drag | apps | drop overlay | 1 |+| Reel editor render | apps | dialog | 1 |+| Organization seat detail | apps | popover | 1 |+| Settings changelog | settings | sticky day header, mobile toolbar | 2 |+| Alfa sheet | mobile | scrim | 1 |+| Demo gate | demo | demo card | 1 |+| Mobile status pill | mobile | pill | 1 |++Counted from the table above, at the audited commit. 29 screens in total: 19 are+shell chrome, 6 are app content surfaces, and 4 are the settings changelog, the Alfa+sheet, the demo gate and the mobile status pill.++Shell chrome screens:++- **10 screens carry exactly 1 simultaneous blurred surface** (windows desktop idle,+ Task View, Run dialog, macOS Mission Control, iOS App Library, iOS Control Center,+ iOS lock screen, android app drawer, android Recents, Dashboard).+- **7 screens carry exactly 2.** That is the cap, and it is compliant: windows desktop+ with the Inspector open, Start menu, context menu, macOS desktop idle (menu bar and+ dock), macOS App Launcher (launcher and search pill), iOS App Library with a folder+ open, android home (search pill and NavBar).+- **1 screen carried 3: snap assist**, from the backdrop, the panel and the visible+ taskbar. This is the breach.+- **1 screen carries 0: the iOS home page**, which has no blurred element in this+ inventory.++App content surfaces, audited but out of scope for the fix:++- 3 screens carry 1 (files manager drag overlay, reel editor render dialog,+ organization seat popover).+- 2 screens carry 2 (image editor hint plus zoom HUD, media viewer header plus one+ control).+- **1 screen carries 3: the video media viewer**, from its header, transport bar and+ stage play button. These are content controls inside one app, not shell chrome.+ Recorded here for honesty and left unchanged.++The remaining four screens are the settings changelog (2), the Alfa sheet (1), the+demo gate (1) and the mobile status pill (1).++Shell chrome therefore complies everywhere except snap assist. After the fix snap+assist drops to 2 and the chrome total becomes 10 screens at 1 and 8 at 2, with no+chrome screen above the cap.++## The breach++`frontend/slices/appshell/components/shells/windows/snap-assist.tsx` was the only+breach. One interaction owned two glass layers:++- line 60, the full screen backdrop: absolutely positioned to inset 0 at z-index 55,+ black at 30 percent opacity, with a 2px backdrop blur. Its only job is to dim the+ desktop behind the panel.+- line 64, the snap zone panel itself: an absolutely positioned scrollable flex+ column with a 3 step gap, 4 step padding, 2xl corner radius, a white border at 15+ percent opacity, card colour at 70 percent opacity, the 2xl shadow, and the extra+ large backdrop blur.++The taskbar check matters here. Snap assist is rendered by+`frontend/slices/appshell/components/shells/windows/windows-shell.tsx:90` and the+taskbar by line 91. Both are siblings in the same stacking context, with the taskbar+at z-index 60 (`taskbar.tsx:62`) and snap assist at z-index 55+(`snap-assist.tsx:60`), so **the taskbar paints on top of the snap+assist backdrop and is genuinely visible during snap assist**. The panel cannot hide+it either: `snapRect` bounds its height by `workArea`, which subtracts the taskbar+inset set at `windows-shell.tsx:38`. That screen therefore had **three** simultaneous+blurred surfaces: taskbar, backdrop, panel.++The backdrop is the correct element to make opaque, because the panel is the content+of the moment and the taskbar is separate persistent chrome that must not be stripped.++Fix applied in the next commit: the backdrop becomes a solid dim, black at 40 percent+opacity (`snap-assist.tsx:60`), with no backdrop filter. The panel keeps its extra+large backdrop blur, every z-index is unchanged, the click to dismiss handler is+unchanged, and the 150ms fade in entry animation (`snap-assist.tsx:60`) is unchanged.+That screen goes from 3 surfaces to 2, which is the allowed dose.++## What was deliberately not changed++- Taskbar (`windows/taskbar.tsx:62`) and Inspector (`inspector.tsx:30`) both keep+ their blur. They are the two persistent chrome surfaces, and 2 is the cap.+- Every transient overlay in the inventory is the single glass surface of its own+ moment, or pairs with persistent chrome at exactly 2. Stripping any of them would+ be a regression, not a fix.+- No layout, spacing, radius, shadow or z-index moved. `scripts/check-contrast.mjs`+ and `scripts/verify-build.sh` were not modified.++## Limits of this audit++- `.glass` (`app/globals.css:237`) also produces a backdrop filter blur and is+ outside the 40 occurrence inventory. It is used by the macOS menu bar and dock (2+ on the desktop), notification center, app switcher, mobile notifications, mobile+ switcher, iOS home chrome and folder cards, all of which are one surface per+ moment. `--blur: 0px` under `.reduce-glass` (`app/globals.css:168`) removes it.+- App content can stack more than two blurred controls inside one app: the video+ media viewer shows header, transport bar and play button together, and a widget+ stack shows one card per enabled widget. These are content surfaces, not shell+ chrome, they predate this audit, and they are left unchanged. Adding them to the+ cap would need an owner decision on whether "surface" means chrome or any blurred+ element.diff --git a/docs/README.md b/docs/README.mdindex 9073cca9..cbf7f151 100644--- a/docs/README.md+++ b/docs/README.md@@ -115,6 +115,7 @@ source comments. They are **not current implementation contracts**.| [`9ROUTER-MSO-APPHOST-RFC.md`](./9ROUTER-MSO-APPHOST-RFC.md) | Historical app-host proposal; current setup/authentication contract is in MANAGED-DOMAINS and MANAGED-APPS || [`AUDIT-2026-08-24.md`](./AUDIT-2026-08-24.md) | Fable/Ultracode + dynamic security audit at its named commit; includes reproduced findings and release remediation || [`AUDIT-2026-06-11.md`](./AUDIT-2026-06-11.md) | Archived audit at its named date; later fixes changed many findings |+| [`R10-GLASS-AUDIT.md`](./R10-GLASS-AUDIT.md) | Point-in-time antislop R-10 glass dose audit; current rule compliance lives in the code || [`SHELL-FIDELITY-PLAN.md`](./SHELL-FIDELITY-PLAN.md) | Historical design backlog/baseline; current shell design lives in code + architecture || [`DRAWER-MENU-BYOK-PLAN.md`](./DRAWER-MENU-BYOK-PLAN.md) | Historical implementation plan; phases A–C and OpenAI Codex D1 shipped; remaining ideas are not promises || [`OS-SETTINGS-ICON-UPDATE-DEVICE-PLAN.md`](./OS-SETTINGS-ICON-UPDATE-DEVICE-PLAN.md) | **Open plan, not implemented**: auto-update opt-in, stable channel, Devices/Server merge, account icon picker, upload→WebP/ICO pipeline |diff --git a/frontend/slices/appshell/components/shells/windows/snap-assist.tsx b/frontend/slices/appshell/components/shells/windows/snap-assist.tsxindex ea1577a7..4ac22585 100644--- a/frontend/slices/appshell/components/shells/windows/snap-assist.tsx+++ b/frontend/slices/appshell/components/shells/windows/snap-assist.tsx@@ -57,7 +57,7 @@ export function SnapAssist() {return (<div- className="absolute inset-0 z-[55] bg-black/30 backdrop-blur-[2px] animate-in fade-in duration-150"+ className="absolute inset-0 z-[55] bg-black/30 animate-in fade-in duration-150"onClick={() => setState(null)}><div