docs(app-shell): record the grouped Appearance category and its new paths - Appearance is a master/detail category: Palette / Shell / Editor / Editor behaviour, with the group table as data and a `Record` section map that refuses to compile without a renderer. - Two measured consequences recorded: the category belongs in the modal's `p-0` list, and an E2E that wants a control outside the first group must click that group row first. - Settings -> Appearance -> Layout is now Settings -> Appearance -> Shell, so every panel-navigation, surface, rules and tray-icon reference follows the category's own path.
docs(shells): record the one-local-server rule and the dead-row Remove - The store owns the limit: a Start is refused while a pid this shell recorded still answers, and a recorded pid whose server died does not block (that Start is the restart). - The panel states the running server instead of offering a second button; a dead owned row now offers Remove.
docs(shells): record the child PATH rule for a local server start - The CLI is a `#!/usr/bin/env bun` script (and a Windows shim), so the child's PATH must carry the directories `which` probed. A GUI launch inherits a minimal PATH, so `which` found the CLI in `~/.bun/bin` while the child died with `env: bun: No such file or directory` in `desktop-<port>.log`. - Each shell now widens the child's PATH with the one list its lookup reads; the rules suites assert the widening.
docs(desktop): record the macOS menu bar rules The menu bar moved to a library table so the suites can install the same rows the app ships; the rules that decide a row (no chord for a page command, a hidden ⌘= alternate, the window list AppKit does not complete) were measured and would otherwise be re-broken by the next reader.
docs(desktop): record the chime behaviour across the shells - macOS heals a stale usernoted record once per version and carries versioned chime names. - Linux honours sound-file on GNOME and Plasma 6.4+, and plays locally with suppress-sound when GetCapabilities has no sound. - Windows suppresses the platform tone with NIIF_NOSOUND and plays the embedded WAV.
docs(desktop): record the stale usernoted sound record - macOS 26 resolves UNNotificationSound against the app record usernoted keeps; a record from a different bundle with the same CFBundleIdentifier falls back to the built-in tone.
docs(desktop): note the versioned Apple chime names
docs(notifications): recorded the grant commands and the denied-grant rule
docs(desktop): recorded the Android background watch opt-in
docs(desktop): recorded the tray icon's greyscale conversion
docs(desktop): recorded the tray icon's colour and monochrome styles
docs: recorded the Android watcher's three gates and its read timeout
docs(desktop): recorded how a download works inside a shell - The measured facts behind the pairing QR fix: `blob:` is ignored by every shell's download path, an attachment response still reports `canShowMIMEType == true` on WebKit, and macOS/iOS/Linux each needed their own handler.
docs: documented the native notification chimes - The banner plays Kabmo's two cues and the page goes silent inside a shell, with the measured reason for the -2.5 dBFS normalization and the channel-per-sound rule Android forces.
docs(desktop-integration): record the banner's clock, duration and glyph strip Three details a banner got wrong and are easy to re-break: the timestamp must be the EVENT's moment rather than the posting time (a reopened app otherwise claims every backlog entry just happened), the duration comes from `session_stream_state.started_at` written only on the transition INTO `stream` (a run writes that row several times, and restarting the clock reports the last frame's age), and a title is stripped of Private Use Area glyphs before the length clip because the shade's system font renders every Nerd Font icon as a tofu box.
docs(desktop-integration): record where notification events are decided The system-notification section described the page diffing sidebar statuses, which is exactly what broke on a phone: a backgrounded WebView is frozen, so the page sees no transition and announces the accumulated backlog on resume. Record the replacement — the server records and gates each event, an open page gets it over the realtime `notifications` topic, and the Android shell holds `GET /api/notifications/stream` in a `specialUse` foreground service so the banner arrives with the app closed. Also names the two details that are easy to re-break: the topic's snapshot is empty so a reconnect replays nothing, and a consumer with no cursor is primed with the newest id instead of the outbox.
docs(shell): record the failure splash's actions and why server settings is native The console's server control is a page, so the failure splash — the one moment a wrong address needs fixing — had no way to change it. Records the two actions, the palette-owned plates each platform needed (Aero2 ignores CornerRadius, Adwaita paints a gradient), and `connectRemote`'s duplicate rule.
docs(desktop-integration): document platform notification switches and foreground delivery The Notifications page now splits delivery into Desktop and Mobile masters selected from the device class, and the client no longer suppresses a banner for a focused window. Record both rules and the Apple willPresent presentation that keeps a foreground banner visible, since the OS default would otherwise swallow it.
docs(notifications): document opt-in system notifications and click-through Records the three default-off preferences, the permission and focus rules, the failure reason persisted on session_stream_state, the two shell commands, and how a notification click reaches window.__kabmoOpenSession in each shell — including the cold-start queue.
docs: split the manual into a wiki