Skip to content

armgit / mso

Public Imported from GitHub
0

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.

docs(antislop): design direction, agent pointer, and the R-10 glass audit (#163)

Abdurrahman Fakhrul6772b63e1216
diff --git a/AGENTS.md b/AGENTS.md
index 784386f8..f5f039da 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -137,3 +137,28 @@ Run validation with `umask 077`: security fixtures must create private files/dir
Follow `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 a
bare 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.md
index 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 third
entry 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.md
new file mode 100644
index 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.md
index 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 scrolling
diff --git a/docs/R10-GLASS-AUDIT.md b/docs/R10-GLASS-AUDIT.md
new file mode 100644
index 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.md
index 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.tsx
index 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