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
refactor: rename os-vps -> mso across code, config and prod wiring
Rahman439dd2bb6abe
diff --git a/.env.example b/.env.exampleindex babc9495..2b52f53e 100644--- a/.env.example+++ b/.env.example@@ -1,5 +1,5 @@-# os-vps — environment. Copy to .env.local (gitignored) and fill in.-# os-vps is self-contained: a Next.js app that runs AS a host process and+# mso — environment. Copy to .env.local (gitignored) and fill in.+# mso is self-contained: a Next.js app that runs AS a host process and# controls the machine it runs on. No database, no external backend.# --- Auth (required) ---@@ -31,7 +31,7 @@ OS_SESSION_SECRET=# are refused by default. Set =1 to allow them (do real disk surgery over SSH).# OS_EXEC_ALLOW_DESTRUCTIVE=1# Append-only audit trail of exec/file/browser/auth actions. Default path below.-# OS_AUDIT_LOG=~/.os-vps/audit.log+# OS_AUDIT_LOG=~/.mso/audit.log# Number of trusted reverse-proxy hops in front of the app. The login rate# limiter keys on the (N-from-last) x-forwarded-for hop, so a wrong value# collapses every client into one bucket (too small N) or trusts spoofed@@ -47,7 +47,7 @@ OS_SESSION_SECRET=# --- AI assistant "Alfa" (optional, BYOK) ---# Bring your own Anthropic key. Can also be set in the OS via Settings → AI-# (stored in ~/.os-vps/config.json). If unset, the assistant returns 501.+# (stored in ~/.mso/config.json). If unset, the assistant returns 501.# ANTHROPIC_API_KEY=# --- Managed apps: Hermes / OpenClaw (optional) ---@@ -59,7 +59,7 @@ OS_SESSION_SECRET=# HERMES_DASHBOARD_URL=http://127.0.0.1:9119# OPENCLAW_DASHBOARD_URL=http://127.0.0.1:18789# The three paths below take an absolute path, or "~/…" for the home of the user-# running os-vps. Leave unset to use the defaults noted per var.+# running mso. Leave unset to use the defaults noted per var.# Hermes install home. Default ~/.hermes. The built dashboard is read from# <home>/hermes-agent/hermes_cli/web_dist (override with HERMES_WEB_DIST for a# wheel/Docker install that puts it elsewhere). This is also the tree the@@ -70,7 +70,7 @@ OS_SESSION_SECRET=# Default ~/.local/lib/node_modules/openclaw/dist/control-ui.# OPENCLAW_CONTROL_UI_DIST=/opt/openclaw/dist/control-ui-# Public origin the BROWSER uses, e.g. https://os.rahmanef.com. Only the scheme+# Public origin the BROWSER uses, e.g. https://mso.rahmanef.com. Only the scheme# + host + port are read. The managed-app proxy scopes its Content-Security-Policy# to this origin; without it the origin is inferred from the Host header and then# from X-Forwarded-Host, and the latter is client-settable — set this whenever the@@ -78,10 +78,10 @@ OS_SESSION_SECRET=# In split-origin mode (below) this is also the origin the app hosts name in# `frame-ancestors`, so it decides whether the cockpit may frame the dashboard at# all. Unset, it falls back to the parent name of the host template-# (`{id}.os.rahmanef.com` → `https://os.rahmanef.com`); if THAT yields nothing+# (`{id}.mso.rahmanef.com` → `https://mso.rahmanef.com`); if THAT yields nothing# usable the policy emits `frame-ancestors 'none'` and the window stays blank —# closed, on purpose, rather than naming a guessed origin as a permitted framer.-# OS_PUBLIC_ORIGIN=https://os.rahmanef.com+# OS_PUBLIC_ORIGIN=https://mso.rahmanef.com# --- Managed-app dashboards: ONE decision, TWO variables ---# Unset (default) = MSO does not serve the Hermes/OpenClaw web UI at all. Feature@@ -99,7 +99,7 @@ OS_SESSION_SECRET=# process, cross-origin — so `window.top` is opaque:## 1. NEXT_PUBLIC_MANAGED_APP_HOST_TEMPLATE — `{id}` is the app id, so this-# yields hermes.os.rahmanef.com and openclaw.os.rahmanef.com. Each host+# yields hermes.mso.rahmanef.com and openclaw.mso.rahmanef.com. Each host# needs its own DNS record + TLS pointing at this app. On such a host the# middleware rewrites EVERY path into that app's proxy and 404s the rest, so# the cockpit API does not exist there.@@ -110,7 +110,7 @@ OS_SESSION_SECRET=## THE CONSEQUENCE OF SETTING (2) WITHOUT (1): the session cookie is handed to# every host under that domain, and each one still serves the whole cockpit —-# /api/v1/exec/run included. Anything that can answer on a *.os.rahmanef.com name+# /api/v1/exec/run included. Anything that can answer on a *.mso.rahmanef.com name# (a future subdomain, a stale DNS record someone else points here, a wildcard# certificate reused by another service) receives the credential. Only the# middleware host gating makes the widened cookie safe. Set both, or neither.@@ -128,13 +128,13 @@ OS_SESSION_SECRET=# the restart. Built without it, the browser still points the iframe at the old# same-origin proxy URL while the server has already stopped answering there, and# the app window comes up blank.-# NEXT_PUBLIC_MANAGED_APP_HOST_TEMPLATE={id}.os.rahmanef.com-# OS_SESSION_COOKIE_DOMAIN=os.rahmanef.com+# NEXT_PUBLIC_MANAGED_APP_HOST_TEMPLATE={id}.mso.rahmanef.com+# OS_SESSION_COOKIE_DOMAIN=mso.rahmanef.com# --- Storage paths (optional overrides) ----# OS_DEVICE_STORE=~/.os-vps/auth-devices.json # approved-device allowlist-# OS_CONFIG_STORE=~/.os-vps/config.json # BYOK key + model-# OS_PREFS_PATH=~/.os-vps/prefs.json # synced UI prefs (theme, layout)+# OS_DEVICE_STORE=~/.mso/auth-devices.json # approved-device allowlist+# OS_CONFIG_STORE=~/.mso/config.json # BYOK key + model+# OS_PREFS_PATH=~/.mso/prefs.json # synced UI prefs (theme, layout)# --- Public demo build (optional, BUILD-TIME flag) ---# Build with =1 for a safe public showcase: no login, no host access, no /apidiff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.ymlindex a5a9f107..8ea64314 100644--- a/.github/ISSUE_TEMPLATE/config.yml+++ b/.github/ISSUE_TEMPLATE/config.yml@@ -1,5 +1,5 @@blank_issues_enabled: falsecontact_links:- name: Security vulnerability- url: https://github.com/rahmanef63/os-vps/security/advisories/new+ url: https://github.com/rahmanef63/mso/security/advisories/newabout: Please report vulnerabilities privately through GitHub Security Advisories.diff --git a/.gitignore b/.gitignoreindex 31ec59af..24f51098 100644--- a/.gitignore+++ b/.gitignore@@ -16,7 +16,7 @@ os-browser/*!os-browser/package-lock.json!os-browser/README.mdconvex-backend/-.os-vps/+.mso/# local session progress log (not tracked)progress.mddiff --git a/CLAUDE.md b/CLAUDE.mdindex dcc7bf4c..1d364182 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -1,8 +1,8 @@-# os-vps (product name: **MSO**)+# mso (product name: **MSO**)Mobile-first web cockpit for a headless VPS, from any browser. Desktop-style UImetaphor over a vertical-slice stack; value is utility (terminal/files/monitor/-browser), not an OS. Repo/service/domain keep the `os-vps` slug; "MSO" is the+browser), not an OS. Repo/service/domain keep the `mso` slug; "MSO" is theUI brand. **Self-contained**: a single Next.js app, no database, no externalagent — it runs AS a host process and controls its own machine.@@ -44,7 +44,7 @@ decision). Both recoverable with `git show bccd0b1:docs/<name>`.## Architecture```-browser ──https──> os-vps (Next.js :4005) ──── lib/host → Node fs/child_process (host)+browser ──https──> mso (Next.js :4005) ──── lib/host → Node fs/child_process (host)signed-cookie auth (lib/auth)```The Browser app is **Camoufox** — a real anti-fingerprinting Firefox on a headless@@ -60,7 +60,7 @@ install). See the Browser/camoufox note further down for the systemd user unit.Client picks mock (default) vs live in Settings → Server.- `/api/auth/*` = login/logout/me/devices. `/api/config` = BYOK AI key.- Persistence is local: window layout + app registry in localStorage; device- allowlist + config in `~/.os-vps/*.json`.+ allowlist + config in `~/.mso/*.json`.## AppShell framework (the shell is generic + rr-liftable)The shell is NOT one slice. It is split so the whole desktop+mobile shell can lift@@ -69,7 +69,7 @@ to `resources/` (rr) and drive any project from one manifest:+ desktop/mobile surfaces, app/feature/brand registries, `<Slot region>`,`ResponsiveProvider`/`useResponsive` + the 4 DRY primitives, the pub/sub buses(toast/activity/inspector), and `<AppShell manifest>` (the one entry point). It- imports NO brand/feature and NO os-vps `@/lib/*` — only the universal `@/lib/utils`+ imports NO brand/feature and NO mso `@/lib/*` — only the universal `@/lib/utils`(`cn`). Everything project-specific arrives via `manifest.capabilities`.- `appshell/features/{search,inspector,notifications,control-center,widgets,quick-look,clipboard,share,shortcut-help,lock-screen}` — each shell **feature** lives NESTED inside@@ -80,7 +80,7 @@ to `resources/` (rr) and drive any project from one manifest:`features: DEFAULT_FEATURES`); the barrel re-exports it LAST so the `defineFeature`ES-cycle resolves. Buses live in core so apps fire them without depending on a featureslice. (`shell-settings` stays a flat UI-primitives slice — not a feature unit.)-- `os-shell` — the thin os-vps **consumer**: `shell.manifest.ts` (MSO brand + app+- `os-shell` — the thin mso **consumer**: `shell.manifest.ts` (MSO brand + applist + slugs + features) + `capabilities.ts` (adapts `@/lib/appearance`+`os-api`+`ai/stream` to `ShellCapabilities`) + a re-export barrel (`@/features/os-shell`re-exports appshell verbatim, so all app slices stay unedited).@@ -130,10 +130,10 @@ to `resources/` (rr) and drive any project from one manifest:screenshot stream stay raw `<img>` on purpose (dynamic/auth'd bytes).## Deploy / ops (prod :4005 + demo :4006 are systemd, not Dokploy)-- `os-vps.service` (:4005, WorkingDir `/home/rahman/projects/os-vps`) serves- os.rahmanef.com via `next start`. Demo `os-vps-demo.service` (:4006, WorkingDir- `/home/rahman/projects/os-vps-demo`, `NEXT_PUBLIC_OS_DEMO=1` → no auth, mock data).-- **Deploy prod:** `pnpm build` **THEN** `sudo systemctl restart os-vps.service`. ALWAYS+- `mso.service` (:4005, WorkingDir `/home/rahman/projects/mso`) serves+ mso.rahmanef.com via `next start`. Demo `mso-demo.service` (:4006, WorkingDir+ `/home/rahman/projects/mso-demo`, `NEXT_PUBLIC_OS_DEMO=1` → no auth, mock data).+- **Deploy prod:** `pnpm build` **THEN** `sudo systemctl restart mso.service`. ALWAYSbuild-then-restart, never the reverse, and never rebuild again after restartingwithout restarting once more — `next start` loads the build manifest at boot, so ifthe on-disk `.next/static` chunks don't match the running process's HTML refs, every@@ -152,9 +152,9 @@ to `resources/` (rr) and drive any project from one manifest:- **`git add` aborts on a bad pathspec** and stages NOTHING new — after a`git rm`, don't re-list the removed file in `git add`; prefer `git add -A` andcheck `git status --short` before committing (a broken commit shipped once this way).-- **Deploy demo:** from `/home/rahman/projects/os-vps-demo`: `git fetch origin -q &&+- **Deploy demo:** from `/home/rahman/projects/mso-demo`: `git fetch origin -q &&git reset --hard origin/main -q && pnpm build && sudo systemctl restart- os-vps-demo.service`. Mind the cwd — running the sync from the prod dir is a classic slip.+ mso-demo.service`. Mind the cwd — running the sync from the prod dir is a classic slip.- **The Browser app powers a systemd USER unit**, `camoufox-vnc.service` in`~/.config/systemd/user/`, whose `ExecStart` points at **`scripts/camoufox-vnc-service`in THIS repo** (it used to live untracked under `~/.openclaw/workspace/`, so a fresh@@ -162,7 +162,7 @@ to `resources/` (rr) and drive any project from one manifest:version control). The script refuses to start without a VNC password file. Two furtherhost-side facts the repo cannot carry, and the feature dies quietly without either: (1) `loginctl enable-linger rahman`, or the unit stops atlogout and never starts at boot; (2) the drop-in- `/etc/systemd/system/os-vps.service.d/user-bus.conf` setting+ `/etc/systemd/system/mso.service.d/user-bus.conf` setting`Environment=XDG_RUNTIME_DIR=/run/user/1001` — a system unit running as `User=rahman`gets NO user-bus address, so without it every `systemctl --user` call fails with"Failed to connect to bus: No medium found". `lib/camoufox/service.ts` reports that@@ -190,7 +190,7 @@ to `resources/` (rr) and drive any project from one manifest:MIME is fatal — keep static Content-Types correct.## Rules in force-- **Only ONE session edits os-vps at a time.** One checkout, one `HEAD`, one index.+- **Only ONE session edits mso at a time.** One checkout, one `HEAD`, one index.Two concurrent fix-loops collided three times on 2026-06-15: a `git reset --hard`wiped uncommitted work twice, and a shared-index sweep bundled one session's filesinto the other's commit. Before a long loop, `git log --oneline -10` — unexpecteddiff --git a/README.md b/README.mdindex df866cbf..f1c256cd 100644--- a/README.md+++ b/README.md@@ -7,7 +7,7 @@</p><p align="center">- <a href="https://os.rahmanef.com"><strong>Live instance</strong></a>+ <a href="https://mso.rahmanef.com"><strong>Live instance</strong></a>·<a href="./docs/media/demo.gif"><strong>Watch Demo</strong></a>·@@ -15,7 +15,7 @@</p><p align="center">- <a href="https://github.com/rahmanef63/os-vps/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/rahmanef63/os-vps/actions/workflows/ci.yml/badge.svg" /></a>+ <a href="https://github.com/rahmanef63/mso/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/rahmanef63/mso/actions/workflows/ci.yml/badge.svg" /></a><img alt="Open Source" src="https://img.shields.io/badge/Open%20Source-MIT-green" /><img alt="Self-hosted" src="https://img.shields.io/badge/Self--hosted-yes-2f7bf6" /><img alt="Public Alpha" src="https://img.shields.io/badge/Public%20Alpha-Developer%20Preview-f59e0b" />@@ -24,7 +24,7 @@</p><p align="center">- <img alt="version" src="https://img.shields.io/github/package-json/v/rahmanef63/os-vps?label=version&color=2f7bf6" />+ <img alt="version" src="https://img.shields.io/github/package-json/v/rahmanef63/mso?label=version&color=2f7bf6" /><img alt="node" src="https://img.shields.io/badge/node-%E2%89%A520.9-3c873a?logo=nodedotjs&logoColor=white" /><img alt="Next.js" src="https://img.shields.io/badge/Next.js-16-000000?logo=nextdotjs&logoColor=white" /><img alt="React" src="https://img.shields.io/badge/React-19-149eca?logo=react&logoColor=white" />@@ -87,15 +87,15 @@ NEXT_PUBLIC_OS_DEMO=1 pnpm build && pnpm startDemo mode skips real login, forces mock data, blocks live host API access, and shows a permanent demo banner. Use it for Product Hunt traffic. A real owner deployment should stay behind Tailscale/VPN or a protected HTTPS proxy.-- Live instance (the maintainer's own cockpit, auth-gated — not a demo): <https://os.rahmanef.com>+- Live instance (the maintainer's own cockpit, auth-gated — not a demo): <https://mso.rahmanef.com>- Watch demo: [docs/media/demo.gif](./docs/media/demo.gif)## Install-One command on your Linux server installs prerequisites, builds MSO, generates local credentials, and sets up the `os-vps.service` systemd unit:+One command on your Linux server installs prerequisites, builds MSO, generates local credentials, and sets up the `mso.service` systemd unit:```bash-curl -fsSL https://raw.githubusercontent.com/rahmanef63/os-vps/main/scripts/install.sh | bash+curl -fsSL https://raw.githubusercontent.com/rahmanef63/mso/main/scripts/install.sh | bash```Run it as your normal server user, **not root**. The installer prints the first-login password once and explains how to approve your first browser device.@@ -103,9 +103,9 @@ Run it as your normal server user, **not root**. The installer prints the first-Useful options:```bash-curl -fsSL https://raw.githubusercontent.com/rahmanef63/os-vps/main/scripts/install.sh | bash -s -- --port 4005-curl -fsSL https://raw.githubusercontent.com/rahmanef63/os-vps/main/scripts/install.sh | bash -s -- --no-service-curl -fsSL https://raw.githubusercontent.com/rahmanef63/os-vps/main/scripts/install.sh | bash -s -- --uninstall+curl -fsSL https://raw.githubusercontent.com/rahmanef63/mso/main/scripts/install.sh | bash -s -- --port 4005+curl -fsSL https://raw.githubusercontent.com/rahmanef63/mso/main/scripts/install.sh | bash -s -- --no-service+curl -fsSL https://raw.githubusercontent.com/rahmanef63/mso/main/scripts/install.sh | bash -s -- --uninstall```Full production setup, TLS/VPN notes, filesystem roots, updates, and rollback steps live in [docs/INSTALL.md](./docs/INSTALL.md).@@ -119,7 +119,7 @@ An authenticated MSO session can read allowed files and run commands as the user- Use a strong `OS_SESSION_SECRET` and a strong `OS_LOGIN_PASSWORD`.- Approve only devices you own; device approval is an allowlist, not standards-based 2FA.- Keep write roots narrow with `OS_FS_WRITE_ROOTS`.-- Never commit `.env.local`, API keys, or data from `~/.os-vps`.+- Never commit `.env.local`, API keys, or data from `~/.mso`.- Serve each managed app's dashboard from its own hostname (`hermes.os.example.com`), because a framed dashboard needs `allow-same-origin` and would otherwise be same-origin with the cockpit and able to call the host API with your session.- That boundary is browser-only: a plugin installed into Hermes or OpenClaw runs inside that daemon and can run host commands, whatever the browser thinks about origins.- With an API-key provider set, Alfa is a tool-calling agent, not a chatbot. Twelve tools run with no confirmation (`fs.list`, `fs.read`, `fs.search`, `fs.usage`, `sys.stats`, `sys.processes`, `apps.list`, `app.open`, `skills.list`, `skills.read`, `memory.remember`, `memory.forget`); six park an Approve/Deny card showing the exact call (`fs.write`, `fs.mkdir`, `fs.move`, `fs.copy`, `fs.delete`, `exec.run`).@@ -139,7 +139,7 @@ MSO is a single Next.js app that runs on your server as one non-root Node procesflowchart LRU["Phone / Browser"]subgraph VPS["Your Linux server"]- APP["MSO / os-vps<br/>Next.js 16 · React 19"]+ APP["MSO / mso<br/>Next.js 16 · React 19"]HOST["Host layer<br/>fs · PTY · sys metrics"]SLICES["Feature slices<br/>Files · Terminal · Monitor · Assistant"]AI["Alfa AI<br/>BYOK"]diff --git a/SECURITY.md b/SECURITY.mdindex 7f7754a0..8aeb2942 100644--- a/SECURITY.md+++ b/SECURITY.md@@ -30,7 +30,7 @@ that owns the process. Treat it like SSH in a browser.- If using a public domain, put HTTPS, firewall rules, and strict access controlin front of the app.- Do not expose the raw app port directly to the public internet.-- Do not commit `.env.local`, API keys, or data from `~/.os-vps`.+- Do not commit `.env.local`, API keys, or data from `~/.mso`.- Use demo mode (`NEXT_PUBLIC_OS_DEMO=1`) for public showcases.## Managed applications and per-app origins@@ -77,7 +77,7 @@ Operational rules for anyone maintaining a split-origin deployment:- **MSO expects HTTPS** (or `localhost`). The session cookie is `Secure`, so a plain-httpdeployment on an IP cannot log in at all — that is deliberate, not a bug to work around.- A managed-app **backup** copies that application's state directory into- `~/.os-vps/backups/<app>/<timestamp>/`, including any credentials the application keeps there —+ `~/.mso/backups/<app>/<timestamp>/`, including any credentials the application keeps there —`~/.openclaw/credentials/` and `identity/` are in scope, and so is anything secret in`openclaw.json` or under `~/.hermes`. Treat those copies exactly like the application's ownconfig: never publish them, and include them when you rotate that application's secrets. The@@ -92,7 +92,7 @@ Operational rules for anyone maintaining a split-origin deployment:bypass, or rate-limit defeat that enables practical brute force.- Filesystem jail escape: reading or writing outside `OS_FS_READ_ROOTS` /`OS_FS_WRITE_ROOTS`, or reaching denied credential material such as `.env*` or- `~/.os-vps/*` through the file APIs.+ `~/.mso/*` through the file APIs.- Unauthenticated access to live host routes such as `/api/v1/*`,`/api/assistant`, `/api/config`, or `/api/auth/devices`.- CSRF or clickjacking that triggers host actions cross-origin.@@ -117,7 +117,7 @@ Operational rules for anyone maintaining a split-origin deployment:## Key rotation-BYOK AI credentials are stored server-side in `~/.os-vps/config.json`, never in+BYOK AI credentials are stored server-side in `~/.mso/config.json`, never inthe client bundle. To rotate a key, stop MSO, edit the config file or remove theprovider from Settings → AI, then restart/sign in again.@@ -125,11 +125,11 @@ To rotate auth secrets:- Change `OS_SESSION_SECRET` and restart to invalidate sessions.- Change `OS_LOGIN_PASSWORD` and restart to require the new password.-- Remove entries from `~/.os-vps/auth-devices.json` to revoke devices.+- Remove entries from `~/.mso/auth-devices.json` to revoke devices.## Audit log retention-The JSONL audit trail defaults to `~/.os-vps/audit.log` and can grow over time.+The JSONL audit trail defaults to `~/.mso/audit.log` and can grow over time.Use logrotate or your normal host log retention system. Do not publish auditlogs without checking for private paths, command names, or other sensitivecontext.diff --git a/app/api/auth/session-cookie.test.ts b/app/api/auth/session-cookie.test.tsindex 8e3366a9..b4ff0345 100644--- a/app/api/auth/session-cookie.test.ts+++ b/app/api/auth/session-cookie.test.ts@@ -27,14 +27,14 @@ const loginReq = (host: string) =>body: JSON.stringify({ password: PASSWORD, deviceId: DEVICE, deviceLabel: "test" }),});-async function login(host = "os.rahmanef.com"): Promise<string[]> {+async function login(host = "mso.rahmanef.com"): Promise<string[]> {const { POST } = await import("./login/route");const res = await POST(loginReq(host) as never);expect(res.status).toBe(200);return res.headers.getSetCookie();}-async function logout(host = "os.rahmanef.com"): Promise<string[]> {+async function logout(host = "mso.rahmanef.com"): Promise<string[]> {const { POST } = await import("./logout/route");const res = await POST(new Request("http://internal/api/auth/logout", { method: "POST", headers: { host } }));return res.headers.getSetCookie();@@ -77,12 +77,12 @@ describe("session cookie on the wire — host-only (default)", () => {describe("session cookie on the wire — OS_SESSION_COOKIE_DOMAIN set", () => {beforeEach(() => {- process.env.OS_SESSION_COOKIE_DOMAIN = "os.rahmanef.com";+ process.env.OS_SESSION_COOKIE_DOMAIN = "mso.rahmanef.com";});it("login widens to the domain, keeping every other attribute", async () => {const [cookie] = await login();- expect(cookie).toContain("Domain=os.rahmanef.com");+ expect(cookie).toContain("Domain=mso.rahmanef.com");expect(cookie).toContain("HttpOnly");expect(cookie).toContain("Secure");expect(cookie.toLowerCase()).toContain("samesite=strict");@@ -91,7 +91,7 @@ describe("session cookie on the wire — OS_SESSION_COOKIE_DOMAIN set", () => {it("logout clears BOTH the domain cookie and the pre-widening host-only one", async () => {const cookies = await logout();expect(cookies).toHaveLength(2);- const withDomain = cookies.find((c) => c.includes("Domain=os.rahmanef.com"));+ const withDomain = cookies.find((c) => c.includes("Domain=mso.rahmanef.com"));const hostOnly = cookies.find((c) => !c.toLowerCase().includes("domain="));expect(withDomain).toContain("Max-Age=0");expect(hostOnly).toContain("Max-Age=0");diff --git a/app/api/models/route.ts b/app/api/models/route.tsindex 3e762e44..5704d368 100644--- a/app/api/models/route.ts+++ b/app/api/models/route.ts@@ -19,7 +19,7 @@ export async function GET(req: NextRequest) {const provider = req.nextUrl.searchParams.get("provider");// An OAuth provider's models come from the ACCOUNT, not from models.dev. Its slug- // ("openai-codex") is local to os-vps and models.dev has never heard of it, so the+ // ("openai-codex") is local to mso and models.dev has never heard of it, so the// filter below matched nothing and the picker came up empty the moment ChatGPT auth// was connected — the account's own list had been fetched during OAuth and thrown// away. Nothing from the bundle but model IDs is ever returned: the access tokendiff --git a/app/api/sw/route.ts b/app/api/sw/route.tsindex 2ed9307e..5e66021a 100644--- a/app/api/sw/route.ts+++ b/app/api/sw/route.ts@@ -9,8 +9,8 @@ import { NextResponse } from "next/server";// never JS chunks/HTML, so a redeploy can't strand a stale chunk.const BUILD_ID = process.env.NEXT_PUBLIC_BUILD_ID || "dev";-const SW = `// os-vps service worker — build ${BUILD_ID}-const CACHE = "os-vps-${BUILD_ID}";+const SW = `// mso service worker — build ${BUILD_ID}+const CACHE = "mso-${BUILD_ID}";// The two names here until 2026-07-30 were "/icon-192.png" and "/icon-512.png", which// do not exist and never did — app/manifest.ts has always pointed at the SVGs. Next's// catch-all answers an unknown path with the app HTML and a 200, so addAll() did notdiff --git a/app/api/threads/route.ts b/app/api/threads/route.tsindex 6e16ac35..71595dcb 100644--- a/app/api/threads/route.ts+++ b/app/api/threads/route.ts@@ -5,7 +5,7 @@ import { listThreads, getThread, saveThread, deleteThread, type ChatThread } froexport const runtime = "nodejs";export const dynamic = "force-dynamic";-// Persistent Alfa chat threads (YAML files in ~/.os-vps/threads/). Session-gated.+// Persistent Alfa chat threads (YAML files in ~/.mso/threads/). Session-gated.// GET → list summaries// GET ?id=<id> → one full thread// POST { id, title?, createdAt?, messages[], history[] } → save (create/update)diff --git a/app/api/v1/managed-apps/[id]/jobs/[jobId]/route.ts b/app/api/v1/managed-apps/[id]/jobs/[jobId]/route.tsindex 7441659c..512b1bca 100644--- a/app/api/v1/managed-apps/[id]/jobs/[jobId]/route.ts+++ b/app/api/v1/managed-apps/[id]/jobs/[jobId]/route.ts@@ -35,7 +35,7 @@ export async function GET(req: Request, context: { params: Promise<{ id: string;// a terminal status, so anything that leaves one running — a leaked grandchild// keeping the pipes open past its own reaper, a CLI that hangs below its timeout —// makes every later start/stop/restart/update/backup on that app answer 409. The-// only other cure is restarting os-vps, which is precisely what an operator must+// only other cure is restarting mso, which is precisely what an operator must// not do mid-update. It cannot end a healthy job by accident: the exact 24-hex id// AND its owning app are required, the outcome is always `failed` and never// `succeeded`, and cancelManagedAppJob refuses (false, never throws) while the jobdiff --git a/app/api/v1/managed-apps/[id]/proxy/[[...path]]/route.ts b/app/api/v1/managed-apps/[id]/proxy/[[...path]]/route.tsindex b4d5cbf9..194d7e5b 100644--- a/app/api/v1/managed-apps/[id]/proxy/[[...path]]/route.ts+++ b/app/api/v1/managed-apps/[id]/proxy/[[...path]]/route.ts@@ -98,7 +98,7 @@ async function proxy(req: Request, context: { params: Promise<{ id: string; pathif (segments.some((segment) => !segment || segment === "." || segment === ".." || segment.includes("\\") || segment.includes("\0"))) {return fail("invalid upstream path", 400);}- // A service worker registered from proxied bytes installs on the OS-VPS origin+ // A service worker registered from proxied bytes installs on the MSO origin// and keeps serving after the window closes. Never hand one to the browser.if (isServiceWorkerPath(segments)) {return fail("service workers are not proxied", 404);diff --git a/app/api/v1/managed-apps/[id]/update/route.ts b/app/api/v1/managed-apps/[id]/update/route.tsindex e2373337..87fdff4d 100644--- a/app/api/v1/managed-apps/[id]/update/route.ts+++ b/app/api/v1/managed-apps/[id]/update/route.ts@@ -37,7 +37,7 @@ function statusFor(reason: string): number {}// READ-ONLY, and that is load-bearing: the CSRF gate in proxy.ts only covers-// POST/PUT/PATCH/DELETE, and the session cookie is Domain=os.rahmanef.com with+// POST/PUT/PATCH/DELETE, and the session cookie is Domain=mso.rahmanef.com with// SameSite=Strict, so every sibling origin under rahmanef.com (~100 on this// box) can make the browser send this GET. If it probed, that would be a blind// cross-origin trigger for `hermes update --check` — two git fetches inside thediff --git a/app/api/v1/managed-apps/job-cancel-route.test.ts b/app/api/v1/managed-apps/job-cancel-route.test.tsindex d6b83dde..9f5e144a 100644--- a/app/api/v1/managed-apps/job-cancel-route.test.ts+++ b/app/api/v1/managed-apps/job-cancel-route.test.ts@@ -1,7 +1,7 @@// DELETE /api/v1/managed-apps/[id]/jobs/[jobId] — the way out of a wedged// operation. A job holds the app's lock until it reaches a terminal status, so// one that never finishes makes every later start/stop/restart/update/backup on-// that app answer 409. The only other cure is restarting os-vps, which is the one+// that app answer 409. The only other cure is restarting mso, which is the one// thing an operator must not do mid-update. Gates are asserted here rather than// assumed: this verb ends someone's running update.import { beforeEach, describe, expect, it, vi } from "vitest";diff --git a/app/api/v1/managed-apps/proxy-split-origin.test.ts b/app/api/v1/managed-apps/proxy-split-origin.test.tsindex c1d47115..3adffb0c 100644--- a/app/api/v1/managed-apps/proxy-split-origin.test.ts+++ b/app/api/v1/managed-apps/proxy-split-origin.test.ts@@ -1,5 +1,5 @@// The proxy route in SPLIT-ORIGIN mode: the dashboard is root-mounted on its own-// host (hermes.os.rahmanef.com), which is what finally closes the window.top reach+// host (hermes.mso.rahmanef.com), which is what finally closes the window.top reach// — the frame is cross-origin now, so `allow-same-origin` no longer grants the// upstream a handle on the cockpit. Two claims are load-bearing here:// 1. the OLD same-origin URL must stop answering, or the hole survives at it;@@ -28,11 +28,11 @@ vi.mock("@/lib/managed-apps/catalog", async () => {const fetchMock = vi.fn();vi.stubGlobal("fetch", fetchMock);-const TEMPLATE = "{id}.os.rahmanef.com";-const APP_HOST = "hermes.os.rahmanef.com";+const TEMPLATE = "{id}.mso.rahmanef.com";+const APP_HOST = "hermes.mso.rahmanef.com";const APP_ORIGIN = `https://${APP_HOST}/`;const APP_SOCKET = APP_ORIGIN.replace("https:", "wss:");-const COCKPIT = "https://os.rahmanef.com";+const COCKPIT = "https://mso.rahmanef.com";const PREFIX = "/api/v1/managed-apps/hermes/proxy";// Verbatim head of ~/.hermes/hermes-agent/hermes_cli/web_dist/index.html.@@ -79,9 +79,9 @@ beforeEach(() => {describe("the cockpit-origin URL stops answering", () => {it("404s the proxy route without the middleware's app-host stamp", async () => {const { GET } = await route();- // Same URL as before the split, on os.rahmanef.com: same-origin with the+ // Same URL as before the split, on mso.rahmanef.com: same-origin with the// cockpit, allow-same-origin frame — the hole. It must not serve.- const res = await GET(new Request(`${COCKPIT}${PREFIX}/chat`, { headers: { host: "os.rahmanef.com" } }), ctx(["chat"]));+ const res = await GET(new Request(`${COCKPIT}${PREFIX}/chat`, { headers: { host: "mso.rahmanef.com" } }), ctx(["chat"]));expect(res.status).toBe(404);expect(fetchMock).not.toHaveBeenCalled();});@@ -98,7 +98,7 @@ describe("the cockpit-origin URL stops answering", () => {fetchMock.mockResolvedValueOnce(new Response("ok", { status: 200 }));const { GET } = await route();await GET(- appReq("chat", { headers: { cookie: "session=os-vps-secret; mapp_hermes_session=upstream-sid" } }),+ appReq("chat", { headers: { cookie: "session=mso-secret; mapp_hermes_session=upstream-sid" } }),ctx(["chat"]),);expect((fetchMock.mock.calls[0][1].headers as Headers).get("cookie")).toBe("session=upstream-sid");@@ -241,7 +241,7 @@ describe("root-mounted policy", () => {it.each([["unset", ""],- ["missing a scheme", "os.rahmanef.com"],+ ["missing a scheme", "mso.rahmanef.com"],])("falls back to the host template's parent when OS_PUBLIC_ORIGIN is %s", async (_label, value) => {fetchMock.mockResolvedValueOnce(new Response("ok", { status: 200 }));const { GET } = await route(TEMPLATE, value);diff --git a/app/api/v1/managed-apps/proxy.test.ts b/app/api/v1/managed-apps/proxy.test.tsindex eec315ea..513d52d3 100644--- a/app/api/v1/managed-apps/proxy.test.ts+++ b/app/api/v1/managed-apps/proxy.test.ts@@ -28,7 +28,7 @@ vi.stubGlobal("fetch", fetchMock);const PREFIX = "/api/v1/managed-apps/hermes/proxy";const HOST_HEADER = "x-os-managed-app-host";// Dashboards are only served from an app host, so every test runs in that shape.-const APP_HOSTS = "{id}.os.rahmanef.com";+const APP_HOSTS = "{id}.mso.rahmanef.com";const ctx = (path: string[]) => ({ params: Promise.resolve({ id: "hermes", path }) });// Middleware stamps the app host it matched; the route 404s without it, because that@@ -55,15 +55,15 @@ beforeEach(async () => {});describe("managed-app proxy cookie isolation", () => {- it("never forwards the os-vps session cookie, only namespaced ones", async () => {+ it("never forwards the mso session cookie, only namespaced ones", async () => {fetchMock.mockResolvedValueOnce(new Response("ok", { status: 200 }));const { GET } = await import("./[id]/proxy/[[...path]]/route");await GET(req("chat", {headers: {- cookie: "session=os-vps-secret; os-vps-device=deadbeef; mapp_hermes_session=upstream-sid",+ cookie: "session=mso-secret; mso-device=deadbeef; mapp_hermes_session=upstream-sid",origin: "http://localhost",- referer: "https://hermes.os.rahmanef.com/login?next=%2Fchat",+ referer: "https://hermes.mso.rahmanef.com/login?next=%2Fchat",},}),ctx(["chat"]),@@ -71,7 +71,7 @@ describe("managed-app proxy cookie isolation", () => {const sent = sentHeaders();// De-prefixed back to the upstream's own cookie name, nothing else.expect(sent.get("cookie")).toBe("session=upstream-sid");- expect(sent.get("cookie")).not.toContain("os-vps-secret");+ expect(sent.get("cookie")).not.toContain("mso-secret");expect(sent.get("cookie")).not.toContain("deadbeef");// Login/CSRF checks compare these against the upstream's own origin.expect(sent.get("origin")).toBe("http://127.0.0.1:9119");@@ -81,7 +81,7 @@ describe("managed-app proxy cookie isolation", () => {it("sends no cookie header at all when the browser holds none for the app", async () => {fetchMock.mockResolvedValueOnce(new Response("ok", { status: 200 }));const { GET } = await import("./[id]/proxy/[[...path]]/route");- await GET(req("chat", { headers: { cookie: "session=os-vps-secret" } }), ctx(["chat"]));+ await GET(req("chat", { headers: { cookie: "session=mso-secret" } }), ctx(["chat"]));expect(sentHeaders().has("cookie")).toBe(false);});@@ -165,7 +165,7 @@ describe("managed-app proxy cookie isolation", () => {expect(res.status).toBe(401);expect(res.headers.get("vary")).toBe("Cookie");expect(res.headers.get("content-disposition")).toBe("inline");- // Relaying the challenge would make the browser prompt on the os-vps origin.+ // Relaying the challenge would make the browser prompt on the mso origin.expect(res.headers.get("www-authenticate")).toBeNull();});@@ -190,15 +190,15 @@ describe("managed-app proxy cookie isolation", () => {}),);const { GET } = await import("./[id]/proxy/[[...path]]/route");- const res = await GET(req("chat", { headers: { host: "os.rahmanef.com", "x-forwarded-proto": "https" } }), ctx(["chat"]));+ const res = await GET(req("chat", { headers: { host: "mso.rahmanef.com", "x-forwarded-proto": "https" } }), ctx(["chat"]));const csp = res.headers.get("content-security-policy")!;- const appUrl = "https://hermes.os.rahmanef.com/";+ const appUrl = "https://hermes.mso.rahmanef.com/";expect(res.headers.get("x-frame-options")).toBeNull();// The upstream's hash pin survives; its frame-ancestors 'none' does not, or the// cockpit could not display the dashboard it is proxying.expect(csp).toContain(`script-src ${appUrl} 'sha256-abc='`);- expect(csp).toContain("frame-ancestors 'self' https://os.rahmanef.com");- expect(csp).toContain(`connect-src ${appUrl} wss://hermes.os.rahmanef.com/ https://api.openai.com`);+ expect(csp).toContain("frame-ancestors 'self' https://mso.rahmanef.com");+ expect(csp).toContain(`connect-src ${appUrl} wss://hermes.mso.rahmanef.com/ https://api.openai.com`);expect(csp).not.toContain("'unsafe-inline'");});});diff --git a/app/api/v1/managed-apps/update-route.test.ts b/app/api/v1/managed-apps/update-route.test.tsindex 11011a94..45115cc1 100644--- a/app/api/v1/managed-apps/update-route.test.ts+++ b/app/api/v1/managed-apps/update-route.test.ts@@ -22,7 +22,7 @@ vi.mock("@/lib/demo", () => ({return demo.value;},}));-// The real audit appends to ~/.os-vps/audit.log — the OPERATOR's, since this+// The real audit appends to ~/.mso/audit.log — the OPERATOR's, since this// runs as them. Spied instead of written. The limiter is faked so the budget// one test spends cannot leak into the next (it is process-global and has no// reset); rate-limit.test.ts covers the counting itself.@@ -114,7 +114,7 @@ describe("the gates, in order", () => {describe("what each action answers with", () => {// The GET sits OUTSIDE the CSRF gate (proxy.ts covers mutating verbs only)- // and the session cookie is Domain=os.rahmanef.com, so any sibling origin can+ // and the session cookie is Domain=mso.rahmanef.com, so any sibling origin can// make a browser send it. If it probed, that would be a blind cross-origin// trigger for `hermes update --check` — two git fetches in the operator's// checkout. It reads the cache; the probe is a POST, behind the gate.diff --git a/app/layout.tsx b/app/layout.tsxindex 96887037..5dd3dac9 100644--- a/app/layout.tsx+++ b/app/layout.tsx@@ -7,7 +7,7 @@ import { InstallPrompt } from "./install-prompt";import "./globals.css";export const metadata: Metadata = {- metadataBase: new URL("https://os.rahmanef.com"),+ metadataBase: new URL("https://mso.rahmanef.com"),applicationName: "Manef Shell OS",title: "Manef Shell OS — browser-based server control plane",description: "A browser-based graphical shell for a Linux server you own — terminal, files, metrics, and AI in one mobile-first pane.",@@ -63,7 +63,7 @@ export default async function RootLayout({nonce={nonce}dangerouslySetInnerHTML={{__html:- 'try{var t=JSON.parse(localStorage.getItem("os-vps:tweaks"));if(t&&t.theme)document.documentElement.dataset.theme=t.theme;}catch(e){}',+ 'try{var t=JSON.parse(localStorage.getItem("mso:tweaks"));if(t&&t.theme)document.documentElement.dataset.theme=t.theme;}catch(e){}',}}/>{children}diff --git a/app/register-sw.tsx b/app/register-sw.tsxindex f9783019..d48b8118 100644--- a/app/register-sw.tsx+++ b/app/register-sw.tsx@@ -4,7 +4,7 @@ import { useEffect } from "react";import { toast } from "@/features/os-shell";// One-shot guard (per tab) so recovery never loops.-const GUARD = "osvps_chunk_recover";+const GUARD = "mso_chunk_recover";// A failed dynamic import (new deploy → old chunk ref a stale cache/SW still// points at) throws ChunkLoadError. Detect it broadly.diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.mdindex 625dd0a1..29c1545a 100644--- a/docs/ARCHITECTURE.md+++ b/docs/ARCHITECTURE.md@@ -1,4 +1,4 @@-# os-vps (Manef Shell OS) — Architecture+# mso (Manef Shell OS) — Architecture> ## ⚠ HISTORY, NOT CURRENT STATE>@@ -15,7 +15,7 @@> the CSP is shaped as it is — which remains valuable and is hard to recover.>> The earlier Convex + Control-Room-agent design (see `DESIGN-RECONCILE.md`, early-> `PROGRESS.md` phases) was removed: os-vps runs **as a host process** and talks to+> `PROGRESS.md` phases) was removed: mso runs **as a host process** and talks to> its own machine directly. No database, no external agent.## What it is@@ -29,11 +29,11 @@ applications already on the box (Hermes, OpenClaw) — managing them through theCLIs and HTTP surfaces, and framing each one's dashboard from an origin of its own.```-phone / browser ──https──> os.rahmanef.com ─────────┐+phone / browser ──https──> mso.rahmanef.com ─────────┐signed-cookie auth (lib/auth) │- ├─> os-vps (Next.js :4005) ──┬── lib/host → Node fs / child_process (host, non-root)- the app iframe ──https──> hermes.os.rahmanef.com ──┤ ONE process, 3 origins └── os-browser (Playwright :4002, loopback, optional)- the app iframe ──https──> openclaw.os.rahmanef.com ┘+ ├─> mso (Next.js :4005) ──┬── lib/host → Node fs / child_process (host, non-root)+ the app iframe ──https──> hermes.mso.rahmanef.com ──┤ ONE process, 3 origins └── os-browser (Playwright :4002, loopback, optional)+ the app iframe ──https──> openclaw.mso.rahmanef.com ┘▲ proxy.ts rewrites EVERY path on an app host into/api/v1/managed-apps/<id>/proxy → loopback Hermes :9119 /OpenClaw :18789. Nothing else is reachable there — the cockpit@@ -48,7 +48,7 @@ for why the dashboards need origins of their own.## Layout (mirrors `resources/` so slices stay lift-ready)```-os-vps/+mso/├── app/ Next 16 App Router│ ├── layout.tsx fonts + theme + providers│ ├── globals.css Tailwind 4 + glass theme tokens@@ -58,7 +58,7 @@ os-vps/│ │ managed-apps (state/actions/logs/features + dashboard proxy)│ ├── health/ tiny liveness probe (200 OK) for uptime checks│ ├── auth/ login · logout · me · devices-│ ├── config/ BYOK AI key (read/write ~/.os-vps/config.json)+│ ├── config/ BYOK AI key (read/write ~/.mso/config.json)│ └── assistant/ Claude SSE stream (BYOK)├── components/ui/ shadcn (new-york) primitives — app-wide├── components/shared/ cross-slice primitives (file-tree, …) via @/shared/*@@ -70,12 +70,12 @@ os-vps/│ │ ├── sys.ts cpu/mem/disk/uptime/processes│ │ ├── host-error.ts / api-error.ts HostError + apiError + readJson/requireString kit│ │ ├── paths.ts read/write root jail + realpath bounds check-│ │ ├── audit.ts append-only JSONL audit (~/.os-vps/audit.log) — writes serialized through a chained promise so bursty callers land in submission order+│ │ ├── audit.ts append-only JSONL audit (~/.mso/audit.log) — writes serialized through a chained promise so bursty callers land in submission order│ │ ├── rate-limit.ts fixed-window in-memory limiter│ │ └── index.ts barrel│ ├── auth/ session.ts (HMAC sign/verify) · require-session.ts ·-│ │ device-store.ts (~/.os-vps/auth-devices.json)-│ ├── config/ store.ts (~/.os-vps/config.json — BYOK key + model)+│ │ device-store.ts (~/.mso/auth-devices.json)+│ ├── config/ store.ts (~/.mso/config.json — BYOK key + model)│ ├── managed-apps/ Hermes/OpenClaw control plane: catalog · manager · runner ·│ │ features + feature-parser · and the dashboard reverse proxy│ │ (origin · proxy-csp · proxy-headers · proxy-html)@@ -94,7 +94,7 @@ os-vps/│ │ shell-widgets pluggable features mounted via <Slot region>│ ├── managed-apps/ Hermes/OpenClaw surfaces: the manage window, per-feature│ │ windows (iframe + CLI fallback), icons, workspace app lists-│ └── os-shell/ os-vps consumer: shell.manifest.ts (brand+apps+features)+│ └── os-shell/ mso consumer: shell.manifest.ts (brand+apps+features)│ + re-export barrel (@/features/os-shell)├── os-browser/ Playwright Chromium service (gitignored, deploy-local)├── public/demo-media/ real sample media so the mock demo can open files@@ -127,9 +127,9 @@ host kernel (as the unprivileged service user — NOT root)state lives in a module-level store read via `useSyncExternalStore`; only thedragged window subscribes to its own rect.- **Persistence is local.** Window layout + installed-app registry → `localStorage`- (the demo also persists its mock FS to `localStorage`, key `os-vps:demo-fs`).- Device allowlist → `~/.os-vps/auth-devices.json`; BYOK key/model →- `~/.os-vps/config.json`; audit trail → `~/.os-vps/audit.log`.+ (the demo also persists its mock FS to `localStorage`, key `mso:demo-fs`).+ Device allowlist → `~/.mso/auth-devices.json`; BYOK key/model →+ `~/.mso/config.json`; audit trail → `~/.mso/audit.log`.- **Apps lazy-mount.** A window mounts its app component only when opened.- **Shared shell primitives.** `MasterDetail` + `AppFrame` + `useResponsive`back the responsive layout of system-monitor / assistant / os-settings (more@@ -197,7 +197,7 @@ Signed-cookie sessions — no Convex, no Clerk.- **Factor 1**: `OS_LOGIN_PASSWORD` (weak/memorable), checked constant-time.- **Factor 2**: the device must be in the approved allowlist- (`~/.os-vps/auth-devices.json`). A correct password on a new device registers+ (`~/.mso/auth-devices.json`). A correct password on a new device registersit `pending`; **no session is issued until approved**(`node scripts/approve-device.js <deviceId> "name"`).- On success: an HMAC-SHA256 cookie signed with `OS_SESSION_SECRET` (≥32 bytes),@@ -212,7 +212,7 @@ MSO is the shell / control plane. Hermes and OpenClaw stay **separate applicatiotheir own runtime, config, data, versions, health, logs and backups. MSO does not copy,fork or merge their source, does not scrape their DOM, and writes nothing under`~/.hermes/` or `~/.openclaw/` — reading those trees is how discovery works, but the-only writes are into `~/.os-vps/`. Everything else goes through the app's own CLI, its+only writes are into `~/.mso/`. Everything else goes through the app's own CLI, itsown HTTP surface, or systemd/docker. Full operator guide: `docs/MANAGED-APPS.md`.- **catalog** (`lib/managed-apps/catalog.ts:13`) — one definition per app: `command`,@@ -230,7 +230,7 @@ own HTTP surface, or systemd/docker. Full operator guide: `docs/MANAGED-APPS.md`double-click cannot interleave a stop with a restart. Live now: both apps `systemd` / `running`/ `healthy: true` through `listManagedApps()`.- **backup** (`manager.ts:141`) copies the app's state dir (`HERMES_HOME` honoured) to- `~/.os-vps/backups/<id>/<timestamp>/` (per-app dir 0700, `manifest.json` 0600), skipping+ `~/.mso/backups/<id>/<timestamp>/` (per-app dir 0700, `manifest.json` 0600), skipping`node_modules`/`.venv`/`venv`/`__pycache__`/`.git`/`.cache`/`backups` and **skipping symlinks**rather than following or recreating them — following one copies bytes from outside the app,recreating an absolute one aims a future restore outside the tree; the manifest records both@@ -270,7 +270,7 @@ demo mode, rate-limits to 12/min per app, and audits both outcomes as**Workspace modes — REMOVED in `a2c3882`; this describes the old design.** They(`frontend/slices/os-shell/workspace-mode.ts`, deleted) decided *which* app'sfeatures populate the dock/launchpad: `plain | hermes | openclaw`, stored in-`localStorage` under `os-vps:workspace-mode` and read through `useSyncExternalStore`.+`localStorage` under `mso:workspace-mode` and read through `useSyncExternalStore`.This is orthogonal to Shell Style (macos/windows/dashboard/ios/android) — a workspace iswhich apps exist, a shell is what they look like. Switching writes one key and fires oneevent: nothing restarts, no service is touched. Each discovered feature becomes an@@ -283,7 +283,7 @@ Each app's own dashboard is reverse-proxied and rendered in an OS window as an iThe upstream target must be loopback or the route refuses it(`app/api/v1/managed-apps/[id]/proxy/[[...path]]/route.ts:114`) — the proxy is not ageneral-purpose fetcher. Cookies are namespaced (`mapp_<id>_`) and pinned to that app's-mount, the os-vps `session` cookie is never forwarded upstream, `authorization` is never+mount, the mso `session` cookie is never forwarded upstream, `authorization` is neverforwarded and `www-authenticate` never returned (together they would make the proxy acredential relay), off-origin redirects are refused rather than passed on (they are anopen redirect **and** a CSP path-matching bypass), and an upstream service worker is@@ -300,8 +300,8 @@ origin.** The iframe needs `allow-same-origin` or these SPAs do not boot at all.cockpit origin that made upstream JS same-origin *with the cockpit*: it could take`window.top.fetch` and call `/api/v1/exec/run` with the user's session. No CSP closesthat — a policy binds a realm, not a reference across realms. So each dashboard is-served from its **own host on this same process**: `hermes.os.rahmanef.com`,-`openclaw.os.rahmanef.com`. `window.top` is then cross-origin and opaque (measured in+served from its **own host on this same process**: `hermes.mso.rahmanef.com`,+`openclaw.mso.rahmanef.com`. `window.top` is then cross-origin and opaque (measured inChromium 148; the properties and the same-origin control are listed in`docs/MANAGED-APPS.md` §5). One host **per app**, not one shared host:a shared one puts Hermes and OpenClaw back in a single origin where they can script each@@ -372,20 +372,20 @@ the policy intersection, the header rules and the host gating.A separate Playwright Chromium service (`os-browser/`, systemd, **loopback**:4002, gitignored). `lib/agent/server.ts` proxies the `/api/v1/browser/*` routesto it (secret-gated, server-only). Renders any site, drivable from the UI, with-a persistent profile (`~/.os-vps/chrome-profile`) so logins stick. Leave+a persistent profile (`~/.mso/chrome-profile`) so logins stick. Leave`OS_BROWSER_URL`/`OS_BROWSER_SECRET` unset to disable the app — everything elsestill works.## Deployment-- **prod** — `os-vps.service` :4005 (systemd, `User=rahman`, WorkingDir- `/home/rahman/projects/os-vps`).-- **demo** — `os-vps-demo.service` :4006 (`NEXT_PUBLIC_OS_DEMO=1`, separate- WorkingDir `/home/rahman/projects/os-vps-demo`, mock-only, no host access).+- **prod** — `mso.service` :4005 (systemd, `User=rahman`, WorkingDir+ `/home/rahman/projects/mso`).+- **demo** — `mso-demo.service` :4006 (`NEXT_PUBLIC_OS_DEMO=1`, separate+ WorkingDir `/home/rahman/projects/mso-demo`, mock-only, no host access).- **os-browser** — `os-browser.service` :4002 (loopback).-- **managed-app origins** — `hermes.os.rahmanef.com` and `openclaw.os.rahmanef.com`, each+- **managed-app origins** — `hermes.mso.rahmanef.com` and `openclaw.mso.rahmanef.com`, eachits own DNS record and TLS cert, both routed to the same `172.17.0.1:4005` by- `/etc/dokploy/traefik/dynamic/os-vps-managed-apps.yml` (`passHostHeader: true`, so the+ `/etc/dokploy/traefik/dynamic/mso-managed-apps.yml` (`passHostHeader: true`, so theprocess sees the public name). Adding an app to the catalog means adding a router there and aDNS record **in the same change**: the host template applies to every catalog id, so a newapp's iframe points at `<newid>.os.…` the moment it exists, and with no record for that namediff --git a/docs/AUDIT-2026-06-11.md b/docs/AUDIT-2026-06-11.mdindex 296a7433..8405190c 100644--- a/docs/AUDIT-2026-06-11.md+++ b/docs/AUDIT-2026-06-11.md@@ -1,4 +1,4 @@-# os-vps Full Audit — 2026-06-11+# mso Full Audit — 2026-06-11> Method: six parallel audit passes over HEAD `84e857c` (security, shell core,> app slices, shell fidelity inventory, Next/React best-practice with Context7@@ -168,7 +168,7 @@ Verified solid: every `/api/*` route gates with `verifyAuth`/`requireSession`first (coverage table checked route-by-route); realpath-before-bounds jailwith no working traversal/symlink escape (tmp+rename writes never write*through* a symlink); timing-safe compares with fail-closed weak-secret-rejection; `SameSite=Strict` + `Sec-Fetch-Site` CSRF depth-2; `~/.os-vps`+rejection; `SameSite=Strict` + `Sec-Fetch-Site` CSRF depth-2; `~/.mso`0700/0600 atomic writes; BYOK key masked; SVG served with `CSP: sandbox`;demo mode can't be flipped into an open host shell.@@ -183,7 +183,7 @@ demo mode can't be flipped into an open host shell.`.zsh_history`. Extend or soften the README claim.- **P2 — browser fill/type audit lines persist typed text** —`lib/agent/server.ts:52-54`: passwords typed into third-party sites via the- Browser app land in plaintext in `~/.os-vps/audit.log`. Redact value/text.+ Browser app land in plaintext in `~/.mso/audit.log`. Redact value/text.- **P2 — child processes inherit the full secret env** (`lib/host/exec.ts:89`,`pty.ts:90`): one `printenv` reveals `OS_SESSION_SECRET` etc. — defeats thedenylist's stated purpose (persistence after revocation). Scrub `OS_*` +diff --git a/docs/AUDIT-2026-06-14.md b/docs/AUDIT-2026-06-14.mdindex 80193a86..c675f3cc 100644--- a/docs/AUDIT-2026-06-14.md+++ b/docs/AUDIT-2026-06-14.md@@ -1,4 +1,4 @@-# os-vps Audit Follow-up — 2026-06-14+# mso Audit Follow-up — 2026-06-14> Brief delta over [`AUDIT-2026-06-11.md`](./AUDIT-2026-06-11.md). Captures> what the 13-tick loop (T2→T14, see `PROGRESS.md`) closed and what staysdiff --git a/docs/DESIGN-RECONCILE.md b/docs/DESIGN-RECONCILE.mdindex 2544984c..93dd8ced 100644--- a/docs/DESIGN-RECONCILE.md+++ b/docs/DESIGN-RECONCILE.md@@ -1,10 +1,10 @@-# Design Reconcile — `mock-os` (os-rr) → os-vps+# Design Reconcile — `mock-os` (os-rr) → mso> **ARCHIVE (historical).** This records the Phase-1 decision to adopt the os-rr> design + Cloud API contract. The **visual/design adoption still holds** (glass> tokens, shell chrome, mobile shell, the `OsApi` mock↔http boundary). The> **backend assumptions are obsolete**: Convex + the Control-Room agent bridge-> were later removed — os-vps is now self-contained (`lib/host` does fs/exec/sys+> were later removed — mso is now self-contained (`lib/host` does fs/exec/sys> directly, signed-cookie auth). For the current system read `ARCHITECTURE.md`.> The "Revised architecture" diagram below is kept only as a record of the old plan.>@@ -12,7 +12,7 @@> deleted on 2026-07-30 as part of a dead-weight sweep: 101 files, 5.7k lines and 6.6 MB> that nothing in the app, the build, the tests or the lint pass ever touched. It is> recoverable two ways — `git show bccd0b1:mock-os/<path>` for any tracked file, and-> `~/archive/os-vps-cleanup-2026-07-30/mock-os.tar.gz` for the whole tree including the+> `~/archive/mso-cleanup-2026-07-30/mock-os.tar.gz` for the whole tree including the> untracked `Apple-clone-app/`. Every `mock-os/...` path below should be read against one> of those, not against a working directory.@@ -20,7 +20,7 @@ The uploaded `mock-os/` is **os-rr**: a macOS-style browser shell prototype that*explicitly a VPS front-end*. It is not just a visual reference — it ships adefined **Cloud API contract** (`mock-os/js/core/api.jsx` + `os-rr API.html`)that is the single boundary between the desktop and a VPS daemon. This matches-os-vps's purpose and gives us the concrete agent-bridge spec Phase 2 needed.+mso's purpose and gives us the concrete agent-bridge spec Phase 2 needed.## What os-rr is@@ -113,7 +113,7 @@ browser ── os-shell (window mgr, module store)- **What carried over**: the `OsApi` mock↔http boundary, the glass design tokens,shell chrome, mobile shell, the os-rr endpoint *shape* (`fs/exec/sys`).- **What changed**: no Convex (layout/registry → `localStorage`; device allowlist- + config → `~/.os-vps/*.json`); no external agent (the Next.js app *is* the host+ + config → `~/.mso/*.json`); no external agent (the Next.js app *is* the hostprocess); auth is a password + device-approval HMAC signed cookie, not`@convex-dev/auth`; the browser is real Playwright (`os-browser`), not a proxy.- **Still demoable with zero host**: `OsApi` defaults to `MockAdapter`.diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.mdindex be4a93e7..97c8a9cb 100644--- a/docs/DEVELOPMENT.md+++ b/docs/DEVELOPMENT.md@@ -3,7 +3,7 @@## Setup```bash-git clone [email protected]:rahmanef63/os-vps.git && cd os-vps+git clone [email protected]:rahmanef63/mso.git && cd msocorepack enable pnpm # uses the pinned pnpm (see "pnpm version" below)pnpm installcp .env.example .env.local # set OS_LOGIN_PASSWORD + OS_SESSION_SECRET (openssl rand -hex 32)@@ -31,11 +31,11 @@ these touch `.next`, so they're safe to run against the prod checkout.## Deploy — and the build hazard ⚠️-os-vps deploys via **systemd on the VPS**, not `git push` (no webhook, no Dokploy/+mso deploys via **systemd on the VPS**, not `git push` (no webhook, no Dokploy/Vercel). A deploy is:```bash-pnpm build && sudo systemctl restart os-vps.service # build THEN restart, in that order+pnpm build && sudo systemctl restart mso.service # build THEN restart, in that order```**Never run `pnpm build` inside the running prod checkout just to "verify" a change.**@@ -48,7 +48,7 @@ instance** on a different port — e.g. a build with `NEXT_PUBLIC_OS_DEMO=1` (nono host access, forced mock data), served on `:4006` via its own systemd unit. For anon-destructive static check, `pnpm typecheck && pnpm lint` is the cheap gate.-Recovery if a chunk mismatch is live: `sudo systemctl restart os-vps.service`.+Recovery if a chunk mismatch is live: `sudo systemctl restart mso.service`.## pnpm versiondiff --git a/docs/DRAWER-MENU-BYOK-PLAN.md b/docs/DRAWER-MENU-BYOK-PLAN.mdindex 20682ceb..b19107a3 100644--- a/docs/DRAWER-MENU-BYOK-PLAN.md+++ b/docs/DRAWER-MENU-BYOK-PLAN.md@@ -12,24 +12,24 @@## 0. Constraints-1. **Do NOT rebuild os-vps to the mock's `prepare(ctx)→os` merge model.** os-vps apps are React+1. **Do NOT rebuild mso to the mock's `prepare(ctx)→os` merge model.** mso apps are Reactcomponents in a window store; that model is fine. Reuse the **existing live bus**, don't fork the shell.2. **VPS essence** — no fabricated hardware in any new chrome.3. **Two-seam safety** — mobile changes ride `mobile-shell.tsx` (iOS-only mount) + `android-shell.tsx`(Android-only mount); shared primitives gate on `useActiveShell().id`, never `surface`.-4. os-vps rules: shadcn primitives, tokens-not-hex, ≤200 lines/file, barrel imports, no new deps.+4. mso rules: shadcn primitives, tokens-not-hex, ≤200 lines/file, barrel imports, no new deps.5. BYOK: SSRF-guard any user base URL; single-owner host-JSON store (no Convex); key stays 0600.## 1. Findings (probe-verified, file:line)### Menu / drawer — the plumbing is ~80% present; only *population* + *in-app trigger* missing- **Mock desktop menu bar** = generic-by-app-**name** template `{apple, app, File, Edit, View, Window, Help}`,- hover-to-switch, `action`-string dispatch. **os-vps already matches this** — `menu-bar.tsx:40-77`+ hover-to-switch, `action`-string dispatch. **mso already matches this** — `menu-bar.tsx:40-77`renders logo · brand · app-name · (File/Edit/View) · Window · Help, and `DefaultMenus`(`menu-bar-menus.tsx:71-118`) are **functional** (New Window, Cut/Copy/Paste, Full Screen, Spotlight, Inspector).- **Mock app contract** = each slice's `prepare(ctx)` returns shell-slot fields (`navTrailing/onTrailing`,`showTabBar/tabItems`, `toolbarActions`, `windowTitle`) + raises drawers via `ctx.act.open*`.- **os-vps apps feed the shell nothing** — each renders its own in-window chrome.+ **mso apps feed the shell nothing** — each renders its own in-window chrome.- **`AppDescriptor.menus`** exists (`lib/types.ts:85`) and both the desktop bar (`menu-bar.tsx:69`) and thehome long-press sheet (`mobile-home-parts.tsx:21`, `AppActionSheet`) already consume it — but **no app populates it**.- **The live data already exists:** the AI-Inspector bus (`appshell/lib/inspector.ts`) publishes per-app@@ -39,8 +39,8 @@(`android-shell.tsx` ~155-161) = back · title. **No per-app action affordance while an app runs** ← the "drawer belum diterapkan".### BYOK — streaming is already custom-baseUrl-ready; gap is storage + UI-- os-vps BYOK (`os-settings/components/ai-section.tsx`) = one active provider+model+key, **8 hardcoded**- providers, plaintext `~/.os-vps/config.json` (0600), **no** custom endpoint / key-test / list-delete / OAuth.+- mso BYOK (`os-settings/components/ai-section.tsx`) = one active provider+model+key, **8 hardcoded**+ providers, plaintext `~/.mso/config.json` (0600), **no** custom endpoint / key-test / list-delete / OAuth.- **Enabler:** streaming already consumes `resolved.baseUrl`+`resolved.protocol` (`lib/ai/openai-stream.ts`,`app/api/assistant/route.ts:100`); `lib/models/resolve.js:47` honors a caller `baseUrl` **for non-built-in slugs**.So custom-provider = **storage + UI + one wiring line**, not a streaming rebuild.diff --git a/docs/FAQ.md b/docs/FAQ.mdindex 38c9f11f..20293507 100644--- a/docs/FAQ.md+++ b/docs/FAQ.md@@ -28,7 +28,7 @@ already-approved device, or from the server with `node scripts/approve-device.jsSSH to the box. Either approve your current device id (shown on the loginscreen) with `scripts/approve-device.js`, or inspect-`~/.os-vps/auth-devices.json` directly. Deleting an entry revokes a device.+`~/.mso/auth-devices.json` directly. Deleting an entry revokes a device.### Can multiple people use it?@@ -39,8 +39,8 @@ It's single-owner by design: one password, one trust level, every session isNothing needs one. Sessions are stateless signed cookies; the deviceallowlist, BYOK key and audit log are small JSON/JSONL files under-`~/.os-vps/`; window layout lives in the browser's localStorage. One process,-no migrations, nothing to back up except `~/.os-vps`.+`~/.mso/`; window layout lives in the browser's localStorage. One process,+no migrations, nothing to back up except `~/.mso`.### Can I run it as root so it can manage the whole box?@@ -65,18 +65,18 @@ contributed through the same manifest. See[ARCHITECTURE.md](./ARCHITECTURE.md) and the slice list in[SLICE-CATALOG.md](./SLICE-CATALOG.md).-### Can I reuse the apps outside os-vps?+### Can I reuse the apps outside mso?Yes — that's deliberate. The shell framework (`appshell`) and several apps(image editor, video editor, file explorer, media viewer, code editor) arepublished as copy-in slices in the [Rahman Resources](https://resource.rahmanef.com)catalog (`npx rr add <slug>`). Each slice's only host coupling is a small`lib/host.ts` seam with injectable adapters, so the same code runs inside-os-vps or standalone in any Next.js app.+mso or standalone in any Next.js app.-### Why is the repo called `os-vps` but the product is "Manef Shell OS"?+### Why is the repo called `mso` but the product is "Manef Shell OS"?-Three names, three jobs: **`os-vps`** is the repo/service/deploy slug (stable+Three names, three jobs: **`mso`** is the repo/service/deploy slug (stablefor paths, systemd units and the domain); **Manef Shell OS** is the productname; **MSO** is the short mark shown in the UI chrome. Renaming the slug wouldbreak every deploy path, so it stays.diff --git a/docs/HERMES-INTEGRATION.md b/docs/HERMES-INTEGRATION.mdindex a5e63f5b..10070347 100644--- a/docs/HERMES-INTEGRATION.md+++ b/docs/HERMES-INTEGRATION.md@@ -39,7 +39,7 @@ one status card, its own dashboard pages as MSO app tiles, and a read-only CLI v| State dir | `~/.hermes` (2.7 GB — **the install lives inside the state dir**) | `catalog.ts:22`, `du -sh` || Dashboard port | `9119`, bound `0.0.0.0` | `ss -tlnp`, unit `--host 0.0.0.0` || Public today | **yes** — `ai.rahmanef.com` | `/etc/dokploy/traefik/dynamic/ai-hermes.yml` → `http://172.17.0.1:9119`, `passHostHeader: true` |-| MSO app host | `hermes.os.rahmanef.com` → os-vps `:4005` → proxy → `127.0.0.1:9119` | `os-vps-managed-apps.yml`, `curl` below |+| MSO app host | `hermes.mso.rahmanef.com` → mso `:4005` → proxy → `127.0.0.1:9119` | `mso-managed-apps.yml`, `curl` below |Two **user** systemd units, both in `~/.config/systemd/user/`, both `Restart=always`. Thereis no system-scope unit for either.@@ -87,7 +87,7 @@ the system scope only if that fails (`manager.ts:121`) — always via `execFile`restart, and MSO offers no control over it at all. The dashboard reports the gateway's state in itsown `/api/status` (`gateway_running`, `gateway_state`, `gateway_platforms`) — look there after one.- **`backup` follows `HERMES_HOME`** (`manager.ts:142`). It is not set in the *cockpit's* process —- the dashboard unit exports it for itself and that env does not reach os-vps — so the source falls+ the dashboard unit exports it for itself and that env does not reach mso — so the source fallsback to `~/.hermes`, the same path; a relocated install would now be copied instead of missed.With the exclusions in [MANAGED-APPS.md §6](./MANAGED-APPS.md) the copy is **366 MB** rather than2.7 GB: the venv and `hermes-agent/node_modules` are pruned, and so is `~/.hermes/backups` — 1.1 GB@@ -201,7 +201,7 @@ refuses to display it — an opaque, blank frame. `proxy-html.ts:63` still rebastreats a bare `/` as the fallback it is by sending the window to its own route instead ofthe dashboard home. Three escapes in a row raises a "stuck" panel rather than looping.-In **origin-split mode** — production — the mount is `/` on `hermes.os.rahmanef.com`, `next`+In **origin-split mode** — production — the mount is `/` on `hermes.mso.rahmanef.com`, `next`is a plain path Hermes accepts, and the whole workaround is inert: `reentryTarget()` returns`null` without touching `frame.contentWindow.location` (`feature-cli.ts:122`), which it must,because that read throws cross-origin and a throw is the "it escaped" branch.@@ -225,7 +225,7 @@ The shell is minimal and **root-absolute**:`/fonts-terminal/JetBrainsMono-*.woff2`), which is why `text/css` is rewritten too insingle-origin mode (`proxy-html.ts:11`).-Root-mounted on `hermes.os.rahmanef.com` those root-absolute URLs already resolve, so the+Root-mounted on `hermes.mso.rahmanef.com` those root-absolute URLs already resolve, so theproxy rewrites the document **not at all** — no `<base href>`, no rebasing, no fetch shim,nothing to hash-pin.@@ -266,14 +266,14 @@ else; `/` and `/health` answer a bare `302 Found` carrying only `date`, `server`to `curl -sI`.) No `content-security-policy`, no `x-frame-options`, no `permissions-policy`anywhere, so Hermes is framable as shipped and `contentSecurityPolicy()` (`proxy-csp.ts:214`)has nothing to intersect — every directive stays as MSO wrote it. What the browser gets on-`hermes.os.rahmanef.com`, computed from the live headers:+`hermes.mso.rahmanef.com`, computed from the live headers:```default-src H; script-src H 'unsafe-inline' blob:; style-src H 'unsafe-inline';img-src H data: blob:; font-src H data: https:; media-src H data: blob:;worker-src blob:; connect-src H data: blob:; frame-src H; form-action H;-base-uri H; frame-ancestors 'self' https://os.rahmanef.com; object-src 'none'- …where H = https://hermes.os.rahmanef.com/+base-uri H; frame-ancestors 'self' https://mso.rahmanef.com; object-src 'none'+ …where H = https://hermes.mso.rahmanef.com/```Three consequences specific to Hermes:@@ -298,9 +298,9 @@ Three consequences specific to Hermes:whole point. Live check, unauthenticated, so `401` is the success signal:```-$ curl -sI https://hermes.os.rahmanef.com/+$ curl -sI https://hermes.mso.rahmanef.com/HTTP/2 401-content-security-policy: default-src 'none'; frame-ancestors 'self' https://os.rahmanef.com+content-security-policy: default-src 'none'; frame-ancestors 'self' https://mso.rahmanef.comx-middleware-rewrite: /api/v1/managed-apps/hermes/proxy```diff --git a/docs/INSTALL.md b/docs/INSTALL.mdindex a5dcee09..3dabc09b 100644--- a/docs/INSTALL.md+++ b/docs/INSTALL.md@@ -1,4 +1,4 @@-# Installing os-vps (Manef Shell OS) on your VPS+# Installing mso (Manef Shell OS) on your VPSStep-by-step setup for a server you own. For the short path, see[Install](../README.md#install). This guide covers credentials, systemd, TLS,@@ -9,7 +9,7 @@ the optional browser service, demo mode, updating, and rollback.- A Linux VPS (any distro with systemd; 1 vCPU / 2 GB RAM works, build wants≥2 GB free — see [Troubleshooting](./TROUBLESHOOTING.md)).- **Node.js 20.9+** (22 recommended) and **pnpm 10.32.1** via corepack.-- A **non-root user** that owns the install. Never run os-vps as root —+- A **non-root user** that owns the install. Never run mso as root —an authenticated session can run shell commands as the process user.- Optional: a domain + reverse proxy (Caddy/nginx/Traefik) **or** Tailscale.@@ -17,20 +17,20 @@ the optional browser service, demo mode, updating, and rollback.```bash# as your normal user (NOT root)-git clone https://github.com/<you>/os-vps.git ~/os-vps-cd ~/os-vps+git clone https://github.com/<you>/mso.git ~/mso+cd ~/msopnpm install```## 2. Credentials — read this section carefully-os-vps is single-owner. A password, signed session cookie, and device allowlist+mso is single-owner. A password, signed session cookie, and device allowlistgate owner access. All of it lives in two places:| What | Where | Committed? ||---|---|---|| Secrets/env | `.env.local` | **NEVER** (gitignored) |-| Device allowlist, BYOK AI key, audit log | `~/.os-vps/*.json`, `~/.os-vps/audit.log` | outside the repo |+| Device allowlist, BYOK AI key, audit log | `~/.mso/*.json`, `~/.mso/audit.log` | outside the repo |```bashcp .env.example .env.local@@ -57,7 +57,7 @@ node scripts/approve-device.js <deviceId> "rahman's phone"After you have one approved device, you can approve new ones from the UI(Settings → Devices) instead of SSH. The allowlist is a plain JSON file at-`~/.os-vps/auth-devices.json` — deleting an entry revokes that device.+`~/.mso/auth-devices.json` — deleting an entry revokes that device.**Filesystem bounds.** Reads and writes are jailed to configured roots(default: `~` + `~/projects`, realpath-checked so symlinks can't escape):@@ -71,7 +71,7 @@ OS_FS_WRITE_ROOTS=~:~/projectsOS_FS_READ_ROOTS=~/projects```-Even inside legal roots, credential material is always blocked: `~/.os-vps`,+Even inside legal roots, credential material is always blocked: `~/.mso`,the app's own `.env*`, and the sensitive-home denylist (`~/.ssh`, `~/.gnupg`,`~/.secrets`, `~/vault`, `~/.bash_history`, `~/.npmrc`) — those paths areunreadable AND hidden from listings. Escape hatch for a supervised session:@@ -84,7 +84,7 @@ their next attempt.**Checklist before going live** (same as the README security checklist):strong `OS_SESSION_SECRET`, VPN/TLS in front, tight read roots, non-root-user, `.env.local` never committed, review `~/.os-vps/audit.log`.+user, `.env.local` never committed, review `~/.mso/audit.log`.## 3. First run@@ -97,7 +97,7 @@ Open it, note the device id on the login screen, approve it (step 2), log in.## 4. Run as a systemd service-`/etc/systemd/system/os-vps.service` (adjust user + paths):+`/etc/systemd/system/mso.service` (adjust user + paths):```ini[Unit]@@ -107,8 +107,8 @@ After=network.target[Service]Type=simpleUser=youruser-WorkingDirectory=/home/youruser/os-vps-EnvironmentFile=/home/youruser/os-vps/.env.local+WorkingDirectory=/home/youruser/mso+EnvironmentFile=/home/youruser/mso/.env.localEnvironment=PORT=4005Environment=HOSTNAME=0.0.0.0ExecStart=/usr/bin/pnpm start --hostname 0.0.0.0 --port 4005@@ -117,7 +117,7 @@ RestartSec=5MemoryMax=3GStandardOutput=journalStandardError=journal-SyslogIdentifier=os-vps+SyslogIdentifier=mso[Install]WantedBy=multi-user.target@@ -125,8 +125,8 @@ WantedBy=multi-user.target```bashsudo systemctl daemon-reload-sudo systemctl enable --now os-vps.service-journalctl -u os-vps -f # watch logs+sudo systemctl enable --now mso.service+journalctl -u mso -f # watch logs````pnpm start` runs the `start` script from `package.json` (`next start`). The@@ -194,7 +194,7 @@ secret travels server-to-server only and must never be reachable publicly.## 7. Optional — AI assistant (BYOK)Set `ANTHROPIC_API_KEY` in `.env.local`, **or** paste a key in the OS under-Settings → AI (stored in `~/.os-vps/config.json`, never in the repo). Unset+Settings → AI (stored in `~/.mso/config.json`, never in the repo). Unset= the assistant endpoint returns 501 and the rest of the OS is unaffected.## 8. Optional — public demo mode@@ -211,13 +211,13 @@ the flag is baked at build time.## 9. Updating```bash-cd ~/os-vps+cd ~/msogit status --short # must be clean before updatinggit fetch origin maingit merge --ff-only FETCH_HEADpnpm install --frozen-lockfilepnpm build # ALWAYS build before restarting-sudo systemctl restart os-vps.service+sudo systemctl restart mso.service./scripts/post-deploy-smoke.sh # catches the chunk/MIME drift the README warns about```@@ -236,7 +236,7 @@ If a deploy breaks production:1. Find the prior good commit: `git log --oneline -10`2. Check out the known-good commit: `git switch --detach <good-sha>`3. Rebuild: `pnpm build`-4. Restart: `sudo systemctl restart os-vps.service`+4. Restart: `sudo systemctl restart mso.service`5. Verify: `curl -s http://localhost:4005/api/health | jq .buildId`If the build itself broke (TypeScript or compile error), leave the running@@ -265,12 +265,12 @@ NotifyAccess=allauto-restarts (catches hangs that `Restart=always`, crash-only, can't). All ano-op when `NOTIFY_SOCKET` is unset (dev / demo / CI).-After editing the unit: `sudo systemctl daemon-reload && sudo systemctl restart os-vps.service`-Verify: `systemctl show os-vps -p WatchdogUSec,NRestarts,ActiveState`+After editing the unit: `sudo systemctl daemon-reload && sudo systemctl restart mso.service`+Verify: `systemctl show mso -p WatchdogUSec,NRestarts,ActiveState`**External monitor** (Uptime Kuma / Healthchecks.io / etc):-- URL: `https://os.rahmanef.com/api/health`+- URL: `https://mso.rahmanef.com/api/health`- Expected: HTTP 200 + JSON body- Interval: 60s- Timeout: 5s@@ -280,25 +280,25 @@ Verify: `systemctl show os-vps -p WatchdogUSec,NRestarts,ActiveState`## 9e. Backup & retention-`~/.os-vps/` is the persistence root:+`~/.mso/` is the persistence root:- `auth-devices.json` — approved-device allowlist (losing it = re-approve every device)- `config.json` — BYOK key + AI model preferences- `audit.log` — append-only JSONL forensic trail- `chrome-profile/` — Playwright user data (browser app, optional)-**Backup recommendation**: nightly `restic` (or `rsync` to off-host) of `~/.os-vps/`. ≤10MB typical.+**Backup recommendation**: nightly `restic` (or `rsync` to off-host) of `~/.mso/`. ≤10MB typical.```bash# example: restic to S3-compatible / Backblaze B2 / local NAS-restic -r b2:my-bucket backup ~/.os-vps --tag os-vps --exclude chrome-profile+restic -r b2:my-bucket backup ~/.mso --tag mso --exclude chrome-profile```**Audit log rotation** (avoid unbounded growth):```-# /etc/logrotate.d/os-vps-/home/rahman/.os-vps/audit.log {+# /etc/logrotate.d/mso+/home/rahman/.mso/audit.log {su rahman rahmansize 1Mrotate 4@@ -324,8 +324,8 @@ availability:1. Run two instances on adjacent ports (4005 + 4006) behind a reverse proxy(Caddy/nginx).-2. Update systemd to a socket-activated `[email protected]` template.-3. Rolling restart: `systemctl restart [email protected]` first; verify+2. Update systemd to a socket-activated `[email protected]` template.+3. Rolling restart: `systemctl restart [email protected]` first; verify`/api/health`; then 4005.For a single-owner personal tool, this is overkill — the 200-500 ms gap is fine.@@ -333,7 +333,7 @@ For a single-owner personal tool, this is overkill — the 200-500 ms gap is fin## 10. Uninstall```bash-sudo systemctl disable --now os-vps.service os-browser.service 2>/dev/null-sudo rm /etc/systemd/system/os-vps.service /etc/systemd/system/os-browser.service-rm -rf ~/os-vps ~/.os-vps # ~/.os-vps holds devices/config/audit log+sudo systemctl disable --now mso.service os-browser.service 2>/dev/null+sudo rm /etc/systemd/system/mso.service /etc/systemd/system/os-browser.service+rm -rf ~/mso ~/.mso # ~/.mso holds devices/config/audit log```diff --git a/docs/IOS-PARITY-REFACTOR-PLAN.md b/docs/IOS-PARITY-REFACTOR-PLAN.mdindex 671bd324..262946cd 100644--- a/docs/IOS-PARITY-REFACTOR-PLAN.md+++ b/docs/IOS-PARITY-REFACTOR-PLAN.md@@ -1,17 +1,17 @@-# iOS Parity Refactor Plan — os-vps feature slices vs the Apple mock+# iOS Parity Refactor Plan — mso feature slices vs the Apple mock> **`mock-os/` NO LONGER EXISTS IN THIS REPO.** The prototype tree it refers to was> deleted on 2026-07-30 as part of a dead-weight sweep: 101 files, 5.7k lines and 6.6 MB> that nothing in the app, the build, the tests or the lint pass ever touched. It is> recoverable two ways — `git show bccd0b1:mock-os/<path>` for any tracked file, and-> `~/archive/os-vps-cleanup-2026-07-30/mock-os.tar.gz` for the whole tree including the+> `~/archive/mso-cleanup-2026-07-30/mock-os.tar.gz` for the whole tree including the> untracked `Apple-clone-app/`. Every `mock-os/...` path below should be read against one> of those, not against a working directory.-> **Goal:** bring every os-vps **feature slice's iOS (iPhone) surface** to parity with the+> **Goal:** bring every mso **feature slice's iOS (iPhone) surface** to parity with the> shared Apple iOS shell in `mock-os/Apple-clone-app/*` — grouped inset lists, liquid-glass> chrome, large-title nav, iMessage-style bubbles, iOS controls — **without** regressing the-> **android / windows / dashboard / macOS** shells and **without** breaking os-vps's essence+> **android / windows / dashboard / macOS** shells and **without** breaking mso's essence> as a headless-VPS cockpit.>> **Scope:** presentation only. No data layer, no host-I/O, no window-store fork, no new deps.@@ -35,7 +35,7 @@ Non-negotiable. Every step in §4 is checked against these.(`use-files*`, zip/upload/inspector untouched). The files-manager work is **presentation-only**;any iOS "search" must filter already-loaded entries client-side, never issue a host query.3. **One window store.** Shells stay chrome-only; never fork `appshell/lib/store.ts`.-4. **os-vps rules stay in force:** shadcn primitives only, theme tokens not raw hex (fixed+4. **mso rules stay in force:** shadcn primitives only, theme tokens not raw hex (fixed*category* colors — folder `#57b3ff`, switch-ON `#30d158`, audio gradient — are the acceptedexception), ≤200 lines/file, barrel-only cross-slice imports (`@/features/<slug>`), no new deps.@@ -201,19 +201,19 @@ mock→ours) · numbered steps with files + LOC · the android/windows/dashboard| LOW | Card corner radius | Grouped inset card = 12px. | `rounded-xl` resolves to --radius-xl = --radius(10px)+4 = 14px. |**Steps:**-1. FOUNDATION — establish the iOS-scope seam. Add inert, brand-free `data-slot` hooks to each primitive so app-level CSS can target them ONLY under [data-shell=ios]: `settings-card` on section.tsx's card div; `settings-section-title` + `settings-footnote` on its header/footnote; `settings-row` + `settings-row-label` on both rows in row.tsx; `settings-value` on the ValueRow value; `settings-hairline` is the shared `after:` pseudo (target via the row/block/action-row data-slots). No className/behavior change — attributes are render-inert. Then open one iOS CSS block under the existing `[data-shell="ios"]` seam. — `/home/rahman/projects/os-vps/frontend/slices/shell-settings/components/section.tsx, row.tsx, block.tsx, action-row.tsx; new iOS rules in /home/rahman/projects/os-vps/app/globals.css (under the existing [data-shell="ios"] region ~L251)` *(~6 attr additions + ~4 lines CSS scaffold)*-2. TYPOGRAPHY — in the iOS-scoped block: `[data-shell="ios"] [data-slot="settings-row-label"]{font-size:16px;font-weight:500}`; `[data-slot="settings-value"]{font-size:15px}`; `[data-slot="settings-section-title"]{font-size:13px;font-weight:600}`; `[data-slot="settings-footnote"]{font-size:12.5px;padding-left:16px;padding-right:16px;line-height:1.42}`. Colors reference existing --label2/muted tokens; sizes are px in scoped CSS (the tokens-not-hex rule governs colors, not sizes). Fixes row-label, value, section-title, footnote in one pass. — `/home/rahman/projects/os-vps/app/globals.css` *(~8 lines CSS, 0 tsx)*-3. SEGMENTED iOS variant — the biggest visible mismatch. Add a `data-slot="segmented"` (root) + `data-slot="segmented-option"` + `data-selected` attr to components/ui/segmented.tsx (inert for all shells). Then iOS-scope: track → `background:var(--fill);border:0;border-radius:9px`; option → `font-size:14px;font-weight:500`; selected option → `background:var(--card);color:var(--label);box-shadow:0 1px 3px rgba(0,0,0,.12)` and OVERRIDE the accent-fill (`background:var(--card)!important` on the selected pill). This turns the tinted pill into the iOS raised-white pill ONLY on iOS. — `/home/rahman/projects/os-vps/components/ui/segmented.tsx (add data-slot/data-selected, ~3 lines) + /home/rahman/projects/os-vps/app/globals.css (~6 lines)` *(~9 lines total)*-4. SWITCH iOS variant — Switch already has role=switch. iOS-scope on `[data-shell="ios"] [role="switch"]` used inside settings: dimensions `width:47px;height:29px`; knob (the inner span) `width:25px;height:25px` with ON translate to `translateX(20px)`; ON track color → system green `#30d158` (a FIXED semantic category color, the accepted hex exception), OFF → var(--fill2). Scope keeps Android(Material)/Windows(Fluent) accent-colored switches untouched — global retune would regress them, so iOS-scope is the correctness boundary here, not just cosmetics. — `/home/rahman/projects/os-vps/components/ui/switch.tsx (add a stable data-slot on the knob span so the scoped rule can size it, ~1 line) + /home/rahman/projects/os-vps/app/globals.css (~7 lines)` *(~8 lines total)*-5. CARD borderless + grouped pane (most invasive; can be deferred/accepted). iOS-scope: `[data-shell="ios"] [data-slot="settings-card"]{border-color:transparent;border-radius:12px;box-shadow:0 1px 2px rgba(0,0,0,.05)}` AND give the pane a --grouped step so the borderless card still reads: add `--grouped` under [data-shell="ios"] (light #f2f2f7, dark #000) and paint the SectionDetail scroll container with it (add a `data-slot="settings-pane"` hook in the CONSUMER's sections.tsx). CAVEAT: verify dark-mode card (--card/--window-bg ≈ #1c1c1e) keeps contrast against a #000 grouped bg before shipping — if it collapses, keep dark grouped at #1c1c1e/elev instead of pure black. — `/home/rahman/projects/os-vps/frontend/slices/shell-settings/components/section.tsx (data-slot already added in step 1) + /home/rahman/projects/os-vps/frontend/slices/os-settings/components/sections.tsx (1 data-slot on the pane div) + /home/rahman/projects/os-vps/app/globals.css (~6 lines + --grouped token)` *(~9 lines total; verify dark contrast)*-6. HAIRLINE — iOS-scope the shared row/block/action-row divider to the iOS spec: `[data-shell="ios"] [data-slot="settings-row"]::after, ...::after{background:var(--sep);height:1px;transform:scaleY(.5);transform-origin:bottom}` (0.5px hairline at the --sep alpha, replacing the fainter border/60). Inset 16px + last-hidden already match, so only thickness+color change. — `/home/rahman/projects/os-vps/app/globals.css` *(~3 lines CSS)*-7. ACCENT SWATCHES — iOS-scope size/gap and swap the selected indicator to the iOS look WITHOUT touching the shared markup: `[data-shell="ios"] [data-slot="accent-swatch"]{width:26px;height:26px}` and container `gap:13px`; on selected, prefer scale+ring over the check (either hide the Check via `[data-shell="ios"] [data-slot="accent-swatch"] svg{display:none}` + `[aria-pressed="true"]{transform:scale(1.12);box-shadow:0 0 0 2px var(--card),0 0 0 4px currentColor}`). Add `data-slot="accent-swatch"` to accent-swatches.tsx (inert). LOWEST priority — the check is a defensible a11y win, so this step is optional. — `/home/rahman/projects/os-vps/frontend/slices/shell-settings/components/accent-swatches.tsx (1 data-slot) + /home/rahman/projects/os-vps/app/globals.css (~4 lines)` *(~5 lines total; optional)*-8. SECTION-HEADER icon — DECISION step, no code unless chosen. iOS group headers are text-only. Either (a) ACCEPT the leading icon as a cockpit affordance (recommended — it aids scannability across many sections and costs nothing), or (b) iOS-hide it: `[data-shell="ios"] [data-slot="settings-section-title"] > span:first-child{display:none}`. Do NOT branch the primitive on shell in TSX — that would shell-couple a portable slice (violates the rr-lift portability guard). — `/home/rahman/projects/os-vps/app/globals.css (only if option b)` *(~2 lines if chosen, else 0)*+1. FOUNDATION — establish the iOS-scope seam. Add inert, brand-free `data-slot` hooks to each primitive so app-level CSS can target them ONLY under [data-shell=ios]: `settings-card` on section.tsx's card div; `settings-section-title` + `settings-footnote` on its header/footnote; `settings-row` + `settings-row-label` on both rows in row.tsx; `settings-value` on the ValueRow value; `settings-hairline` is the shared `after:` pseudo (target via the row/block/action-row data-slots). No className/behavior change — attributes are render-inert. Then open one iOS CSS block under the existing `[data-shell="ios"]` seam. — `/home/rahman/projects/mso/frontend/slices/shell-settings/components/section.tsx, row.tsx, block.tsx, action-row.tsx; new iOS rules in /home/rahman/projects/mso/app/globals.css (under the existing [data-shell="ios"] region ~L251)` *(~6 attr additions + ~4 lines CSS scaffold)*+2. TYPOGRAPHY — in the iOS-scoped block: `[data-shell="ios"] [data-slot="settings-row-label"]{font-size:16px;font-weight:500}`; `[data-slot="settings-value"]{font-size:15px}`; `[data-slot="settings-section-title"]{font-size:13px;font-weight:600}`; `[data-slot="settings-footnote"]{font-size:12.5px;padding-left:16px;padding-right:16px;line-height:1.42}`. Colors reference existing --label2/muted tokens; sizes are px in scoped CSS (the tokens-not-hex rule governs colors, not sizes). Fixes row-label, value, section-title, footnote in one pass. — `/home/rahman/projects/mso/app/globals.css` *(~8 lines CSS, 0 tsx)*+3. SEGMENTED iOS variant — the biggest visible mismatch. Add a `data-slot="segmented"` (root) + `data-slot="segmented-option"` + `data-selected` attr to components/ui/segmented.tsx (inert for all shells). Then iOS-scope: track → `background:var(--fill);border:0;border-radius:9px`; option → `font-size:14px;font-weight:500`; selected option → `background:var(--card);color:var(--label);box-shadow:0 1px 3px rgba(0,0,0,.12)` and OVERRIDE the accent-fill (`background:var(--card)!important` on the selected pill). This turns the tinted pill into the iOS raised-white pill ONLY on iOS. — `/home/rahman/projects/mso/components/ui/segmented.tsx (add data-slot/data-selected, ~3 lines) + /home/rahman/projects/mso/app/globals.css (~6 lines)` *(~9 lines total)*+4. SWITCH iOS variant — Switch already has role=switch. iOS-scope on `[data-shell="ios"] [role="switch"]` used inside settings: dimensions `width:47px;height:29px`; knob (the inner span) `width:25px;height:25px` with ON translate to `translateX(20px)`; ON track color → system green `#30d158` (a FIXED semantic category color, the accepted hex exception), OFF → var(--fill2). Scope keeps Android(Material)/Windows(Fluent) accent-colored switches untouched — global retune would regress them, so iOS-scope is the correctness boundary here, not just cosmetics. — `/home/rahman/projects/mso/components/ui/switch.tsx (add a stable data-slot on the knob span so the scoped rule can size it, ~1 line) + /home/rahman/projects/mso/app/globals.css (~7 lines)` *(~8 lines total)*+5. CARD borderless + grouped pane (most invasive; can be deferred/accepted). iOS-scope: `[data-shell="ios"] [data-slot="settings-card"]{border-color:transparent;border-radius:12px;box-shadow:0 1px 2px rgba(0,0,0,.05)}` AND give the pane a --grouped step so the borderless card still reads: add `--grouped` under [data-shell="ios"] (light #f2f2f7, dark #000) and paint the SectionDetail scroll container with it (add a `data-slot="settings-pane"` hook in the CONSUMER's sections.tsx). CAVEAT: verify dark-mode card (--card/--window-bg ≈ #1c1c1e) keeps contrast against a #000 grouped bg before shipping — if it collapses, keep dark grouped at #1c1c1e/elev instead of pure black. — `/home/rahman/projects/mso/frontend/slices/shell-settings/components/section.tsx (data-slot already added in step 1) + /home/rahman/projects/mso/frontend/slices/os-settings/components/sections.tsx (1 data-slot on the pane div) + /home/rahman/projects/mso/app/globals.css (~6 lines + --grouped token)` *(~9 lines total; verify dark contrast)*+6. HAIRLINE — iOS-scope the shared row/block/action-row divider to the iOS spec: `[data-shell="ios"] [data-slot="settings-row"]::after, ...::after{background:var(--sep);height:1px;transform:scaleY(.5);transform-origin:bottom}` (0.5px hairline at the --sep alpha, replacing the fainter border/60). Inset 16px + last-hidden already match, so only thickness+color change. — `/home/rahman/projects/mso/app/globals.css` *(~3 lines CSS)*+7. ACCENT SWATCHES — iOS-scope size/gap and swap the selected indicator to the iOS look WITHOUT touching the shared markup: `[data-shell="ios"] [data-slot="accent-swatch"]{width:26px;height:26px}` and container `gap:13px`; on selected, prefer scale+ring over the check (either hide the Check via `[data-shell="ios"] [data-slot="accent-swatch"] svg{display:none}` + `[aria-pressed="true"]{transform:scale(1.12);box-shadow:0 0 0 2px var(--card),0 0 0 4px currentColor}`). Add `data-slot="accent-swatch"` to accent-swatches.tsx (inert). LOWEST priority — the check is a defensible a11y win, so this step is optional. — `/home/rahman/projects/mso/frontend/slices/shell-settings/components/accent-swatches.tsx (1 data-slot) + /home/rahman/projects/mso/app/globals.css (~4 lines)` *(~5 lines total; optional)*+8. SECTION-HEADER icon — DECISION step, no code unless chosen. iOS group headers are text-only. Either (a) ACCEPT the leading icon as a cockpit affordance (recommended — it aids scannability across many sections and costs nothing), or (b) iOS-hide it: `[data-shell="ios"] [data-slot="settings-section-title"] > span:first-child{display:none}`. Do NOT branch the primitive on shell in TSX — that would shell-couple a portable slice (violates the rr-lift portability guard). — `/home/rahman/projects/mso/app/globals.css (only if option b)` *(~2 lines if chosen, else 0)*9. ACCEPT / SKIP (document, do not build): (1) ActionRow default color stays --info (#0060df) not the user --tint, and destructive stays --destructive-text (#d70015) not raw #ff453a — both are the documented AA-contrast decisions in action-row.tsx and are MORE correct than the sub-AA iOS tint-as-text; keep. (2) SettingsBlock has no iOS mock analog — it's a legitimate freeform-content affordance; keep. (3) Responsive flex-col stacking of control-under-label on narrow diverges from iOS-always-inline but prevents segmented overflow in a resizable cockpit window; keep. (4) ActionRow label 14px→16px is a trivial add-on to step 2 if desired (`[data-slot="settings-action"]{font-size:16px}`). — `n/a (no-op / rationale record)` *(0)***Guard (android/windows/dashboard):** The primitives are shared VERBATIM by all five shells — os-settings/app.tsx uses useActiveShell() only to swap NAV CHROME (mobile=stack / macos=sidebar / windows+dashboard=tabs), while sections.tsx renders ONE SectionBody (these primitives) for every shell. So the seam is NOT a TSX branch — it is the already-live `[data-shell=\"ios\"]` CSS scope (globals.css L251; desktop.tsx L69 stamps data-shell on #main-content, an ancestor of the settings app on the iOS surface — verified it wraps MobileShell). ALL iOS pixel/color deltas live in `[data-shell=\"ios\"] …` rules in globals.css. android/windows/dashboard/macos stay byte-unchanged because: (1) they never match the `[data-shell=\"ios\"]` selector, so zero computed-style delta; (2) the only .tsx edits are additive `data-slot`/`data-selected` attributes that are render-inert — no non-iOS shell reads, styles, or branches on them, so their layout/behavior/logic is identical (the DOM string gains a neutral attribute, nothing they depend on changes). Crucially, Switch/Segmented iOS-scoping is REQUIRED (not optional): Android(Material) and Windows(Fluent) want accent-colored switches/segments, so a global retune to iOS green/white-pill would REGRESS them — the iOS scope is the correctness boundary. And per the rr-lift portability guard (MEMORY), the primitives stay brand/shell-free: no useActiveShell import lands in the slice; divergence lives in app CSS, so the slice remains lift-ready.-**Essence / skips:** VPS-essence: CLEAN — these are pure appearance primitives. No hardware is fabricated (no wifi/battery/cellular/clock/signal anywhere in scope; AppearancePanel exposes only real settings: style/theme/accent/wallpaper/reduceTransparency/shell/device). The file-explorer DATA layer and lib/host.ts are untouched — Settings never routes host-I/O. reduceTransparency is already wired (matches SSOT §1.7 a11y content-behavior). OS-VPS rules respected: no new deps (all deltas are CSS + inert attrs), shadcn primitives kept, files stay <200 lines, cross-slice imports stay barrel-only (@/features/*), and the one raw hex introduced (#30d158 switch-ON, and #f2f2f7/#000 grouped) falls under the accepted 'fixed category color' exception — every other color references existing tokens (--fill, --sep, --card, --label2). DELIBERATE SKIPS (mock patterns that don't fit a settings cockpit or belong to chrome, not these primitives): iOS colored 29x29 leading icon TILES on rows (the mock's DETAIL rows lack them too — only the sidebar category list has them, which is nav.tsx, out of scope); large-title collapse §3.9 (chrome — SectionDetail already paints the 26px iPhone title); sheet/detents §3.3 and slider row §1.1-isSlider (not rendered by any of these six files). Also skipped by choice: forcing the user --tint as ActionRow text (kept --info for AA) and dropping the accent Check glyph (kept as an a11y-over-parity win) — both documented in-file, both defensible departures from a sub-AA iOS behavior.+**Essence / skips:** VPS-essence: CLEAN — these are pure appearance primitives. No hardware is fabricated (no wifi/battery/cellular/clock/signal anywhere in scope; AppearancePanel exposes only real settings: style/theme/accent/wallpaper/reduceTransparency/shell/device). The file-explorer DATA layer and lib/host.ts are untouched — Settings never routes host-I/O. reduceTransparency is already wired (matches SSOT §1.7 a11y content-behavior). MSO rules respected: no new deps (all deltas are CSS + inert attrs), shadcn primitives kept, files stay <200 lines, cross-slice imports stay barrel-only (@/features/*), and the one raw hex introduced (#30d158 switch-ON, and #f2f2f7/#000 grouped) falls under the accepted 'fixed category color' exception — every other color references existing tokens (--fill, --sep, --card, --label2). DELIBERATE SKIPS (mock patterns that don't fit a settings cockpit or belong to chrome, not these primitives): iOS colored 29x29 leading icon TILES on rows (the mock's DETAIL rows lack them too — only the sidebar category list has them, which is nav.tsx, out of scope); large-title collapse §3.9 (chrome — SectionDetail already paints the 26px iPhone title); sheet/detents §3.3 and slider row §1.1-isSlider (not rendered by any of these six files). Also skipped by choice: forcing the user --tint as ActionRow text (kept --info for AA) and dropping the accent Check glyph (kept as an a11y-over-parity win) — both documented in-file, both defensible departures from a sub-AA iOS behavior.#### 2. `os-settings-sections` — parity: **close** · ref: Settings.dc.html**Surface:** iOS Settings on the mobile shell, two surfaces: (1) the grouped section INDEX = SectionList (master) — colored 29x29 icon-tile rows in rounded cards, chevron, hairlines; (2) the section DETAIL = SectionDetail phone branch — a large title over the shared grouped-card body (SettingsSection/Row/ValueRow/ActionRow). Note: the iOS nav bar, back button, glass, and large-title collapse-on-scroll are owned by MasterDetail + os-shell chrome, NOT this slice — this slice only paints the at-rest title + list/cards.@@ -257,14 +257,14 @@ mock→ours) · numbered steps with files + LOC · the android/windows/dashboard| LOW | home-indicator pill (already matches / exceeds mock) | Static homeIndStyle pill only (no JS gestures in the .dc file). | 134x5 rounded-full, light rgba(255,255,255,.75) / dark rgba(0,0,0,.3), in a ~34px reserved zone (--sai-bottom +34px in-app). Adds a full pointer gesture model (tap=switcher, quick swipe-up=home, hold=switcher, left/right=cycle apps) with pointer-capture — EXCEEDS the static mock. No work. |**Steps:**-1. PRIMARY. Extract the in-app nav header (mobile-shell.tsx L205-220) into a new iOS-only sibling component (mobile-app-nav.tsx) and rebuild it iOS-style: CENTER the title (single-line truncate, 16px, font-weight 600 via font-semibold on a <span> — drop <strong> so it isn't 700), position the trailing 'Done' absolutely (keep h-11/44pt, ghost, text-primary), and DECIDE the leading app icon — either drop it (iOS-pure: leading empty/optional tint text) OR keep it as a small ABSOLUTE leading glyph that no longer shifts the centered title. Extraction also pulls mobile-shell.tsx back under the <=200-line gate (currently 245). — `new features/appshell/components/mobile-app-nav.tsx (imported ONLY by mobile-shell.tsx) + edit mobile-shell.tsx nav block; mirror to os-vps/frontend/slices/appshell/components/` *(~55-70 new / ~-14 in mobile-shell)*+1. PRIMARY. Extract the in-app nav header (mobile-shell.tsx L205-220) into a new iOS-only sibling component (mobile-app-nav.tsx) and rebuild it iOS-style: CENTER the title (single-line truncate, 16px, font-weight 600 via font-semibold on a <span> — drop <strong> so it isn't 700), position the trailing 'Done' absolutely (keep h-11/44pt, ghost, text-primary), and DECIDE the leading app icon — either drop it (iOS-pure: leading empty/optional tint text) OR keep it as a small ABSOLUTE leading glyph that no longer shifts the centered title. Extraction also pulls mobile-shell.tsx back under the <=200-line gate (currently 245). — `new features/appshell/components/mobile-app-nav.tsx (imported ONLY by mobile-shell.tsx) + edit mobile-shell.tsx nav block; mirror to mso/frontend/slices/appshell/components/` *(~55-70 new / ~-14 in mobile-shell)*2. Align the nav frost to the SSOT glass recipe: swap Tailwind `backdrop-blur-xl` for the shell `.glass` helper (blur(var(--blur)) saturate(180%), which .reduce-glass already zeroes), keeping the transparent-at-rest -> frost-on-scroll toggle (apply `.glass` + bg-[var(--glass-bar)] + border-b hairline ONLY when appScrolled). Fixes the missing saturate + the ignored --blur token, and makes Reduce-Transparency collapse the bar correctly. — `mobile-app-nav.tsx (or mobile-shell.tsx L208 if not extracted)` *(~3-5)*3. Cosmetic: set the nav content band to 46px (2.875rem) to match SSOT/config.js chrome.phoneNav, instead of 3rem/48px. — `mobile-app-nav.tsx / mobile-shell.tsx L210` *(~1)*4. OPTIONAL low: add the iOS app-name+icon chip ABOVE each switcher card (real iOS labels the card above the snapshot). WindowPreview already carries icon+title; a thin chip header completes the look without touching the data layer. — `mobile-switcher.tsx SwitcherCard (+ optionally window-preview.tsx tile)` *(~8-12)***Guard (android/windows/dashboard):** MobileShell is the `render:` for EXACTLY ONE ShellDescriptor — id:\"ios\" (desktop.tsx:211 `registerShell({id:\"ios\", render: MobileShell})`). The other four personas render entirely separate components: Android=AndroidShell (shells/android/android-shell.tsx + its own android-parts.tsx NavBar/Recents), Windows=WindowsShell, Dashboard=DashboardShell, macOS=DesktopChrome. Verified by grep: NONE of them import mobile-shell.tsx / mobile-switcher.tsx / home-indicator.tsx, and HomeIndicator + MobileSwitcher are imported ONLY by MobileShell. So the registry `render:` field IS the seam — these three files are already surface-partitioned iOS-only modules; no useActiveShell() branch is even needed inside them, and android/windows/dashboard stay byte-identical because they never reference these modules. GUARD RULES for the steps: (1) the new mobile-app-nav.tsx must be imported ONLY by mobile-shell.tsx; (2) edits stay in component JSX/markup — do NOT touch hooks/use-swipe-close.ts (useSwipeUpClose is SHARED with Android recents), use-shell.ts, or lib/store, so Android's swipe-to-close and the shared window store stay identical.-**Essence / skips:** VPS-essence HARD SKIPS (do NOT build, even though the mock does): the in-app status bar (clock 15/600, wifi glyph, battery glyph) and the Dynamic Island black pill = fabricated hardware (clock/wifi/battery/notch). This is already an established decision (mobile-home.tsx L86); we reserve the notch zone via --sai-top but paint nothing. File-explorer DATA layer is untouched — every step is pure presentation on the shell frame + switcher; none go near lib/host.ts or the Files data path (the switcher's WindowPreview tile is intentionally STATIC metadata, not a live mount). DELIBERATELY SKIPPED mock patterns: (a) the Files floating tab bar — app-internal navigation belongs to WindowContent; the generic shell frame has no per-app tab contract; (b) per-app nav trailing actions (share/compose/trash) — would need a cross-app nav-action contract, and os-vps apps already surface actions in their own in-content toolbars, so it is out of scope for the shell frame. OS-VPS rules honoured by the steps: shadcn <Button> reused (no raw controls); theme tokens only (--glass-bar, --blur, text-foreground/primary) — the home-indicator pill's rgba white/black is a pre-existing fixed-element value (accepted like the fixed-category-color exception), not introduced here; the <=200-line gate is CURRENTLY BREACHED (mobile-shell.tsx = 245 LOC) and Step 1's extraction fixes it rather than worsening it; no new deps; intra-slice relative imports only (no cross-slice barrel needed). Overall parity is 'close' — the frame skeleton (frost-on-scroll nav, gesture-complete 134x5 home pill, glass card switcher that EXCEEDS the static mock) is iOS-accurate; the only genuine action items are the nav-title centering/weight (+icon decision) and the minor glass-recipe/height polish.+**Essence / skips:** VPS-essence HARD SKIPS (do NOT build, even though the mock does): the in-app status bar (clock 15/600, wifi glyph, battery glyph) and the Dynamic Island black pill = fabricated hardware (clock/wifi/battery/notch). This is already an established decision (mobile-home.tsx L86); we reserve the notch zone via --sai-top but paint nothing. File-explorer DATA layer is untouched — every step is pure presentation on the shell frame + switcher; none go near lib/host.ts or the Files data path (the switcher's WindowPreview tile is intentionally STATIC metadata, not a live mount). DELIBERATELY SKIPPED mock patterns: (a) the Files floating tab bar — app-internal navigation belongs to WindowContent; the generic shell frame has no per-app tab contract; (b) per-app nav trailing actions (share/compose/trash) — would need a cross-app nav-action contract, and mso apps already surface actions in their own in-content toolbars, so it is out of scope for the shell frame. MSO rules honoured by the steps: shadcn <Button> reused (no raw controls); theme tokens only (--glass-bar, --blur, text-foreground/primary) — the home-indicator pill's rgba white/black is a pre-existing fixed-element value (accepted like the fixed-category-color exception), not introduced here; the <=200-line gate is CURRENTLY BREACHED (mobile-shell.tsx = 245 LOC) and Step 1's extraction fixes it rather than worsening it; no new deps; intra-slice relative imports only (no cross-slice barrel needed). Overall parity is 'close' — the frame skeleton (frost-on-scroll nav, gesture-complete 134x5 home pill, glass card switcher that EXCEEDS the static mock) is iOS-accurate; the only genuine action items are the nav-title centering/weight (+icon decision) and the minor glass-recipe/height polish.#### 4. `appshell-springboard` — parity: **close** · ref: Springboard.dc.html**Surface:** iPhone Springboard — paged home (Today / app grid / App Library), page dots, dock, long-press quick-actions sheet, and the Spotlight entry gesture. Files: frontend/slices/appshell/components/mobile-home.tsx, mobile-home-parts.tsx, mobile-app-library.tsx, mobile-app-library-parts.tsx (home-indicator.tsx + dynamic-island.tsx adjacent).@@ -295,7 +295,7 @@ mock→ours) · numbered steps with files + LOC · the android/windows/dashboard| Sev | Aspect | Mock / SSOT | Ours today ||---|---|---|---|| HIGH | Reduce Transparency (a11y) — glass blur | SSOT §1.7: Reduce Transparency → --blur:0 + solid fills; the repo mechanism is `.reduce-glass{--blur:0}` and the `.glass` utility reads var(--blur). | CC uses Tailwind `backdrop-blur-xl` (fixed 24px), NC uses inline `blur(28px)`, DynamicIsland uses `backdrop-blur` (fixed 8px) — all bypass var(--blur), so glass never collapses when the user enables Reduce Transparency. (Spotlight + ToastHost correctly use `.glass` and DO honor it.) |-| MED | Notification Center surface color | SSOT: glass derives from theme tokens (--glass-*), flips light/dark, obeys Reduce Transparency. | mobile-notifications.tsx L43 hardcodes `background: rgba(20,22,38,.62)` (dark navy) in BOTH themes + inline blur — violates OS-VPS rule 'theme tokens not raw hex' and isn't theme-aware. |+| MED | Notification Center surface color | SSOT: glass derives from theme tokens (--glass-*), flips light/dark, obeys Reduce Transparency. | mobile-notifications.tsx L43 hardcodes `background: rgba(20,22,38,.62)` (dark navy) in BOTH themes + inline blur — violates MSO rule 'theme tokens not raw hex' and isn't theme-aware. || MED | Spotlight layout on the iOS surface | iOS Search (swipe-down): top-anchored, full-width search field over a wallpaper blur, results list below. | spotlight.tsx renders one desktop command-palette look everywhere — a centered `max-w-xl` glass box at `pt-[18vh]` with a `bg-black/20` scrim; identical on the iOS surface. || MED | Liquid-glass edge (inner highlight + hairline) | Mock chrome pills carry `box-shadow: inset 0 .5px 0 var(--glass-hi), 0 8px 26px var(--glass-shadow)` + `--glass-stroke` outer hairline (SSOT §1.5/§4). | `.glass` utility is blur+saturate only; --glass-hi/--glass-stroke tokens don't exist; CC/NC/Spotlight edges are a flat `border-border` with no inner top highlight. || LOW | Sheet grabber handle | SSOT §3.3: pull-down sheets show a grabber `36x5 r2.5 --label3` top-center. | CC has no grabber; NC uses a 134px white bar at the BOTTOM (home-indicator style, L100), not the top grabber. |@@ -304,12 +304,12 @@ mock→ours) · numbered steps with files + LOC · the android/windows/dashboard| LOW | Toast banner placement | Real iOS banners drop from top-CENTER. | ToastHost is `absolute right-3.5 top-9` (top-right glass cards) on every surface incl. iOS — shared cross-surface component, low priority. |**Steps:**-1. Fix the Reduce-Transparency bypass on the three hardcoded-blur surfaces: swap Tailwind/inline blur for the `.glass` utility (reads var(--blur)). CC: replace `backdrop-blur-xl` with `glass` (keep bg-[var(--glass-menu)]). DI: replace `backdrop-blur` with `glass`. NC: drop inline `blur(28px)` and add `glass` (bg handled in Step 2). Neutral-positive for Android CC, so no branch needed. — `/home/rahman/projects/os-vps/frontend/slices/appshell/features/control-center/components/control-center.tsx; .../features/notifications/components/dynamic-island.tsx; .../components/mobile-notifications.tsx` *(~1 line each (~3 LOC))*-2. Tokenize the NC surface: add a theme-aware NC glass (reuse --glass-panel, or add --glass-nc light+dark in :root/[data-theme=dark]) and replace the hardcoded `rgba(20,22,38,.62)`. Keep white-alpha cards/text (consistent with the iOS dock over-wallpaper style) OR move text to a token — your call; the panel bg is the load-bearing fix so light-mode + Reduce Transparency behave. — `/home/rahman/projects/os-vps/app/globals.css (2 token lines); /home/rahman/projects/os-vps/frontend/slices/appshell/components/mobile-notifications.tsx (bg swap)` *(~4 LOC)*-3. Add the iOS liquid-glass edge: define --glass-hi + --glass-stroke tokens (light+dark) and an iOS-scoped rule `[data-shell="ios"] .glass { box-shadow: inset 0 .5px 0 var(--glass-hi); border-color: var(--glass-stroke) }` OR an opt-in `.glass-ios` class. Do NOT touch base `.glass`. Because CC's shadcn Sheet portals to <body> (outside [data-shell]), apply the class to CC directly under the id==='ios' gate from Step 5. — `/home/rahman/projects/os-vps/app/globals.css (~6 lines: 4 tokens + rule); control-center.tsx (apply class, iOS-gated)` *(~8 LOC)*-4. Branch Spotlight for the mobile surface: read useActiveShell() (already exported from @/features/appshell) and when surface==='mobile' render a top-anchored, full-width variant (container inset-x-0 top-0; input as a --fill pill with a leading Search glyph — fixes the §3.2 field too); the desktop `else` branch keeps today's centered-palette JSX byte-for-byte. Extract the two shells into a small helper/second file to stay under the 200-line rule (spotlight.tsx is already 183 lines). — `/home/rahman/projects/os-vps/frontend/slices/appshell/features/search/components/spotlight.tsx (+ optional new spotlight-shell.tsx)` *(~30-40 LOC (split to stay <200/file))*-5. Add the CC grabber + iOS glass edge, iOS-gated: inside ControlCenter wrap a grabber (`36x5 r2.5` top-center, --label3-equivalent) and the Step-3 `.glass-ios` class in `useActiveShell().id === 'ios'` so Android's controlCenter tile grid stays byte-unchanged. — `/home/rahman/projects/os-vps/frontend/slices/appshell/features/control-center/components/control-center.tsx` *(~8-12 LOC (iOS-gated block))*-6. (Low / optional) DynamicIsland fill under Reduce Transparency: once Step 1 gives it `.glass`, optionally deepen bg toward solid #000 when --blur collapses. Leave the idle-pill absent (deliberate VPS skip — see essence). Toast top-center on iOS is out of scope (shared component); skip unless you accept touching desktop toasts. — `/home/rahman/projects/os-vps/frontend/slices/appshell/features/notifications/components/dynamic-island.tsx` *(~2 LOC or skip)*+1. Fix the Reduce-Transparency bypass on the three hardcoded-blur surfaces: swap Tailwind/inline blur for the `.glass` utility (reads var(--blur)). CC: replace `backdrop-blur-xl` with `glass` (keep bg-[var(--glass-menu)]). DI: replace `backdrop-blur` with `glass`. NC: drop inline `blur(28px)` and add `glass` (bg handled in Step 2). Neutral-positive for Android CC, so no branch needed. — `/home/rahman/projects/mso/frontend/slices/appshell/features/control-center/components/control-center.tsx; .../features/notifications/components/dynamic-island.tsx; .../components/mobile-notifications.tsx` *(~1 line each (~3 LOC))*+2. Tokenize the NC surface: add a theme-aware NC glass (reuse --glass-panel, or add --glass-nc light+dark in :root/[data-theme=dark]) and replace the hardcoded `rgba(20,22,38,.62)`. Keep white-alpha cards/text (consistent with the iOS dock over-wallpaper style) OR move text to a token — your call; the panel bg is the load-bearing fix so light-mode + Reduce Transparency behave. — `/home/rahman/projects/mso/app/globals.css (2 token lines); /home/rahman/projects/mso/frontend/slices/appshell/components/mobile-notifications.tsx (bg swap)` *(~4 LOC)*+3. Add the iOS liquid-glass edge: define --glass-hi + --glass-stroke tokens (light+dark) and an iOS-scoped rule `[data-shell="ios"] .glass { box-shadow: inset 0 .5px 0 var(--glass-hi); border-color: var(--glass-stroke) }` OR an opt-in `.glass-ios` class. Do NOT touch base `.glass`. Because CC's shadcn Sheet portals to <body> (outside [data-shell]), apply the class to CC directly under the id==='ios' gate from Step 5. — `/home/rahman/projects/mso/app/globals.css (~6 lines: 4 tokens + rule); control-center.tsx (apply class, iOS-gated)` *(~8 LOC)*+4. Branch Spotlight for the mobile surface: read useActiveShell() (already exported from @/features/appshell) and when surface==='mobile' render a top-anchored, full-width variant (container inset-x-0 top-0; input as a --fill pill with a leading Search glyph — fixes the §3.2 field too); the desktop `else` branch keeps today's centered-palette JSX byte-for-byte. Extract the two shells into a small helper/second file to stay under the 200-line rule (spotlight.tsx is already 183 lines). — `/home/rahman/projects/mso/frontend/slices/appshell/features/search/components/spotlight.tsx (+ optional new spotlight-shell.tsx)` *(~30-40 LOC (split to stay <200/file))*+5. Add the CC grabber + iOS glass edge, iOS-gated: inside ControlCenter wrap a grabber (`36x5 r2.5` top-center, --label3-equivalent) and the Step-3 `.glass-ios` class in `useActiveShell().id === 'ios'` so Android's controlCenter tile grid stays byte-unchanged. — `/home/rahman/projects/mso/frontend/slices/appshell/features/control-center/components/control-center.tsx` *(~8-12 LOC (iOS-gated block))*+6. (Low / optional) DynamicIsland fill under Reduce Transparency: once Step 1 gives it `.glass`, optionally deepen bg toward solid #000 when --blur collapses. Leave the idle-pill absent (deliberate VPS skip — see essence). Toast top-center on iOS is out of scope (shared component); skip unless you accept touching desktop toasts. — `/home/rahman/projects/mso/frontend/slices/appshell/features/notifications/components/dynamic-island.tsx` *(~2 LOC or skip)***Guard (android/windows/dashboard):** The seam is the feature-slot mount map + useActiveShell()/[data-shell]. Per component: (A) DynamicIsland + MobileNotifications are iOS-EXCLUSIVE BY MOUNT — topPill slot and the NC import exist only in mobile-shell.tsx (verified). android-shell mounts controlCenter but never topPill and never imports MobileNotifications; windows/dashboard are desktop shells that mount neither. So editing dynamic-island.tsx / mobile-notifications.tsx is byte-invisible to android/windows/dashboard with no code branch. (B) ControlCenter is SHARED iOS+Android (both mount the controlCenter slot). The Reduce-Transparency fix (Step 1) is strictly more-correct for both, so no branch. Any iOS-ONLY visual (grabber, iOS glass edge — Steps 5/3) MUST be wrapped in `useActiveShell().id === 'ios'` so Android's tile grid stays byte-for-byte; windows/dashboard never mount it. (C) Spotlight is SHARED across ALL five shells (overlay slot in the common Surface). The iOS layout branch (Step 4) MUST be gated on `useActiveShell()` (surface==='mobile' or id==='ios'); the desktop `else` branch keeps today's exact centered-palette JSX so macOS/Windows/Dashboard render byte-unchanged. (D) The iOS liquid-glass edge (Step 3) is applied via `[data-shell="ios"]` (Surface sets data-shell on its root) or an opt-in `.glass-ios` class — the base `.glass` utility is NOT modified, so every other shell's glass is untouched. Caveat: ControlCenter's shadcn Sheet PORTALS to document.body (outside [data-shell]), so CC must get the class directly under the id==='ios' gate, not via the descendant selector.@@ -330,12 +330,12 @@ mock→ours) · numbered steps with files + LOC · the android/windows/dashboard| LOW | Edit-button variant (§3.6) | iOS edit affordance = tinted plain text button (--tint) or a gray fill pill. | White frosted pill (bg-white/15) + Plus icon + text-white. DEFENSIBLE over-wallpaper adaptation (§4.4 — the pill gives the label a solid surface; a tint-text label could fail contrast over an arbitrary wallpaper), so arguably acceptable as-is. |**Steps:**-1. Fix the wrong-on-phone picker copy. Add `const { surface } = useActiveShell()` (import intra-slice from ../../../registry/shells, matching the slice's own convention — NOT the public barrel, to avoid a self-referential cycle). When surface==='mobile': DialogTitle -> 'Widgets', DialogDescription -> 'Add or remove widgets. Tap to toggle.', and hide the 'Show desktop widgets' switch row (the master on/off governs only the wallpaper stack). Desktop path keeps the exact current 'Desktop widgets' title + description + switch byte-for-byte behind the else branch. — `/home/rahman/projects/os-vps/frontend/slices/appshell/features/widgets/components/widget-picker.tsx` *(~12 (surface branch + conditional switch row))*-2. Scale the 'Today' heading to the iOS Large Title. Change the header h2 from `text-lg font-bold` (18/700) to `text-[28px] font-extrabold tracking-[-0.02em] leading-tight`; keep `text-white [text-shadow:0_1px_3px_rgba(0,0,0,0.5)]` (springboard over-wallpaper label convention, §2.4). iOS-only file — no branch needed. — `/home/rahman/projects/os-vps/frontend/slices/appshell/features/widgets/components/mobile-widgets.tsx` *(~2)*-3. Present the picker as an iOS bottom sheet on mobile (§3.3). On surface==='mobile', render the gallery in a bottom sheet (rounded-top 20px, SOLID `var(--card)` fill, grabber 36x5 r2.5 in `text-muted-foreground`, scrim, `box-shadow: var(--shadow-pop)`) instead of centered DialogContent — MIRROR the existing AppActionSheet bottom-sheet in components/mobile-home-parts.tsx (do NOT add shadcn Drawer / vaul — none is installed; adding one violates no-new-deps). Desktop keeps the shadcn Dialog untouched behind the else branch. — `/home/rahman/projects/os-vps/frontend/slices/appshell/features/widgets/components/widget-picker.tsx (optionally extract a tiny shared sheet shell from components/mobile-home-parts.tsx)` *(~30-40 (or ~15 if the AppActionSheet shell is reused))*-4. Add iOS-26 'layered glass' depth to the SHARED widget Card, surface-branched. On surface==='mobile' add `box-shadow: var(--shadow-pop)` (lift off wallpaper) + an inner top-highlight ring, and optionally drop the fill from --glass-menu(.86) to --glass-panel(.78) for a lighter liquid-glass read. Gate on useActiveShell so the desktop stack's current flat card stays byte-identical. SKIPPABLE — glass is already HIG-correct; this is depth polish only. — `/home/rahman/projects/os-vps/frontend/slices/appshell/features/widgets/components/widget-cards.tsx` *(~10 (branch + shadow/highlight))*-5. Two independent low-cost nudges. (a) SHARED Row: branch on mobile to lift label 12.5->13 and value 12.5->15 (glanceable stat scale, §1.4); desktop unchanged behind the else branch. (b) mobile-widgets container `gap-3` -> `gap-[18px]` to match SSOT card gap-below (iOS-only, no branch). (a) is skippable (compact desktop widgets are fine); (b) is free. — `/home/rahman/projects/os-vps/frontend/slices/appshell/features/widgets/components/widget-cards.tsx (Row, branched) + /home/rahman/projects/os-vps/frontend/slices/appshell/features/widgets/components/mobile-widgets.tsx (container gap)` *(~8)*-6. Add an empty state (§3.7). In mobile-widgets, when `enabled.length===0 && quick.length===0`, render a centered column: `text-[15px] text-muted-foreground`, padding ~70/20, 'No widgets' + a 'Tap Edit to add one' hint. iOS-only file — no branch. — `/home/rahman/projects/os-vps/frontend/slices/appshell/features/widgets/components/mobile-widgets.tsx` *(~6)*+1. Fix the wrong-on-phone picker copy. Add `const { surface } = useActiveShell()` (import intra-slice from ../../../registry/shells, matching the slice's own convention — NOT the public barrel, to avoid a self-referential cycle). When surface==='mobile': DialogTitle -> 'Widgets', DialogDescription -> 'Add or remove widgets. Tap to toggle.', and hide the 'Show desktop widgets' switch row (the master on/off governs only the wallpaper stack). Desktop path keeps the exact current 'Desktop widgets' title + description + switch byte-for-byte behind the else branch. — `/home/rahman/projects/mso/frontend/slices/appshell/features/widgets/components/widget-picker.tsx` *(~12 (surface branch + conditional switch row))*+2. Scale the 'Today' heading to the iOS Large Title. Change the header h2 from `text-lg font-bold` (18/700) to `text-[28px] font-extrabold tracking-[-0.02em] leading-tight`; keep `text-white [text-shadow:0_1px_3px_rgba(0,0,0,0.5)]` (springboard over-wallpaper label convention, §2.4). iOS-only file — no branch needed. — `/home/rahman/projects/mso/frontend/slices/appshell/features/widgets/components/mobile-widgets.tsx` *(~2)*+3. Present the picker as an iOS bottom sheet on mobile (§3.3). On surface==='mobile', render the gallery in a bottom sheet (rounded-top 20px, SOLID `var(--card)` fill, grabber 36x5 r2.5 in `text-muted-foreground`, scrim, `box-shadow: var(--shadow-pop)`) instead of centered DialogContent — MIRROR the existing AppActionSheet bottom-sheet in components/mobile-home-parts.tsx (do NOT add shadcn Drawer / vaul — none is installed; adding one violates no-new-deps). Desktop keeps the shadcn Dialog untouched behind the else branch. — `/home/rahman/projects/mso/frontend/slices/appshell/features/widgets/components/widget-picker.tsx (optionally extract a tiny shared sheet shell from components/mobile-home-parts.tsx)` *(~30-40 (or ~15 if the AppActionSheet shell is reused))*+4. Add iOS-26 'layered glass' depth to the SHARED widget Card, surface-branched. On surface==='mobile' add `box-shadow: var(--shadow-pop)` (lift off wallpaper) + an inner top-highlight ring, and optionally drop the fill from --glass-menu(.86) to --glass-panel(.78) for a lighter liquid-glass read. Gate on useActiveShell so the desktop stack's current flat card stays byte-identical. SKIPPABLE — glass is already HIG-correct; this is depth polish only. — `/home/rahman/projects/mso/frontend/slices/appshell/features/widgets/components/widget-cards.tsx` *(~10 (branch + shadow/highlight))*+5. Two independent low-cost nudges. (a) SHARED Row: branch on mobile to lift label 12.5->13 and value 12.5->15 (glanceable stat scale, §1.4); desktop unchanged behind the else branch. (b) mobile-widgets container `gap-3` -> `gap-[18px]` to match SSOT card gap-below (iOS-only, no branch). (a) is skippable (compact desktop widgets are fine); (b) is free. — `/home/rahman/projects/mso/frontend/slices/appshell/features/widgets/components/widget-cards.tsx (Row, branched) + /home/rahman/projects/mso/frontend/slices/appshell/features/widgets/components/mobile-widgets.tsx (container gap)` *(~8)*+6. Add an empty state (§3.7). In mobile-widgets, when `enabled.length===0 && quick.length===0`, render a centered column: `text-[15px] text-muted-foreground`, padding ~70/20, 'No widgets' + a 'Tap Edit to add one' hint. iOS-only file — no branch. — `/home/rahman/projects/mso/frontend/slices/appshell/features/widgets/components/mobile-widgets.tsx` *(~6)***Guard (android/windows/dashboard):** Primary seam = the `today` feature slot. It is consumed ONLY by MobileHome (mobile-home.tsx: `<Slot region='today'/>`), which is instantiated ONLY by MobileShell — registered as id:'ios', surface:'mobile' at desktop.tsx:211. Android renders its OWN home (android-shell.tsx mounts only `Slot region='controlCenter'`, never `today`, and imports NOTHING from the widgets slice — verified); Windows / Dashboard / macOS are desktop shells that never mount the `today` slot. THEREFORE every edit inside mobile-widgets.tsx (steps 2, 5b, 6) is structurally iOS-only — it cannot render on any other persona, no branch required. Steps that touch SHARED files — widget-picker.tsx (steps 1, 3) and widget-cards.tsx (steps 4, 5a), which ALSO feed the `desktopWidgets` slot on macOS (desktop.tsx:184) + Windows (windows-shell.tsx:74) — MUST gate the change behind useActiveShell() (surface==='mobile' / id==='ios'), imported intra-slice from ../../../registry/shells, so the desktop render path stays byte-identical. Android + Dashboard never import these files at all, so they are unaffected regardless; the surface branch specifically protects Windows + macOS. No shared logic/store is altered — widget-registry.ts is untouched.@@ -349,7 +349,7 @@ mock→ours) · numbered steps with files + LOC · the android/windows/dashboard| Sev | Aspect | Mock / SSOT | Ours today ||---|---|---|---|| HIGH | nav idiom / in-app toolbar | iOS phone has NO Finder toolbar: navigation is the shell nav bar (icon+title+Done, frost-on-scroll) + location rows + a single trailing tint button (g-plus New / g-trash Delete). Secondary actions live in a tint "…" menu. | FilesToolbar renders a dense desktop bar (h-11 border-b: drawer toggle, back/forward chevrons, breadcrumb trail, grid/list segmented, sort dropdown, Paste, New outline, Download, Upload dropdown) IDENTICALLY on iOS — a second stacked bar under the shell nav. |-| HIGH | large title / current-folder title | Phone shows a 32px/800 large title = current location name (filesTitle), collapsing to 22/700 in the 46px nav on scroll (§3.9); sidebar shows a rootTitle large title too. | Shell nav shows the static app title "Files" (never the folder); no in-content large title anywhere — the folder name surfaces only inside the breadcrumb. mobile-shell.tsx even notes "os-vps apps carry no in-content large title." |+| HIGH | large title / current-folder title | Phone shows a 32px/800 large title = current location name (filesTitle), collapsing to 22/700 in the 46px nav on scroll (§3.9); sidebar shows a rootTitle large title too. | Shell nav shows the static app title "Files" (never the folder); no in-content large title anywhere — the folder name surfaces only inside the breadcrumb. mobile-shell.tsx even notes "mso apps carry no in-content large title." || MED | grid density / tile metrics | Phone grid: grid-template-columns:repeat(auto-fill,minmax(86px,1fr)); gap:16px 6px (~4-up on a 402px phone); thumb 58px; tile padding 9px 4px, radius 11px, gap 8px; name fileFs 12px. | @max-[430px]:grid-cols-2 (2-up on phone) with size-11/size-12 (44–48px) icons, tile rounded-lg (8px) p-3 gap-1.5, name text-[11px] line-clamp-2 — chunkier and half the column count. || MED | grid selection model | Selection tints the NAME PILL only (nameBg tint behind the label, padding 1px 7px, radius 6px); the tile itself stays transparent. | Selection fills the WHOLE tile (bg-primary text-primary-foreground). || MED | search field | Search pill at top of the Browse pane: h38, radius 9, background --fill, g-search 15×15 + "Search" placeholder --label2 — byte-shared across the split apps. | No search field in Files at all. |@@ -360,15 +360,15 @@ mock→ours) · numbered steps with files + LOC · the android/windows/dashboard| LOW | list-view idiom on phone | List view is the Mac/iPad spreadsheet table; phone DEFAULTS to grid. iOS phone list rows (when used) are grouped rows with a chevron, not a spreadsheet. | List = grid-cols-[1fr_92px_96px] Name/Size/Kind spreadsheet on every shell; grid is the iOS default (already aligned), so this is secondary. |**Steps:**-1. iOS grid tile: extract the iOS-flavored tile so file-item.tsx stays ≤200 LOC. New sibling renders a transparent tile with NAME-PILL selection (tint bg behind the label only, padding 1px 7px, radius 6px), fixed folder #57b3ff (accepted category-color exception), thumb ~54–58px, tile radius 11, gap 8, name 12px. file-item.tsx delegates to it when `ios && view==="grid"`; file-view.tsx threads `ios` and, when ios, sets the phone grid to repeat(auto-fill,minmax(86px,1fr)) gap-[16px_6px] (~4-up) instead of grid-cols-2. Else-path unchanged → android/windows/dashboard byte-identical. Fixes divergences #3,#4,#5,#6. — `/home/rahman/projects/os-vps/frontend/slices/files-manager/components/file-item-ios.tsx (new, ~110 LOC), /home/rahman/projects/os-vps/frontend/slices/files-manager/components/file-item.tsx (~10-line delegate), /home/rahman/projects/os-vps/frontend/slices/files-manager/components/file-view.tsx (~10 lines: thread ios + iOS grid cols)` *(~130 new / ~20 edit)*-2. iOS in-content large title: when `ios`, render the current folder name (last crumb) as a 28–32px/700-800 title at the top of the FileView scroll body. This gives the shell's frost-on-scroll its subject and satisfies §3.9's large-title collapse without touching mobile-shell.tsx. app.tsx threads `ios`; FileView (or a tiny sibling) renders the title only when ios. Fixes divergence #2. — `/home/rahman/projects/os-vps/frontend/slices/files-manager/app.tsx (thread ios), /home/rahman/projects/os-vps/frontend/slices/files-manager/components/file-view.tsx (~15 lines, ios-guarded title header)` *(~25)*-3. iOS toolbar slim-down (highest visual win, largest behavior surface): new sibling files-toolbar-ios.tsx renders the iOS bar — a leading back chevron as tint text, an iOS segmented grid/list toggle (track bg-secondary rounded-[9px] p-0.5, options rounded-[7px]), and a single trailing tint "…" DropdownMenu that hosts New Folder / Upload / Upload Folder / Sort / Paste / Download. Drop the breadcrumb trail on iOS (back chevron + the Step-2 large title carry the location). files-chrome.tsx renders this variant when `ios`, the existing FilesToolbar otherwise. Fixes divergence #1 (and #10 partially). All handlers are the existing cmd/fs callbacks — no data-layer change. — `/home/rahman/projects/os-vps/frontend/slices/files-manager/components/files-toolbar-ios.tsx (new, ~90 LOC), /home/rahman/projects/os-vps/frontend/slices/files-manager/components/files-chrome.tsx (~8 lines: ios branch)` *(~90 new / ~10 edit)*-4. iOS Browse sidebar polish: in files-sidebar.tsx, when `ios`, add a "Browse" large title + a search pill (shadcn: h-9 rounded-lg bg-secondary, Search icon + "Search") that filters the loaded entries client-side (presentation filter over `ordered` — NOT a host query), and bump location rows to iOS metrics (px-4 py-2.5 rounded-lg gap-2.5, icon ~17px, name text-[15px]/medium, section header 13px/600). Keep the existing active-tint-fill (already matches) and the real roots/Trash/FileTree/storage. Fixes divergences #5(search),#7. Else-path unchanged. — `/home/rahman/projects/os-vps/frontend/slices/files-manager/components/files-sidebar.tsx (~45 lines, ios branch; if search filters the grid, lift the query string to app.tsx)` *(~50)*-5. iOS empty state: in file-view.tsx empty branch, when `ios` render centered text-[15px] text-muted-foreground py-[70px] "No Items"; keep the drop-hint copy for non-ios. Fixes divergence #9. — `/home/rahman/projects/os-vps/frontend/slices/files-manager/components/file-view.tsx (~6 lines)` *(~6)*+1. iOS grid tile: extract the iOS-flavored tile so file-item.tsx stays ≤200 LOC. New sibling renders a transparent tile with NAME-PILL selection (tint bg behind the label only, padding 1px 7px, radius 6px), fixed folder #57b3ff (accepted category-color exception), thumb ~54–58px, tile radius 11, gap 8, name 12px. file-item.tsx delegates to it when `ios && view==="grid"`; file-view.tsx threads `ios` and, when ios, sets the phone grid to repeat(auto-fill,minmax(86px,1fr)) gap-[16px_6px] (~4-up) instead of grid-cols-2. Else-path unchanged → android/windows/dashboard byte-identical. Fixes divergences #3,#4,#5,#6. — `/home/rahman/projects/mso/frontend/slices/files-manager/components/file-item-ios.tsx (new, ~110 LOC), /home/rahman/projects/mso/frontend/slices/files-manager/components/file-item.tsx (~10-line delegate), /home/rahman/projects/mso/frontend/slices/files-manager/components/file-view.tsx (~10 lines: thread ios + iOS grid cols)` *(~130 new / ~20 edit)*+2. iOS in-content large title: when `ios`, render the current folder name (last crumb) as a 28–32px/700-800 title at the top of the FileView scroll body. This gives the shell's frost-on-scroll its subject and satisfies §3.9's large-title collapse without touching mobile-shell.tsx. app.tsx threads `ios`; FileView (or a tiny sibling) renders the title only when ios. Fixes divergence #2. — `/home/rahman/projects/mso/frontend/slices/files-manager/app.tsx (thread ios), /home/rahman/projects/mso/frontend/slices/files-manager/components/file-view.tsx (~15 lines, ios-guarded title header)` *(~25)*+3. iOS toolbar slim-down (highest visual win, largest behavior surface): new sibling files-toolbar-ios.tsx renders the iOS bar — a leading back chevron as tint text, an iOS segmented grid/list toggle (track bg-secondary rounded-[9px] p-0.5, options rounded-[7px]), and a single trailing tint "…" DropdownMenu that hosts New Folder / Upload / Upload Folder / Sort / Paste / Download. Drop the breadcrumb trail on iOS (back chevron + the Step-2 large title carry the location). files-chrome.tsx renders this variant when `ios`, the existing FilesToolbar otherwise. Fixes divergence #1 (and #10 partially). All handlers are the existing cmd/fs callbacks — no data-layer change. — `/home/rahman/projects/mso/frontend/slices/files-manager/components/files-toolbar-ios.tsx (new, ~90 LOC), /home/rahman/projects/mso/frontend/slices/files-manager/components/files-chrome.tsx (~8 lines: ios branch)` *(~90 new / ~10 edit)*+4. iOS Browse sidebar polish: in files-sidebar.tsx, when `ios`, add a "Browse" large title + a search pill (shadcn: h-9 rounded-lg bg-secondary, Search icon + "Search") that filters the loaded entries client-side (presentation filter over `ordered` — NOT a host query), and bump location rows to iOS metrics (px-4 py-2.5 rounded-lg gap-2.5, icon ~17px, name text-[15px]/medium, section header 13px/600). Keep the existing active-tint-fill (already matches) and the real roots/Trash/FileTree/storage. Fixes divergences #5(search),#7. Else-path unchanged. — `/home/rahman/projects/mso/frontend/slices/files-manager/components/files-sidebar.tsx (~45 lines, ios branch; if search filters the grid, lift the query string to app.tsx)` *(~50)*+5. iOS empty state: in file-view.tsx empty branch, when `ios` render centered text-[15px] text-muted-foreground py-[70px] "No Items"; keep the drop-hint copy for non-ios. Fixes divergence #9. — `/home/rahman/projects/mso/frontend/slices/files-manager/components/file-view.tsx (~6 lines)` *(~6)***Guard (android/windows/dashboard):** Seam = useActiveShell() → {id,surface}, already imported at app.tsx:42. Compute `const ios = id === "ios"` once and thread it as a prop into FileView → FileItem, FilesHeader → FilesToolbar, and FilesSidebar; every change is a NEW branch whose else-path renders today's exact markup, so nothing shared is rewritten. CRITICAL NUANCE: gate on `id === "ios"`, NOT `surface === "mobile"` — android is ALSO surface:"mobile", so a surface-level branch would mutate the android persona. `id === "ios"` leaves android (id "android"), windows (id "windows"), dashboard (id "dashboard") and macos on the untouched else-path → byte-identical render. The shells' OUTER chrome (mobile-shell.tsx nav/Done/home-indicator and android-shell.tsx) is never edited, so android's own shell stays intact. Precedent for this exact seam: os-settings/app.tsx:69 already branches presentation via useActiveShell (surface + shellId) from the same shared row primitives.-**Essence / skips:** DATA LAYER UNTOUCHED: every step is presentation-only (file-item/file-view/files-toolbar/files-chrome/files-sidebar). lib/host.ts routing, use-files*, zip/upload/inspector are never read or altered. NO-FABRICATION: the proposed iOS search pill MUST filter the already-loaded `ordered` entries client-side (presentation) — never a dead cosmetic pill and never a new host query; a chrome-only search would violate VPS essence. No hardware risk in Files (status/battery/wifi/clock belong to the shell status bar, not this app). DELIBERATE SKIPS (mock patterns that don't fit a VPS cockpit): (1) mock Favourites taxonomy iCloud Drive/AirDrop/Shared/Recents/Applications/Tags is fabricated Apple-cloud — our sidebar correctly uses REAL host roots + Trash + live FileTree + real storage usage, so we keep ours; (2) the Recents/Shared/Browse phone tab bar — Recents (no recents index) and Shared (no share graph) aren't real VPS concepts, only "Browse" is, and the shell already owns app navigation, so skip the tab bar; (3) rich doc-card/audio-gradient/app-superellipse thumbnails are deprioritized as over-fitting — our category icon-colors (colorFor: text-amber/pink/emerald/sky/violet…) already satisfy the fixed-category-color pattern. OS-VPS RULES: folder #57b3ff is the one raw hex, taken as the accepted fixed-category-color exception; every other new style uses existing theme tokens (--primary, --secondary/--field, --sep, --glass-bar/panel, text-muted-foreground) — no raw hex. shadcn primitives only; no new deps; barrel import (@/features/os-shell) already present. ≤200 LOC forces extraction: file-item.tsx is already 190 LOC and files-toolbar.tsx 133 LOC, so the iOS grid tile and iOS toolbar must land as new sibling files, not inline branches.+**Essence / skips:** DATA LAYER UNTOUCHED: every step is presentation-only (file-item/file-view/files-toolbar/files-chrome/files-sidebar). lib/host.ts routing, use-files*, zip/upload/inspector are never read or altered. NO-FABRICATION: the proposed iOS search pill MUST filter the already-loaded `ordered` entries client-side (presentation) — never a dead cosmetic pill and never a new host query; a chrome-only search would violate VPS essence. No hardware risk in Files (status/battery/wifi/clock belong to the shell status bar, not this app). DELIBERATE SKIPS (mock patterns that don't fit a VPS cockpit): (1) mock Favourites taxonomy iCloud Drive/AirDrop/Shared/Recents/Applications/Tags is fabricated Apple-cloud — our sidebar correctly uses REAL host roots + Trash + live FileTree + real storage usage, so we keep ours; (2) the Recents/Shared/Browse phone tab bar — Recents (no recents index) and Shared (no share graph) aren't real VPS concepts, only "Browse" is, and the shell already owns app navigation, so skip the tab bar; (3) rich doc-card/audio-gradient/app-superellipse thumbnails are deprioritized as over-fitting — our category icon-colors (colorFor: text-amber/pink/emerald/sky/violet…) already satisfy the fixed-category-color pattern. MSO RULES: folder #57b3ff is the one raw hex, taken as the accepted fixed-category-color exception; every other new style uses existing theme tokens (--primary, --secondary/--field, --sep, --glass-bar/panel, text-muted-foreground) — no raw hex. shadcn primitives only; no new deps; barrel import (@/features/os-shell) already present. ≤200 LOC forces extraction: file-item.tsx is already 190 LOC and files-toolbar.tsx 133 LOC, so the iOS grid tile and iOS toolbar must land as new sibling files, not inline branches.#### 8. `system-monitor` — parity: **close** · ref: MobileShell.dc.html (shared app chrome)**Surface:** iOS (MobileShell) fullscreen app: frosted-on-scroll nav bar [AppIcon + title + Done] over one scrolling content pane — 4 circular gauges (CPU/Mem/Disk real, GPU mock), CPU + Network sparkline cards, and a process table that swaps wide-grid ⇄ compact touch-list at a ≤440px container. No tab bar (single view).@@ -379,20 +379,20 @@ mock→ours) · numbered steps with files + LOC · the android/windows/dashboard| MED | nav-trailing action (Refresh) | Screen actions live in the nav bar as trailing --tint icon buttons (§2.4 nav trailing, §3.6 tinted/plain). | Refresh sits in the in-app header's ResponsiveToolbar, not the iOS nav; the iOS shell nav exposes only 'Done' (no app-action slot). || MED | destructive used as text (contrast) | Destructive is a semantic red kept AA-legible when it's text on a card. | process-table.tsx cpuTone() applies `text-destructive` (--destructive #ff5f57, the bright FILL red) to CPU>50% text on a light card (~3:1, below AA 4.5:1). globals.css defines --destructive-text (#d70015) for exactly this case and it's unused. Shared component — shows in all shells. || LOW | section/panel + header typography | Section header 13/600 (Title3 20/700 when prominent); nav title 16/600 (§1.4/§3.1). | GlassPanel title 12.5px/700 bold non-upper (glass-panel.tsx:15); in-app header title text-sm=14/600 (app.tsx:88) — undersized vs the 16/600 nav and off the 13/600 section spec. Shared component. |-| LOW | content surface token / naming (glass-on-content) | Golden rule #2 — content cards are SOLID --card/--elev; glass (blur) is chrome-only, never on content. | Gauge + panel cards fill with --glass-panel (0.78/0.74α) via a component literally named 'GlassPanel', but with NO backdrop-filter, and os-vps --card is itself 0.86α translucent — so it renders near-solid and is effectively compliant. The token name + alpha only imply glass-on-content; low real impact. |+| LOW | content surface token / naming (glass-on-content) | Golden rule #2 — content cards are SOLID --card/--elev; glass (blur) is chrome-only, never on content. | Gauge + panel cards fill with --glass-panel (0.78/0.74α) via a component literally named 'GlassPanel', but with NO backdrop-filter, and mso --card is itself 0.86α translucent — so it renders near-solid and is effectively compliant. The token name + alpha only imply glass-on-content; low real impact. || LOW | separator hairline weight | Hairline 0.5px --sep, inset to row padding (§3.1). | process rows + gauge/panel borders use 1px `border-t`/`border` --sep (default width), not 0.5px. Shared components. || LOW | empty / loading state type size | Empty state centered --label2 15px, padding 70px 20px (§3.7). | Loading 'Reading host telemetry…' is text-xs=12 + spinner (app.tsx:66); empty 'No process data' is 11px (process-table.tsx:17) — under the 15px spec. || LOW | nav title alignment / leading control | Nav title centered; leading = Back/Home chevron (tint); trailing = share (§2.4). | iOS shell nav is LEFT-aligned [AppIcon]+title with a trailing 'Done' and no Back chevron. Intentional and correct: apps open modally (zoom over springboard), so Done-not-Back is the right iOS idiom. Shell-level (mobile-shell.tsx), not the slice — flagged as verified-OK, not a defect. |**Steps:**-1. Expose the iOS-scope seam to the slice: add `export { useActiveShell } from "@/features/os-shell";` (optionally `type ShellId`) to the slice's host barrel. Barrel-only cross-slice import (already the file's job), purely additive. — `/home/rahman/projects/os-vps/frontend/slices/system-monitor/lib/host.ts` *(~1-2 lines)*-2. Kill the double-title on iOS. In SystemMonitor() read `const { id } = useActiveShell()`. When `id === "ios"`: pass NO `header` to AppFrame (the shell nav already shows icon+title+Done); relocate the cores·mode chip to a slim footnote at the top of the content body (12.5px, --text-dim, per §3.1 footnote); drop the manual Refresh (the 1.5s live poll covers it) OR keep it as one trailing --tint icon button in that footnote. For every other `id`, return today's EXACT header markup — untouched. — `/home/rahman/projects/os-vps/frontend/slices/system-monitor/app.tsx` *(~15-20 lines)*-3. (Optional, fuller §2.4 parity) Give the iOS shell nav a trailing app-action slot so Refresh lives beside 'Done' as a --tint icon. Add a tiny nav-action register (context/Slot in the appshell shell-ui) that mobile-shell.tsx renders between title and Done; system-monitor writes Refresh into it under `id==="ios"`. mobile-shell.tsx is the render fn for shell id "ios" only — windows/dashboard/android shells are separate files and cannot be reached. — `/home/rahman/projects/os-vps/frontend/slices/appshell/components/mobile-shell.tsx (+ small shell-ui register) and /home/rahman/projects/os-vps/frontend/slices/system-monitor/app.tsx` *(~25-40 lines)*-4. (Optional polish, SAME iOS branch) With the header gone on iOS, normalize the content body's top padding (the `p-4` wrapper) so GaugeGrid sits at a comfortable inset under the frosted nav and scrolls under its frost-on-scroll. Only the iOS branch's wrapper className changes. — `/home/rahman/projects/os-vps/frontend/slices/system-monitor/app.tsx` *(~2-4 lines)*+1. Expose the iOS-scope seam to the slice: add `export { useActiveShell } from "@/features/os-shell";` (optionally `type ShellId`) to the slice's host barrel. Barrel-only cross-slice import (already the file's job), purely additive. — `/home/rahman/projects/mso/frontend/slices/system-monitor/lib/host.ts` *(~1-2 lines)*+2. Kill the double-title on iOS. In SystemMonitor() read `const { id } = useActiveShell()`. When `id === "ios"`: pass NO `header` to AppFrame (the shell nav already shows icon+title+Done); relocate the cores·mode chip to a slim footnote at the top of the content body (12.5px, --text-dim, per §3.1 footnote); drop the manual Refresh (the 1.5s live poll covers it) OR keep it as one trailing --tint icon button in that footnote. For every other `id`, return today's EXACT header markup — untouched. — `/home/rahman/projects/mso/frontend/slices/system-monitor/app.tsx` *(~15-20 lines)*+3. (Optional, fuller §2.4 parity) Give the iOS shell nav a trailing app-action slot so Refresh lives beside 'Done' as a --tint icon. Add a tiny nav-action register (context/Slot in the appshell shell-ui) that mobile-shell.tsx renders between title and Done; system-monitor writes Refresh into it under `id==="ios"`. mobile-shell.tsx is the render fn for shell id "ios" only — windows/dashboard/android shells are separate files and cannot be reached. — `/home/rahman/projects/mso/frontend/slices/appshell/components/mobile-shell.tsx (+ small shell-ui register) and /home/rahman/projects/mso/frontend/slices/system-monitor/app.tsx` *(~25-40 lines)*+4. (Optional polish, SAME iOS branch) With the header gone on iOS, normalize the content body's top padding (the `p-4` wrapper) so GaugeGrid sits at a comfortable inset under the frosted nav and scrolls under its frost-on-scroll. Only the iOS branch's wrapper className changes. — `/home/rahman/projects/mso/frontend/slices/system-monitor/app.tsx` *(~2-4 lines)***Guard (android/windows/dashboard):** One seam only: `useActiveShell().id === \"ios\"` inside app.tsx. macos, windows, dashboard AND android all fall to the untouched else-branch, so their rendered markup is byte-identical to today. Critically the branch keys on `id === \"ios\"`, NOT `surface === \"mobile\"` — android is also surface:\"mobile\" and renders its own title bar (android-shell.tsx:160) that must stay unchanged. Step 3 touches mobile-shell.tsx, which is the `render` registered ONLY for shell id \"ios\" (desktop.tsx:211); windows-shell.tsx / dashboard-shell.tsx / android-shell.tsx are separate files a nav-slot there cannot reach. The host.ts edit is a pure additive re-export (new symbol) — existing exports and every other slice file stay byte-identical. The shared slice components (GlassPanel, CircularGauge, ProcessTable) render in all shells and are deliberately NOT touched — their low/med cosmetic + contrast nits are flagged as shared-surface and left out of the iOS-scoped plan so the other three personas remain byte-unchanged.-**Essence / skips:** VPS-essence holds: (1) NO status bar — the mock's clock/battery/wifi/signal + Dynamic Island (§2.4) are hardware we must never fabricate; the iOS shell correctly renders none (reserves the --sai-top notch zone only). The plan keeps it absent. (2) Data layer untouched — all telemetry flows host.ts → useOsApi() → OsApi port (use-stats-history polls api.sys.stats/processes); every proposed change is presentational in app.tsx / mobile-shell.tsx, never the host-I/O routing. Deliberate mock patterns skipped: (a) Large title §3.9 — os-vps convention (mobile-shell comment: 'apps carry no in-content large title'); a 32/800 title wastes cockpit vertical space. (b) Tab bar §2.2 — single-view app, no tabs; N/A. (c) Grouped inset-list row anatomy §3.1 — this is a gauge+sparkline+table dashboard, so we match the 'solid cards on grouped bg' intent (12px radius, --surface as grouped bg) without forcing list rows. Soft caveat: the GPU gauge (gauge-grid.tsx: a random-walk, labeled 'GPU (mock)') is a fabricated metric not in the SysStats contract — borderline vs 'never fabricate hardware'; it's honestly labeled so acceptable, but the essence-pure option is to drop it (naming it, not mandating). The multi-hue MONITOR_VARS palette is the sanctioned fixed-category-color exception, not a one-tint violation.+**Essence / skips:** VPS-essence holds: (1) NO status bar — the mock's clock/battery/wifi/signal + Dynamic Island (§2.4) are hardware we must never fabricate; the iOS shell correctly renders none (reserves the --sai-top notch zone only). The plan keeps it absent. (2) Data layer untouched — all telemetry flows host.ts → useOsApi() → OsApi port (use-stats-history polls api.sys.stats/processes); every proposed change is presentational in app.tsx / mobile-shell.tsx, never the host-I/O routing. Deliberate mock patterns skipped: (a) Large title §3.9 — mso convention (mobile-shell comment: 'apps carry no in-content large title'); a 32/800 title wastes cockpit vertical space. (b) Tab bar §2.2 — single-view app, no tabs; N/A. (c) Grouped inset-list row anatomy §3.1 — this is a gauge+sparkline+table dashboard, so we match the 'solid cards on grouped bg' intent (12px radius, --surface as grouped bg) without forcing list rows. Soft caveat: the GPU gauge (gauge-grid.tsx: a random-walk, labeled 'GPU (mock)') is a fabricated metric not in the SysStats contract — borderline vs 'never fabricate hardware'; it's honestly labeled so acceptable, but the essence-pure option is to drop it (naming it, not mandating). The multi-hue MONITOR_VARS palette is the sanctioned fixed-category-color exception, not a one-tint violation.#### 9. `app-store` — parity: **diverges** · ref: MobileShell.dc.html (shared app chrome)**Surface:** iOS phone fullscreen app (MobileShell hosts it): the App Store browse screen — in-content header/title + search field + category filter + 2-col app-card grid. The iOS shell adds only a floating back chevron + home indicator (no OS nav bar), so this app's own header IS the iOS chrome/title. Single presentation file: components/apps/AppStoreApp.tsx (169 LOC), no iOS variant.@@ -403,7 +403,7 @@ mock→ours) · numbered steps with files + LOC · the android/windows/dashboard| LOW | double-title backlog item (honest finding) | One canonical title per screen; on iOS the shell/nav owns it. | On iOS there is exactly ONE title today (the app's own <h1>) — the MobileShell contributes no title, so there is NO iOS double-title. The real duplication is DESKTOP-only: window.tsx renders win.title "App Store" (catalog-entries-c.tsx:129) AND the app renders <h1>App Store</h1>. Fixing that dedup lives in the macOS/Windows render path = out of iOS scope; do not touch it here. || MED | search field material (§3.2) | systemFill pill: --fill bg, NO border, radius ~10-12, #g-search 15x15 --label2 + "Search" placeholder in --label2. | `flex items-center gap-2 rounded-md border border-border bg-card` wrapper (bordered + card fill = wrong material) around a shadcn <Input>. Should be borderless on a systemFill (--muted) fill under iOS. || MED | category filter control + selected tint (§3.4 / Golden rule 5) | Small fixed set → segmented control (--fill track r9 pad2, option pad7x4 r7 14/500, selected = --card pill + shadow). Selected/interactive uses --tint (iOS blue #0a84ff default). | rounded-full outline chips (`border px-2.5 py-0.5 text-xs`), selected = `border-primary bg-primary/10`. --primary is monochrome near-black by default (only tinted if the user sets a Brand; iOS blue lives in --os-accent), so the selected chip reads gray, not iOS-blue. Sizing/weight also off (text-xs vs 13-14/500). |-| LOW | filled/prominent button tint (§3.6) | Filled Install button = --tint bg, #fff label, weight 600. | Install <Button> (shadcn default) = --primary bg = monochrome near-black on iOS by default. Native iOS cue is --os-accent (blue). Shared primitive, so gate any change. Neutral-until-branded is a deliberate OS-wide default (MEMORY: osvps-hig-design), hence low. |+| LOW | filled/prominent button tint (§3.6) | Filled Install button = --tint bg, #fff label, weight 600. | Install <Button> (shadcn default) = --primary bg = monochrome near-black on iOS by default. Native iOS cue is --os-accent (blue). Shared primitive, so gate any change. Neutral-until-branded is a deliberate OS-wide default (MEMORY: mso-hig-design), hence low. || LOW | empty state (§3.7) | Centered column, --label2, 15px, padding 70px 20px, optional muted glyph above the text. | `grid place-items-center text-sm(14px) text-muted-foreground` "No apps match" — close but 14 vs 15px, small pad (no 70px), no glyph. || MED | shell nav-bar chrome (mock reference screen = MobileShell) | MobileShell.dc.html: 44 status bar + 46 nav bar (centered title, leading/trailing tint text buttons, glass) + tab bar; large-title collapse. | MobileShell renders a floating translucent back chevron (no title, no nav bar, no glass hairline) + home indicator — a deliberate 'edge-to-edge, no OS header' contract (mobile-shell.tsx:140). Divergent from the mock's nav bar, BUT this is SHELL-level (features/appshell/components/mobile-shell.tsx), shared by every iOS app — out of the app-store slice's scope; name it, don't fix it here. |@@ -417,7 +417,7 @@ mock→ours) · numbered steps with files + LOC · the android/windows/dashboard**Guard (android/windows/dashboard):** Seam = the `<html data-shell=\"ios\">` attribute stamped by useShellTokens (features/appshell/components/use-shell-tokens.ts); the other personas stamp data-shell=\"android\" / \"windows\" / \"dashboard\". Every step above is either an iOS-only CSS branch ([data-shell=\"ios\"] ...) or a className that is completely inert without that attribute, so android/windows/dashboard never match the selector — their DOM tree AND computed styles stay byte-identical. This is the exact seam appshell.css, os-spinner.tsx, context-menu.tsx and force-quit-dialog-parts.tsx already use. I keep the shared AppStoreApp.tsx markup element-for-element identical (additions are class strings only), so even the runtime element tree is unchanged for the other three shells; JS branching (step 6) is reserved for the phase-2 collapse and, if used, mounts extra nodes ONLY when a reactive data-shell===\"ios\" read is true. No shared logic (install state, openWindow, catalog, useApps) is touched.-**Essence / skips:** VPS-essence: app-store fabricates NO hardware (no wifi/battery/cellular/clock/brightness/signal) — nothing to violate. File-explorer DATA layer untouched: install state flows from the `apps` Database via useUninstalledAppIds/useAppActions (@/features/data barrel), which is app-install metadata, NOT host-I/O — lib/host.ts is never in this path, and all steps touch presentation (classNames + CSS) only. OS-VPS rules honored: shadcn primitives kept (Input/Button); theme tokens only (--muted/--os-accent/--primary-foreground/--grouped) — the fixed badge colors (sky/violet/amber/pink) are the accepted fixed-category exception; no new deps; CSS lands in existing files; TSX additions are className-only so AppStoreApp.tsx stays under the 200-LOC gate (currently 169); barrel-only imports preserved (step 6's hook exports from @/features/appshell). DELIBERATE SKIPS: (1) segmented control for the category filter — categories are dynamic/variable-length, so re-token the scrolling capsule row instead (iOS does the same for variable sets); (2) large-title collapse-on-scroll animation — phase-2; ship a static large title first because the app owns a nested inner scroll container that makes a true collapse fiddly; (3) the DESKTOP double-title dedup (hiding the in-content <h1> on macOS/Windows) and the MobileShell nav-bar rebuild — both live in shared/other-shell code and are out of the iOS app-store slice. ALREADY MATCHES — do not rebuild: the app icon is the correct 23% superellipse squircle (.icon-tile + [data-shell=\"ios\"], appshell.css:154), and the card radius (rounded-xl ≈ 14px) is within the 12-16px browse-tile spec; the 2-col card/tile browse grid is on-spec (SSOT §3.8 shares the grid-tile pattern between Files grid + Safari favourites), so the layout is close — only the chrome/title/material/tint diverge.+**Essence / skips:** VPS-essence: app-store fabricates NO hardware (no wifi/battery/cellular/clock/brightness/signal) — nothing to violate. File-explorer DATA layer untouched: install state flows from the `apps` Database via useUninstalledAppIds/useAppActions (@/features/data barrel), which is app-install metadata, NOT host-I/O — lib/host.ts is never in this path, and all steps touch presentation (classNames + CSS) only. MSO rules honored: shadcn primitives kept (Input/Button); theme tokens only (--muted/--os-accent/--primary-foreground/--grouped) — the fixed badge colors (sky/violet/amber/pink) are the accepted fixed-category exception; no new deps; CSS lands in existing files; TSX additions are className-only so AppStoreApp.tsx stays under the 200-LOC gate (currently 169); barrel-only imports preserved (step 6's hook exports from @/features/appshell). DELIBERATE SKIPS: (1) segmented control for the category filter — categories are dynamic/variable-length, so re-token the scrolling capsule row instead (iOS does the same for variable sets); (2) large-title collapse-on-scroll animation — phase-2; ship a static large title first because the app owns a nested inner scroll container that makes a true collapse fiddly; (3) the DESKTOP double-title dedup (hiding the in-content <h1> on macOS/Windows) and the MobileShell nav-bar rebuild — both live in shared/other-shell code and are out of the iOS app-store slice. ALREADY MATCHES — do not rebuild: the app icon is the correct 23% superellipse squircle (.icon-tile + [data-shell=\"ios\"], appshell.css:154), and the card radius (rounded-xl ≈ 14px) is within the 12-16px browse-tile spec; the 2-col card/tile browse grid is on-spec (SSOT §3.8 shares the grid-tile pattern between Files grid + Safari favourites), so the layout is close — only the chrome/title/material/tint diverge.#### 10. `browser` — parity: **diverges** · ref: Safari.dc.html**Surface:** iOS Safari chrome only — the address/search bar, the tab strip, and the toolbar bands that wrap a REAL Playwright screenshot. The page content itself (RemoteView `<img>`) is a live 1280×800 Chromium frame and is not a styleable iOS surface. Mock ref: Safari.dc.html (single sticky top glass address bar).@@ -435,11 +435,11 @@ mock→ours) · numbered steps with files + LOC · the android/windows/dashboard| LOW | overlays: history popover + AI sheet side | iOS presents transient lists as a BOTTOM sheet: rounded-top 20px, solid --elev, grabber 36x5 r2.5, scrim (SSOT 3.3). | history-view.tsx = top-right rounded-xl popover w/ bg-black/20 scrim (desktop anchor). ai-panel.tsx = shadcn Sheet side='right' (iPad/desktop drawer), not bottom. (AI panel isn't a mock-Safari element — polish only.) |**Steps:**-1. Add the seam: import useActiveShell into the existing `@/features/os-shell` line, read `const { id: shellId } = useActiveShell()` in LiveBrowser, derive `const ios = shellId === 'ios'`, and thread it into the header/toolbar branches (steps 2-4). Strict === 'ios' gate is the whole guard. — `/home/rahman/projects/os-vps/frontend/slices/browser/app.tsx` *(~12 LOC)*-2. iOS glass address bar in Omnibar: add optional `ios?: boolean` prop. When ios, early-return a single glass bar — container `bg-[var(--glass-bar)] backdrop-blur-xl border-b border-border px-3.5 py-2`, holding ONE centered pill button `h-[38px] rounded-[11px] bg-muted` with lock `size-3 text-muted-foreground` (neutral, drop the green/globe swap) + URL `text-sm text-foreground`; tapping the pill focuses the Input (or expands to it). Hide the Back/Forward/Reload/Home cluster, Star, and kebab from the bar (fold reload/history/bookmark into the browser menu). Keep the loading hairline. Non-ios path = the current return, untouched. — `/home/rahman/projects/os-vps/frontend/slices/browser/components/omnibar.tsx (+ pass ios from app.tsx)` *(~55 LOC)*-3. Collapse the desktop tab strip on iOS: in app.tsx set `header={ios ? undefined : <TabBar .../>}` and add a small tab-switcher affordance (count glyph) in the iOS omnibar trailing slot that opens a bottom-sheet list of rb.tabs reusing onSwitch/onClose/onNew — preserves REAL multi-tab, drops the Chrome strip. Barrel-safe new component under components/ (<200 lines). Optionally give tab-bar.tsx an `ios` prop instead of a new file. — `/home/rahman/projects/os-vps/frontend/slices/browser/app.tsx, new /home/rahman/projects/os-vps/frontend/slices/browser/components/ios-tabs.tsx` *(~60 LOC)*-4. Drop the second toolbar band on iOS: `toolbar={<><Omnibar ios={ios} .../>{!ios && <BookmarkBar .../>}</>}`. OPTIONAL (VPS-essence-safe): on the blank/new-tab state render a Favourites grid built from REAL `bookmarks` (58x58 r15 letter tiles, label text-[12.5px] text-muted-foreground) — matches the mock grid using real data. DO NOT port the mock's Privacy Report card. — `/home/rahman/projects/os-vps/frontend/slices/browser/app.tsx, optional new /home/rahman/projects/os-vps/frontend/slices/browser/components/ios-start.tsx` *(~6 LOC (hide) / +~45 LOC (optional grid))*-5. Optional low-priority polish: give history-view.tsx an `ios` prop that renders a bottom sheet (rounded-t-[20px], solid bg-card, grabber 36x5 rounded-full bg-muted-foreground/30, scrim) instead of the top-right popover; flip ai-panel.tsx to `Sheet side={ios ? 'bottom' : 'right'}`. Both default false so non-ios is byte-identical. — `/home/rahman/projects/os-vps/frontend/slices/browser/components/history-view.tsx, /home/rahman/projects/os-vps/frontend/slices/browser/components/ai-panel.tsx` *(~35 LOC)*+1. Add the seam: import useActiveShell into the existing `@/features/os-shell` line, read `const { id: shellId } = useActiveShell()` in LiveBrowser, derive `const ios = shellId === 'ios'`, and thread it into the header/toolbar branches (steps 2-4). Strict === 'ios' gate is the whole guard. — `/home/rahman/projects/mso/frontend/slices/browser/app.tsx` *(~12 LOC)*+2. iOS glass address bar in Omnibar: add optional `ios?: boolean` prop. When ios, early-return a single glass bar — container `bg-[var(--glass-bar)] backdrop-blur-xl border-b border-border px-3.5 py-2`, holding ONE centered pill button `h-[38px] rounded-[11px] bg-muted` with lock `size-3 text-muted-foreground` (neutral, drop the green/globe swap) + URL `text-sm text-foreground`; tapping the pill focuses the Input (or expands to it). Hide the Back/Forward/Reload/Home cluster, Star, and kebab from the bar (fold reload/history/bookmark into the browser menu). Keep the loading hairline. Non-ios path = the current return, untouched. — `/home/rahman/projects/mso/frontend/slices/browser/components/omnibar.tsx (+ pass ios from app.tsx)` *(~55 LOC)*+3. Collapse the desktop tab strip on iOS: in app.tsx set `header={ios ? undefined : <TabBar .../>}` and add a small tab-switcher affordance (count glyph) in the iOS omnibar trailing slot that opens a bottom-sheet list of rb.tabs reusing onSwitch/onClose/onNew — preserves REAL multi-tab, drops the Chrome strip. Barrel-safe new component under components/ (<200 lines). Optionally give tab-bar.tsx an `ios` prop instead of a new file. — `/home/rahman/projects/mso/frontend/slices/browser/app.tsx, new /home/rahman/projects/mso/frontend/slices/browser/components/ios-tabs.tsx` *(~60 LOC)*+4. Drop the second toolbar band on iOS: `toolbar={<><Omnibar ios={ios} .../>{!ios && <BookmarkBar .../>}</>}`. OPTIONAL (VPS-essence-safe): on the blank/new-tab state render a Favourites grid built from REAL `bookmarks` (58x58 r15 letter tiles, label text-[12.5px] text-muted-foreground) — matches the mock grid using real data. DO NOT port the mock's Privacy Report card. — `/home/rahman/projects/mso/frontend/slices/browser/app.tsx, optional new /home/rahman/projects/mso/frontend/slices/browser/components/ios-start.tsx` *(~6 LOC (hide) / +~45 LOC (optional grid))*+5. Optional low-priority polish: give history-view.tsx an `ios` prop that renders a bottom sheet (rounded-t-[20px], solid bg-card, grabber 36x5 rounded-full bg-muted-foreground/30, scrim) instead of the top-right popover; flip ai-panel.tsx to `Sheet side={ios ? 'bottom' : 'right'}`. Both default false so non-ios is byte-identical. — `/home/rahman/projects/mso/frontend/slices/browser/components/history-view.tsx, /home/rahman/projects/mso/frontend/slices/browser/components/ai-panel.tsx` *(~35 LOC)***Guard (android/windows/dashboard):** Single seam: `const { id: shellId } = useActiveShell()` in LiveBrowser (app.tsx), `const ios = shellId === 'ios'`. Every change is behind `ios ? ... : <existing>` or an `if (ios)` early-return, and the gate is the exact string 'ios'. Because android is a SEPARATE id (also surface==='mobile'), keying on id==='ios' — never surface==='mobile' — leaves android on the untouched default path along with windows/dashboard/macos: their prop expressions and JSX are the current ones, so render output is byte-identical. No shared primitive is edited — AppFrame, Button, Input, Sheet, and the mobile-shell nav/home-indicator chrome are untouched; only the browser slice's own private components (omnibar/tab-bar/history-view/ai-panel, confirmed imported nowhere outside the slice) gain an optional `ios?: boolean` prop defaulting false/undefined, so every existing call site is a no-op.@@ -486,8 +486,8 @@ mock→ours) · numbered steps with files + LOC · the android/windows/dashboard**Steps:**1. RECOMMENDED: ship no change. The task's three asks are already met — nav bar inherited from the iOS shell, notch reserved via --sai-top + home indicator padded via --sai-bottom in both components, and --font-mono-ui names SF Mono. Content stays solid (no glass-on-content) and frost-on-scroll works for both the exec div and the xterm viewport. The steps below are OPTIONAL polish, each recommended-skip. — `(none — verification only)` *(0)*-2. OPTIONAL (recommend skip): SF-Mono-first on iOS only. Add `export { useActiveShell } from "@/features/os-shell";` to the slice barrel-seam, then in pty-terminal (xterm fontFamily) and exec-terminal (font-family) branch: when useActiveShell().id==="ios", use 'ui-monospace, "SF Mono", Menlo, monospace' instead of the --font-mono-ui var. Honest caveat: Geist Mono is the OS-wide brand mono (code-editor etc. keep it) — forcing SF Mono only in the terminal only on iOS is inconsistent; the current stack already lists SF Mono as fallback. — `/home/rahman/projects/os-vps/frontend/slices/os-terminal/lib/host.ts, /home/rahman/projects/os-vps/frontend/slices/os-terminal/components/pty-terminal.tsx, /home/rahman/projects/os-vps/frontend/slices/os-terminal/components/exec-terminal.tsx` *(~12 LOC (1 re-export + a font branch in each component))*-3. OPTIONAL (recommend skip): iOS-only banner polish — swap hardcoded hex for theme tokens + continuous corners on the connection/mode strips, gated by useActiveShell().id==="ios" so android/windows/dashboard keep the exact current hex banner. Must preserve semantic meaning (green=live, red=error) and must NOT make it resemble a device status bar. audit-allow-hex already blesses the current palette and it is dark-terminal-consistent, so value is marginal. — `/home/rahman/projects/os-vps/frontend/slices/os-terminal/components/pty-terminal.tsx (StatusBar), /home/rahman/projects/os-vps/frontend/slices/os-terminal/components/exec-terminal.tsx (mode banner), /home/rahman/projects/os-vps/frontend/slices/os-terminal/app.tsx (PTY-unavailable banner)` *(~15-25 LOC)*+2. OPTIONAL (recommend skip): SF-Mono-first on iOS only. Add `export { useActiveShell } from "@/features/os-shell";` to the slice barrel-seam, then in pty-terminal (xterm fontFamily) and exec-terminal (font-family) branch: when useActiveShell().id==="ios", use 'ui-monospace, "SF Mono", Menlo, monospace' instead of the --font-mono-ui var. Honest caveat: Geist Mono is the OS-wide brand mono (code-editor etc. keep it) — forcing SF Mono only in the terminal only on iOS is inconsistent; the current stack already lists SF Mono as fallback. — `/home/rahman/projects/mso/frontend/slices/os-terminal/lib/host.ts, /home/rahman/projects/mso/frontend/slices/os-terminal/components/pty-terminal.tsx, /home/rahman/projects/mso/frontend/slices/os-terminal/components/exec-terminal.tsx` *(~12 LOC (1 re-export + a font branch in each component))*+3. OPTIONAL (recommend skip): iOS-only banner polish — swap hardcoded hex for theme tokens + continuous corners on the connection/mode strips, gated by useActiveShell().id==="ios" so android/windows/dashboard keep the exact current hex banner. Must preserve semantic meaning (green=live, red=error) and must NOT make it resemble a device status bar. audit-allow-hex already blesses the current palette and it is dark-terminal-consistent, so value is marginal. — `/home/rahman/projects/mso/frontend/slices/os-terminal/components/pty-terminal.tsx (StatusBar), /home/rahman/projects/mso/frontend/slices/os-terminal/components/exec-terminal.tsx (mode banner), /home/rahman/projects/mso/frontend/slices/os-terminal/app.tsx (PTY-unavailable banner)` *(~15-25 LOC)***Guard (android/windows/dashboard):** The terminal is shell-AGNOSTIC today: grep confirms zero useActiveShell / data-shell usage, so android/windows/dashboard (and macOS) render the identical current bytes. Every proposed step is gated behind `useActiveShell().id === \"ios\"`, reached only through the slice's existing `@/features/os-shell` barrel (which does `export * from \"@/features/appshell\"`, re-exporting useActiveShell) via a one-line re-export in lib/host.ts — satisfying the barrel-only cross-slice rule. Because the other three shells never resolve id===\"ios\", they fall to the else-arm = the exact current code path; no shared markup/logic is edited, the iOS branch is purely additive. The one change that can't be cleanly iOS-gated (KeyBar 44pt touch target — key-bar.tsx BTN is h-9/36px vs HIG 44pt) is DELIBERATELY EXCLUDED from this iOS task: the key bar shows for every coarse-pointer shell, so a bigger target would also alter android — it must be raised as a separate cross-shell a11y fix, not smuggled in here.@@ -506,7 +506,7 @@ mock→ours) · numbered steps with files + LOC · the android/windows/dashboard| LOW | Muted text + empty-state tokens (§1.1 label2 / §3.7) | Muted text = --label2; empty state = centered column, 15px --label2, optional MUTED glyph, ~70px pad. | Muted text is hex (#9aa0aa/#7d8590). Empty state already MATCHES the §3.7 shape (centered, text-[15px], glyph above, New-file button, muted subtitle) but uses hex colors and a vivid blue gradient glyph instead of a muted one. Near-parity. |**Steps:**-1. Add the iOS seam: const isIos = useActiveShell().id === 'ios' in app.tsx (import from @/features/os-shell), and thread an `ios` boolean prop into EditorToolbar, TabStrip, StatusBar. Pure enabler — no visual change until steps 2-4 read it; gives every later change a clean else-branch. — `/home/rahman/projects/os-vps/frontend/slices/code-editor/app.tsx` *(~12)*+1. Add the iOS seam: const isIos = useActiveShell().id === 'ios' in app.tsx (import from @/features/os-shell), and thread an `ios` boolean prop into EditorToolbar, TabStrip, StatusBar. Pure enabler — no visual change until steps 2-4 read it; gives every later change a clean else-branch. — `/home/rahman/projects/mso/frontend/slices/code-editor/app.tsx` *(~12)*2. iOS 'dark-glass' chrome: when `ios`, swap panel bg-[#16161a]→bg-[var(--glass-bar)] backdrop-blur-xl, borders border-[#2a2a30]→border-[var(--sep)] (.5px hairline), muted text #9aa0aa/#7d8590→text-muted-foreground, via conditional cn(). Keep the exact current hex classes in the else. Leaves the dark aesthetic but makes the chrome a translucent hairline layer under the shell nav bar (§4). Do NOT touch EditorSurface. — `editor-toolbar.tsx, tab-strip.tsx, status-bar.tsx (all under .../code-editor/components/)` *(~35)*3. 44pt touch targets on iOS: gate additional size bumps on `ios` — Save/Preview →h-11, tab row →min-h-11, new-file + →size-11, tab-close →size-11. Reuse the existing cn() class lists; append ios-only variants so the coarse-pointer classes (which also hit Android) are not widened. — `editor-toolbar.tsx, tab-strip.tsx` *(~10)*4. CloseGuardDialog → bottom sheet on iOS: when `ios`, render via FormDrawer (ResponsiveDialog variant='alert') so it becomes the rounded-top-20px bottom drawer with grabber; keep the raw AlertDialog branch for non-iOS. Gate on id==='ios' (NOT the primitive's own useIsMobile) so Android stays on the centered dialog. — `close-guard-dialog.tsx` *(~20)*@@ -532,7 +532,7 @@ mock→ours) · numbered steps with files + LOC · the android/windows/dashboard**Steps:**1. iOS now-playing for audio (highest-value gap). Add `const ios = useActiveShell().id === 'ios'` and, when ios, render the Music-mock centered column: ~min(220px,70vw) rounded-2xl gradient art tile w/ Music glyph, centered title text-[22px]/700 + artist text-primary + meta --muted-foreground, then the transport. Keep the existing card branch untouched for every other shell. Extract an ios-now-playing.tsx sibling to stay <200 lines. — `slices/media-viewer/components/audio-player.tsx (+ new components/ios-now-playing.tsx)` *(~70 (new sibling) + ~10 (branch))*2. Add a filled-tint prominent play variant to PlayButton (size-16 rounded-full bg-primary text-primary-foreground shadow-lg) and flank it with lucide SkipBack/SkipForward (already used in reel-editor) at the iOS now-playing call site. Add the variant alongside — do NOT modify the existing default/`big` ghost variants (video-player + desktop keep them byte-for-byte). — `slices/media-viewer/components/transport.tsx` *(~20)*-3. Fold the audio-art color fix into Step 1: on the iOS branch use the fixed warm audio gradient (e.g. linear-gradient(135deg,#ff6a9a,#f52d55)) for the art tile instead of the blue --accent tint (fixed category color = accepted OS-VPS exception; matches SSOT audio-tile system color). Non-iOS tile unchanged. — `slices/media-viewer/components/ios-now-playing.tsx (from Step 1)` *(~2)*+3. Fold the audio-art color fix into Step 1: on the iOS branch use the fixed warm audio gradient (e.g. linear-gradient(135deg,#ff6a9a,#f52d55)) for the art tile instead of the blue --accent tint (fixed category color = accepted MSO exception; matches SSOT audio-tile system color). Non-iOS tile unchanged. — `slices/media-viewer/components/ios-now-playing.tsx (from Step 1)` *(~2)*4. OPTIONAL / med — iOS immersive image lightbox. When ios && kind==='image', swap the checkerboard for bg-black/95, center the image r16 + shadow-[0_30px_80px_rgba(0,0,0,.6)], and render 40px circular translucent prev/next (thread onPrev/onNext down from SampleGallery — they currently live in ViewerToolbar). Non-iOS keeps checkerboard + toolbar arrows unchanged. Consider keeping the checkerboard even on iOS for TRANSPARENT images (more honest) and scoping black-immersion to opaque/remote only. — `slices/media-viewer/components/media-stage.tsx, image-view.tsx, app.tsx (prop threading)` *(~55)*5. DELIBERATE SKIP (document, no edit) — do NOT sheet-ify image-picker/media-studio dialogs or rebuild the picker tab strip as a segmented control here. Sheet presentation is mobile-wide (useIsMobile) and would change Android too; it belongs to the shared ResponsiveDialog/FormDrawer primitive as a separate cross-shell task, not an iOS-scoped edit inside these utility components. Also skip the Photos album-browser + photo-grid (that is the Files app's domain). — `(none)` *(0)*@@ -553,12 +553,12 @@ mock→ours) · numbered steps with files + LOC · the android/windows/dashboard| LOW | auth lock/approval screen | iOS Lock Screen / passcode / device-approval sheet feel. | login-screen.tsx = centered glass card (rounded-2xl bg-card/80) full-screen over wallpaper; device-approval (pending + copy device-id) flow is solid. Reasonable but generic, not iOS-lock-shaped — AND unscopable to iOS (see guard/essence). |**Steps:**-1. Honor the home indicator in image-editor's compact bottom sheet: add [padding-bottom:var(--sai-bottom)] to the shared ScrollArea tab panels (Props/Adjust/Effects/Export) and to the AI panel's own scroll foot so their last row clears the 34px pill, matching what Layers already does via layers-footer. No shell branch needed — the var is 0 off-iOS. — `/home/rahman/projects/os-vps/frontend/slices/image-editor/components/mobile-shell.tsx (+ verify panels/ai-panel.tsx bottom, panels/export-panel.tsx)` *(~4-8 LOC)*-2. Honor the home indicator in reel-editor's compact layout: pad the CompactPanes bottom (the bottom-most compact element per reel-panes.tsx) by var(--sai-bottom). Same var-is-the-seam property (0 elsewhere). — `/home/rahman/projects/os-vps/frontend/slices/reel-editor/components/compact-panes.tsx` *(~2-4 LOC)*-3. On iOS only, present reel Settings as a bottom sheet: gate on useActiveShell().id==="ios" (import from @/features/appshell) — render the SAME fields inside a rounded-top-[20px] solid bg-popover/--elev sheet with a 36x5 grabber, medium height, pb var(--sai-bottom); reuse the existing appshell share-sheet primitive or a minimal inline one. Non-iOS keeps today's Dialog byte-for-byte. — `/home/rahman/projects/os-vps/frontend/slices/reel-editor/components/settings-dialog.tsx` *(~25-45 LOC)*-4. On iOS only (useActiveShell().id==="ios"), wrap create-app's row-shaped fields (Name/Runtime/Entry/Accent) in a grouped inset card — bg-card rounded-xl (12px), .5px --sep hairlines inset 16px, ~11px 16px rows — on a --surface/muted grouped page; keep Glyph grid + manifest code as separate labelled sections (named non-fit). Uses existing tokens (--card/--surface/--sep), no new --grouped token. Non-iOS branch renders today's flat form unchanged. — `/home/rahman/projects/os-vps/frontend/slices/create-app/app.tsx (+ optional components/ios-form.tsx to stay <200 lines)` *(~40-70 LOC)*-5. OPTIONAL/low: give the Segmented selected option an iOS white-raised-pill look scoped to iOS — add a stable data-attr (e.g. data-seg) to the shared primitive, then a [data-shell="ios"] block in globals.css overriding selected to bg-card/shadow on a --fill r9 track. The [data-shell="ios"] scope by construction cannot match android/windows/macos/dashboard. — `/home/rahman/projects/os-vps/app/globals.css (+ 1 attr in /home/rahman/projects/os-vps/components/ui/segmented.tsx)` *(~8-14 LOC CSS + 1 attr)*-6. OPTIONAL/low: on iOS, make the reel Toolbar solid (--card instead of bg-background/60, per Golden Rule 2 no faux-glass-over-canvas) and bump its icon buttons to a 44pt target. Gate on useActiveShell().id==="ios" or fold into a [data-shell="ios"] CSS override. — `/home/rahman/projects/os-vps/frontend/slices/reel-editor/components/toolbar.tsx` *(~4-8 LOC)*+1. Honor the home indicator in image-editor's compact bottom sheet: add [padding-bottom:var(--sai-bottom)] to the shared ScrollArea tab panels (Props/Adjust/Effects/Export) and to the AI panel's own scroll foot so their last row clears the 34px pill, matching what Layers already does via layers-footer. No shell branch needed — the var is 0 off-iOS. — `/home/rahman/projects/mso/frontend/slices/image-editor/components/mobile-shell.tsx (+ verify panels/ai-panel.tsx bottom, panels/export-panel.tsx)` *(~4-8 LOC)*+2. Honor the home indicator in reel-editor's compact layout: pad the CompactPanes bottom (the bottom-most compact element per reel-panes.tsx) by var(--sai-bottom). Same var-is-the-seam property (0 elsewhere). — `/home/rahman/projects/mso/frontend/slices/reel-editor/components/compact-panes.tsx` *(~2-4 LOC)*+3. On iOS only, present reel Settings as a bottom sheet: gate on useActiveShell().id==="ios" (import from @/features/appshell) — render the SAME fields inside a rounded-top-[20px] solid bg-popover/--elev sheet with a 36x5 grabber, medium height, pb var(--sai-bottom); reuse the existing appshell share-sheet primitive or a minimal inline one. Non-iOS keeps today's Dialog byte-for-byte. — `/home/rahman/projects/mso/frontend/slices/reel-editor/components/settings-dialog.tsx` *(~25-45 LOC)*+4. On iOS only (useActiveShell().id==="ios"), wrap create-app's row-shaped fields (Name/Runtime/Entry/Accent) in a grouped inset card — bg-card rounded-xl (12px), .5px --sep hairlines inset 16px, ~11px 16px rows — on a --surface/muted grouped page; keep Glyph grid + manifest code as separate labelled sections (named non-fit). Uses existing tokens (--card/--surface/--sep), no new --grouped token. Non-iOS branch renders today's flat form unchanged. — `/home/rahman/projects/mso/frontend/slices/create-app/app.tsx (+ optional components/ios-form.tsx to stay <200 lines)` *(~40-70 LOC)*+5. OPTIONAL/low: give the Segmented selected option an iOS white-raised-pill look scoped to iOS — add a stable data-attr (e.g. data-seg) to the shared primitive, then a [data-shell="ios"] block in globals.css overriding selected to bg-card/shadow on a --fill r9 track. The [data-shell="ios"] scope by construction cannot match android/windows/macos/dashboard. — `/home/rahman/projects/mso/app/globals.css (+ 1 attr in /home/rahman/projects/mso/components/ui/segmented.tsx)` *(~8-14 LOC CSS + 1 attr)*+6. OPTIONAL/low: on iOS, make the reel Toolbar solid (--card instead of bg-background/60, per Golden Rule 2 no faux-glass-over-canvas) and bump its icon buttons to a 44pt target. Gate on useActiveShell().id==="ios" or fold into a [data-shell="ios"] CSS override. — `/home/rahman/projects/mso/frontend/slices/reel-editor/components/toolbar.tsx` *(~4-8 LOC)***Guard (android/windows/dashboard):** Two iOS-only seams, both proven available to these apps because Surface (frontend/slices/appshell/components/desktop.tsx) sets data-shell={id} AND wraps children in <ActiveShellProvider>: (1) React useActiveShell().id===\"ios\" (imported via the @/features/appshell barrel — the exact seam os-settings uses) for structural branches (steps 3,4,6) — the non-iOS branch renders today's tree byte-for-byte, so macOS/Windows/Dashboard/Android are unchanged; (2) [data-shell=\"ios\"] CSS (step 5) — android/windows/macos/dashboard are sibling selectors that cannot match. Steps 1-2 don't even need a branch: they only ADD padding by var(--sai-bottom), which the iOS shell raises to 34px inside its own <main> but which stays 0 on every other surface (no home indicator), so those personas are numerically unchanged. Critically, NONE of these edits touch the shared appshell chrome (mobile-shell.tsx/desktop.tsx), the shared window store, or android/windows/dashboard shell code — every file is inside the target slices, plus one scoped globals.css block. The compact-detection the editors already use (useIsMobile/useContainer) is left alone; iOS-only work is gated on the shell seam, never on `compact` (which would leak to Android and to narrow desktop windows).@@ -598,7 +598,7 @@ Every agent independently confirmed these. They are **deliberate**, not gaps —3. **Control Center = real toggles only** — no brightness/volume/wifi/airplane/AirDrop modules (nosuch hardware on a headless VPS).4. **No cross-app nav contract.** The Files floating tab bar and per-app nav trailing actions- (share/compose/trash) need a shell↔app tab/action contract; os-vps apps surface actions in their+ (share/compose/trash) need a shell↔app tab/action contract; mso apps surface actions in theirown in-content toolbars. Skip *(system-monitor's optional nav-action slot is the one place torevisit if wanted)*.5. **Files "search" filters loaded entries client-side** — never a dead cosmetic pill, never a new@@ -623,7 +623,7 @@ Every agent independently confirmed these. They are **deliberate**, not gaps —2. **After any SHARED-primitive edit** (Switch/Segmented/`.glass`/tokens): re-seed and screenshot**android + windows + dashboard + macOS** too, confirming byte-identical chrome (the guard's whole claim).3. `pnpm typecheck` + `eslint` clean; **full vitest green** (currently 682).-4. `pnpm build && sudo systemctl restart os-vps.service`; health-check root 200.+4. `pnpm build && sudo systemctl restart mso.service`; health-check root 200.5. Ship per the auto-ship flow (stage only the touched slice files; `fs-zip` WIP + `mock-os/` import stay unstaged).---@@ -767,10 +767,10 @@ Owner asked to ensure BOTH desktop (macOS) and mobile (iOS) carry all the mock's**Remaining = documented OPTIONAL (real mock features, low ROI — owner can request):** macOS menu **roving open-on-hover** — *attempted (self-registering `useId` roving context + `modal={false}` + functional-updater to beat the close/switch race) and **reverted**: hand-rolled controlled-DropdownMenu roving stays racy and couldn't be verified in the harness; a clean version needs the `@radix-ui/react-menubar` primitive (a new dep). Menus work via click (Radix a11y-complete), so this is polish, not a functional gap.* Also (purely decorative, audit's lowest): dock launch-bounce, rich file-type thumbnails, iOS Files name-pill tile + in-content folder-name large title. *(Both the desktop Control Center popover (Batch C) and the context-menu shortcut/danger column (Batch D) from earlier drafts of this list are now **done** — see below.)*-**Batch D — context-menu shortcut hints + destructive red (shipped 2026-07-15).** The `MenuItem` type gained `shortcut?` + `danger?`; the shell context-menu render shows a right-aligned macOS keyboard hint and paints destructive rows in system red (`--destructive-text`). Populated: window title-bar menu (Close **⌘W**, Minimize **⌘M**); desktop-icon + widget **Remove** → red. Verified: Close row renders "Close ⌘W"; Remove color = `rgb(255,95,87)`. Additive (`shortcut`/`danger` optional) → every other menu unchanged. **Essence-skips the audit CONFIRMED (NOT gaps):** the mock's macOS Control Center brightness/volume/wifi/bt/AirDrop/mirroring sliders, status-bar wifi/battery, and Apple-menu Sleep/Restart/Shut Down are all **fabricated hardware** os-vps correctly omits.+**Batch D — context-menu shortcut hints + destructive red (shipped 2026-07-15).** The `MenuItem` type gained `shortcut?` + `danger?`; the shell context-menu render shows a right-aligned macOS keyboard hint and paints destructive rows in system red (`--destructive-text`). Populated: window title-bar menu (Close **⌘W**, Minimize **⌘M**); desktop-icon + widget **Remove** → red. Verified: Close row renders "Close ⌘W"; Remove color = `rgb(255,95,87)`. Additive (`shortcut`/`danger` optional) → every other menu unchanged. **Essence-skips the audit CONFIRMED (NOT gaps):** the mock's macOS Control Center brightness/volume/wifi/bt/AirDrop/mirroring sliders, status-bar wifi/battery, and Apple-menu Sleep/Restart/Shut Down are all **fabricated hardware** mso correctly omits.---*Compiled 2026-07-15 from a 19-agent audit (`ios-parity-audit`, 1.6M tokens). SSOT verified against`mock-os/Apple-clone-app/{shared/theme.js,shared/config.js,support.js}` + the `.dc.html` screens.-This is the extraction contract: **mock → os-vps iOS surface only**, everything else held constant.*+This is the extraction contract: **mock → mso iOS surface only**, everything else held constant.*diff --git a/docs/MANAGED-APPS.md b/docs/MANAGED-APPS.mdindex 108db665..02400b1a 100644--- a/docs/MANAGED-APPS.md+++ b/docs/MANAGED-APPS.md@@ -150,7 +150,7 @@ it stops double-clicks and makes `starting` observable, nothing more. On top of`rateLimited("managed-app:<id>", 12, 60_000)` (`[id]/route.ts:23`) — fixed-window, **per app**.**Audit**: each action appends `managed-app.action` with `target=<id>`, `detail=<action>`, `ok` and-`actor` (the approved device id from the session, via `getSessionActor()`) to `~/.os-vps/audit.log`.+`actor` (the approved device id from the session, via `getSessionActor()`) to `~/.mso/audit.log`.Long operations are logged **twice**: the route writes the launch (`detail=update.<action>` +`meta.jobId` + `meta.argv`), and `job-audit.ts` writes the outcome (`detail=job.<kind>.<status>` +`meta.jobId/exitCode/error`) — matched on `jobId`, and the actor is carried across by@@ -238,7 +238,7 @@ they do not boot at all. That is the whole security problem:control in the same run that *does* break through.Hence the **origin split**: each dashboard is served from its own host-(`hermes.os.rahmanef.com`, `openclaw.os.rahmanef.com`) pointed at this same process. One host+(`hermes.mso.rahmanef.com`, `openclaw.mso.rahmanef.com`) pointed at this same process. One host*per app*, never one shared host — a shared one would put Hermes and OpenClaw back in a singleorigin where they can script each other (`origin.ts:12`).@@ -247,8 +247,8 @@ app a request belongs to and `X-Forwarded-Host` is deliberately ignored, becauseto claim the cockpit host while on an app host would escape the rewrite (`proxy.ts:112`). On anapp host **every path** is rewritten into that app's proxy (`:146`), so `/api/v1/exec/run` doesnot exist there, and `/_next/*` 404s (`:129`). A host **inside the namespace that is not an app**-also 404s (`:121`, `origin.ts:71`): the session cookie is widened to `os.rahmanef.com`, so a new-`X.os.rahmanef.com` record must not be able to serve an authenticated cockpit — the parent name+also 404s (`:121`, `origin.ts:71`): the session cookie is widened to `mso.rahmanef.com`, so a new+`X.mso.rahmanef.com` record must not be able to serve an authenticated cockpit — the parent nameis never matched, so this cannot lock the operator out. The rewrite stamps`x-os-managed-app-host` and **deletes any inbound copy** on every request (`:132`, `:182`,`:196`); the route trusts it only in split mode (`route.ts:92`), since forged it would buy@@ -283,7 +283,7 @@ it, and the tighter side wins. Rules that matter:inject `<base href>`. Upstream **hashes** are copied in, upstream **nonces** never are: a noncematches a script element whatever its URL, re-opening the origin scoping (`proxy-csp.ts:134`).- An external `https:` host the upstream **declares** is honoured (its own UI needs it), with no- wildcards and **never the cockpit origin** (`:174`) — `connect-src https://os.rahmanef.com` out+ wildcards and **never the cockpit origin** (`:174`) — `connect-src https://mso.rahmanef.com` outof a compromised upstream is the thing scoping exists to stop. Hosts that *nothing* grants aredisclosed in the window rather than failing silently (`proxy-headers.ts:228`).@@ -305,7 +305,7 @@ So there is exactly one supported mode:| | origin-split (the only mode) ||---|---|| trigger | `NEXT_PUBLIC_MANAGED_APP_HOST_TEMPLATE` contains `{id}` |-| iframe `src` | `https://<id>.os.rahmanef.com/<route>` — the app owns its host root |+| iframe `src` | `https://<id>.mso.rahmanef.com/<route>` — the app owns its host root || document rewriting | none — the upstream's own URLs resolve as shipped || cookie `Path` | `/`, namespaced to the app host || `window.top` reach | opaque (cross-origin) |@@ -318,12 +318,12 @@ cockpit-origin path proxy as a convenience.**Live verification (unauthenticated, so 401 is the expected success signal):```-H=hermes.os.rahmanef.com # no trailing slash on the proxy URL: Next 308s it away first+H=hermes.mso.rahmanef.com # no trailing slash on the proxy URL: Next 308s it away firstcurl -sI -H "Host: $H" 127.0.0.1:4005/ # 401 + frame-ancestors 'self' <cockpit>curl -s -H "Host: $H" 127.0.0.1:4005/_next/static/x.js # 404 — /_next is cockpit-onlycurl -s -X POST -H "Host: $H" 127.0.0.1:4005/api/v1/exec/run # 403 cross_origin_blocked-curl -s -H 'Host: staging.os.rahmanef.com' 127.0.0.1:4005/ # 404 — unclaimed namespace host-curl -s -H 'Host: os.rahmanef.com' 127.0.0.1:4005/api/v1/managed-apps/hermes/proxy # 401; 404 signed in+curl -s -H 'Host: staging.mso.rahmanef.com' 127.0.0.1:4005/ # 404 — unclaimed namespace host+curl -s -H 'Host: mso.rahmanef.com' 127.0.0.1:4005/api/v1/managed-apps/hermes/proxy # 401; 404 signed in```Residual, by design: the proxy is **HTTP only** — a route handler cannot service an `Upgrade` — so@@ -333,7 +333,7 @@ view instead (`feature-cli.ts:41`, `:60`). The `connect-src` residual is §8.8.## 6. Backup`backup` (`manager.ts:141`) copies the app's state dir recursively, timestamps preserved, to-`~/.os-vps/backups/<id>/<ISO-stamp>/` (parent `0700`), then writes `manifest.json` (`0600`)+`~/.mso/backups/<id>/<ISO-stamp>/` (parent `0700`), then writes `manifest.json` (`0600`)containing `{applicationId, createdAt, source, skipped: {symlinks, dirs, dirNames}}`. The source is`expandHome(homeDir)` when the catalog has one, else `homedir() + stateDirName` — so a Hermesinstall relocated with `HERMES_HOME` is what actually gets copied.@@ -353,7 +353,7 @@ inside pruned trees and are never reached, so those are the order of `skipped.sy`du -sh --exclude=node_modules --exclude=.venv --exclude=venv --exclude=__pycache__ --exclude=.git--exclude=.cache --exclude=backups ~/.hermes ~/.openclaw` gives the size: **366 MB** and **237 MB**,-against 2.7 GB and 1.7 GB unexcluded, with 227 GB free on `/home` (`df -h /home`). `~/.os-vps/backups/`+against 2.7 GB and 1.7 GB unexcluded, with 227 GB free on `/home` (`df -h /home`). `~/.mso/backups/`is created by the first run; this host has one snapshot per app, from the first real backup runs.`manager.test.ts` covers the shape in a fixture home: state files copied, `node_modules/` and `backups/`absent, an `/etc/passwd` symlink neither followed nor recreated, manifest counters as claimed.@@ -363,9 +363,9 @@ absent, an `/etc/passwd` symlink neither followed nor recreated, manifest counteEverything destructive is a **job** (`jobs.ts` + `job-runner.ts` + `job-store.ts`): the POST startsone and returns an id, the client polls `/jobs/<id>?since=`. A route handler cannot hold an`openclaw update` open — upstream's own default step timeout is 1800 s and it restarts services on-the way out. The child is spawned by this process and **dies with it** (`os-vps.service` is+the way out. The child is spawned by this process and **dies with it** (`mso.service` is`KillMode=control-group`, `Delegate=no`, so `detached` buys a process group, never a cgroup); the-durable part is the record under `~/.os-vps/managed-app-jobs/` (0700 dir, 0600 files), and a job+durable part is the record under `~/.mso/managed-app-jobs/` (0700 dir, 0600 files), and a jobwhose owner pid is gone — or which stopped heart-beating for 45 s — reconciles to `interrupted`rather than sitting at `running` and stranding the lock. **Do not deploy while an update runs.**@@ -420,7 +420,7 @@ leave a broken install; so files created since the snapshot stay, and the result| Var | Read at | Notes ||---|---|---|-| `NEXT_PUBLIC_MANAGED_APP_HOST_TEMPLATE` | **build** (client) + runtime (server, middleware) | e.g. `{id}.os.rahmanef.com`. Presence of `{id}` is what turns split mode on |+| `NEXT_PUBLIC_MANAGED_APP_HOST_TEMPLATE` | **build** (client) + runtime (server, middleware) | e.g. `{id}.mso.rahmanef.com`. Presence of `{id}` is what turns split mode on || `OS_SESSION_COOKIE_DOMAIN` | runtime | adds `Domain=` so the session reaches the app hosts (`lib/auth/session-cookie.ts:68`) || `OS_PUBLIC_ORIGIN` | runtime | the origin named in `frame-ancestors` and used to scope the policy; unset falls back to the template's parent, and a value that resolves to nothing fails closed to `frame-ancestors 'none'`. The `HERMES_*` / `OPENCLAW_*` vars (§2) are runtime too |@@ -432,16 +432,16 @@ app hosts that 401 on every request.**Deploy order** — forced by the build-time/runtime split:1. DNS for `hermes.os.…` and `openclaw.os.…`, then the Traefik router- (`/etc/dokploy/traefik/dynamic/os-vps-managed-apps.yml`: one `web` + one `websecure` router per host,- `service: os-vps-service`, `certResolver: letsencrypt`; that shared service forwards to+ (`/etc/dokploy/traefik/dynamic/mso-managed-apps.yml`: one `web` + one `websecure` router per host,+ `service: mso-service`, `certResolver: letsencrypt`; that shared service forwards to`http://172.17.0.1:4005` with `passHostHeader: true`, which is why middleware can trust `Host`).2. Set both env vars in `.env.local`.3. `pnpm build` — `NEXT_PUBLIC_*` is baked into the client bundle here. Built without it, thebrowser still points at the old same-origin URL the server has stopped answering, and thewindow comes up blank.-4. `sudo systemctl restart os-vps.service` — never restart before building (`CLAUDE.md`).+4. `sudo systemctl restart mso.service` — never restart before building (`CLAUDE.md`).-**Verify** with the curls in §5, plus `https://hermes.os.rahmanef.com/` → `401` unauthenticated and the+**Verify** with the curls in §5, plus `https://hermes.mso.rahmanef.com/` → `401` unauthenticated and thedashboard rendering in an app window when signed in. Both app hosts resolve to the cockpit's own A/AAAA.**Turning the feature OFF** (there is no "roll back to single-origin" any more — that mode wasdiff --git a/docs/MODELS-INTEGRATION.md b/docs/MODELS-INTEGRATION.mdindex 63969be6..9eb77656 100644--- a/docs/MODELS-INTEGRATION.md+++ b/docs/MODELS-INTEGRATION.md@@ -1,10 +1,10 @@-# @rahmanef/models → os-vps AI integration+# @rahmanef/models → mso AI integration**Status: first slice SHIPPED + verified (2026-07-15).** Designed by a 3-agent workflow(`models-integration-design`) that mapped both codebases; grounded against live code.## What it does-os-vps's AI (the **Alfa** assistant) now resolves its model + BYOK key + host-gated+mso's AI (the **Alfa** assistant) now resolves its model + BYOK key + host-gatedendpoint through the vendored **`@rahmanef/models`** registry (`resolveModel()`),instead of a single hardcoded Anthropic key. Multi-provider, single-owner, self-contained.@@ -13,11 +13,11 @@ instead of a single hardcoded Anthropic key. Multi-provider, single-owner, self-the src is **zero-dep ESM** (`node:` builtins + relative imports only), so it drops in with**0 new npm deps** and no install-graph/deploy risk. Server-only (reads `node:fs`/env — neverimport from a client component). *Sync from `models-rahmanef-com/src/*.js` when it updates.*-- **`resolveModel()` only, not `chat()`** — the lib's `chat()` returns buffered JSON; os-vps+- **`resolveModel()` only, not `chat()`** — the lib's `chat()` returns buffered JSON; msostreams SSE. So we use the lib for key + **host-gate** (a provider's key is pinned to its own`baseUrl`, can't be redirected) + model + protocol, and **keep the Anthropic SDK** for the stream.- **`hostCredentialStore()`** (`lib/config/store.ts`) implements the lib's `CredentialStore` over the- existing **0600 `~/.os-vps/config.json`**, per-provider, with the env chain (`ANTHROPIC_API_KEY`…)+ existing **0600 `~/.mso/config.json`**, per-provider, with the env chain (`ANTHROPIC_API_KEY`…)as fallback. Single-owner → `tenantId` ignored. Legacy `anthropicApiKey` stays a read alias →**existing installs migrate for free**.- **No new cloud/Convex** — reuses the host config file. Essence intact.@@ -48,7 +48,7 @@ in `.env.local`) Alfa streams via the resolved provider/model. Build bundles thesession-gated, `listModels()` from the offline-tolerant models.dev cache) + a provider `<Select>`in `ai-section.tsx` (8 curated providers) with catalog-backed free-text model suggestions(`<datalist>`, so an id absent from the catalog still works offline). `config/route.ts` +- `store.ts` already persisted keys per-provider → unchanged. (Optional: `MODELS_CACHE_DIR=~/.os-vps/models-cache`.)+ `store.ts` already persisted keys per-provider → unchanged. (Optional: `MODELS_CACHE_DIR=~/.mso/models-cache`.)- **Verified live:** `/api/models?provider=openai` → 56 models; picker lists Anthropic / OpenAI /OpenRouter / Google / Groq / xAI / DeepSeek / Mistral; Alfa streams via the resolved provider oncea key is set (Settings → AI or the provider env var).diff --git a/docs/OPENCLAW-INTEGRATION.md b/docs/OPENCLAW-INTEGRATION.mdindex b7f92ee4..18c815ad 100644--- a/docs/OPENCLAW-INTEGRATION.md+++ b/docs/OPENCLAW-INTEGRATION.md@@ -42,7 +42,7 @@ view.| State dir | `~/.openclaw` (1.7 GB — **separate from the install**, unlike Hermes) | `catalog.ts:37`, `du -sh` || Gateway port | `18789`, bound `0.0.0.0` (because `gateway.bind: "lan"`) | `ss -tlnp`, `~/.openclaw/openclaw.json` || Public today | **yes** — `oc.rahmanef.com` (`200`) | `/etc/dokploy/traefik/dynamic/oc-openclaw.yml` → `http://172.17.0.1:18789`, `passHostHeader: true` |-| MSO app host | `openclaw.os.rahmanef.com` → os-vps `:4005` → proxy → `127.0.0.1:18789` | `os-vps-managed-apps.yml`, `curl` in §5 |+| MSO app host | `openclaw.mso.rahmanef.com` → mso `:4005` → proxy → `127.0.0.1:18789` | `mso-managed-apps.yml`, `curl` in §5 |One **user** systemd unit, `~/.config/systemd/user/openclaw-gateway.service`. There is nosystem-scope unit, and no `openclaw.service` — that name does not exist on this host, which is why@@ -163,7 +163,7 @@ HTTP/1.1 101 Switching ProtocolsThe upgrade is **not** origin-gated: it returns the same `101` and challenge with `Origin:https://evil.example`, and gates at the protocol layer instead. `allowedOrigins` and`allowInsecureAuth` govern the Control UI's own checks — and that allowlist names-`oc.rahmanef.com` only, **not** `openclaw.os.rahmanef.com`. Costs nothing today (no socket+`oc.rahmanef.com` only, **not** `openclaw.mso.rahmanef.com`. Costs nothing today (no socketcrosses the proxy); first thing to add if a socket proxy lands.**Where the token lives client-side.** The SPA reads it from the URL **fragment**@@ -175,7 +175,7 @@ query parameter (?token=). Use URL fragment instead: #token=<token>. Query paramappear in server logs."* The supported way to get a URL is `openclaw dashboard --no-open`.**MSO never mints, reads or injects that token.** `featureSource()` (`feature-cli.ts:102`)-builds the iframe `src` as `https://openclaw.os.rahmanef.com/<route>` — origin plus path, no+builds the iframe `src` as `https://openclaw.mso.rahmanef.com/<route>` — origin plus path, nofragment — and nothing in `lib/managed-apps/` reads `openclaw.json` (grep: the only upstreamreads are the control-UI assets and the gateway's HTTP surface). So the framed SPA starts with**no gateway token** — the second independent reason its panels are empty (§4 is the first).@@ -212,7 +212,7 @@ is `'none'` too (§5), so it is closed twice.**Every panel in the Control UI is driven by the gateway WebSocket.** The client builds its URLfrom `location` — `${https ? 'wss' : 'ws'}://${location.host}<basePath>` — so on-`openclaw.os.rahmanef.com` it targets that host, which is os-vps. **A Next route handler cannot+`openclaw.mso.rahmanef.com` it targets that host, which is mso. **A Next route handler cannotservice an `Upgrade`**: it is handed a `Request` and returns a `Response`, and the proxy'stransport is `fetch()`. So the frame loads its chrome, HTML, CSS and JS — and sits with no data.@@ -287,8 +287,8 @@ default-src O; script-src O 'sha256-xlWU9W5…' 'sha256-YE++OxiP…';style-src O 'unsafe-inline' https://fonts.googleapis.com; img-src O data: blob:;font-src O https://fonts.gstatic.com; media-src O data: blob:; worker-src 'none';connect-src O https://api.openai.com https://tweakcn.com; frame-src O; form-action O;-base-uri 'none'; frame-ancestors 'self' https://os.rahmanef.com; object-src 'none'- …where O = https://openclaw.os.rahmanef.com/+base-uri 'none'; frame-ancestors 'self' https://mso.rahmanef.com; object-src 'none'+ …where O = https://openclaw.mso.rahmanef.com/```Six things the intersection did, and why each is the right answer:@@ -297,7 +297,7 @@ Six things the intersection did, and why each is the right answer:|---|---|---|| `script-src` | lost `'unsafe-inline'`, gained OpenClaw's two `sha256-` | upstream grants no `'unsafe-inline'`, so the tighter side wins and its own inline scripts survive on the hashes it authored. Hashes copy, **nonces never** (`proxy-csp.ts:134`) — a nonce matches an element whatever its URL, re-opening origin scoping. Root-mounted MSO injects and pins nothing (`:233`); single-origin adds a third hash for its shim || `worker-src` | `'none'` | ours `blob:`-only ∩ theirs `'self'` = ∅ — this is what stops §4's service worker outliving the window |-| `connect-src` | kept `api.openai.com`, `tweakcn.com`; dropped bare `ws:`/`wss:` | a host the upstream *declares* is honoured, but only `https://`, no wildcards, and **never the cockpit** (`:174`) — `connect-src https://os.rahmanef.com` from a compromised upstream is the reach scoping removes. This is not what kills its own socket — §4's missing `Upgrade` is: nothing on the app host answers one, so no `wss://` request is ever made for a policy to judge. What is gone is a socket to any *other* host |+| `connect-src` | kept `api.openai.com`, `tweakcn.com`; dropped bare `ws:`/`wss:` | a host the upstream *declares* is honoured, but only `https://`, no wildcards, and **never the cockpit** (`:174`) — `connect-src https://mso.rahmanef.com` from a compromised upstream is the reach scoping removes. This is not what kills its own socket — §4's missing `Upgrade` is: nothing on the app host answers one, so no `wss://` request is ever made for a policy to judge. What is gone is a socket to any *other* host || `style-src`, `font-src` | kept `fonts.googleapis.com`, `fonts.gstatic.com` | declared upstream, so honoured — OpenClaw keeps its webfonts where Hermes, declaring nothing, does not || `base-uri` | `'none'` honoured | root-mounted nothing injects `<base href>`, so upstream's stricter value can win (`:104`); single-origin ours must win or relative URLs escape the prefix || `frame-ancestors` | overridden to `'self' <cockpit>` | always ours — being framed by the cockpit is the point. The origin is deployment env only (`origin.ts:101`); resolving to nothing emits `'none'`, so a misconfiguration refuses visibly instead of naming a guessed framer |@@ -308,8 +308,8 @@ blocked in OpenClaw's own deployment too. It is the one OpenClaw entry in`PROXY_BLOCKED_EXTERNALS` (`proxy-headers.ts:228`) and the window says *"The Gemini live-audiosocket in chat cannot connect."*-Live, unauthenticated, `curl -sI https://openclaw.os.rahmanef.com/` returns `401` with-`content-security-policy: default-src 'none'; frame-ancestors 'self' https://os.rahmanef.com`+Live, unauthenticated, `curl -sI https://openclaw.mso.rahmanef.com/` returns `401` with+`content-security-policy: default-src 'none'; frame-ancestors 'self' https://mso.rahmanef.com`and `x-middleware-rewrite: /api/v1/managed-apps/openclaw/proxy` — the host gating and theframing grant both working, before auth. Full verification set:[MANAGED-APPS.md §5](./MANAGED-APPS.md).diff --git a/docs/PROGRESS.md b/docs/PROGRESS.mdindex 30a87bd0..f267215e 100644--- a/docs/PROGRESS.md+++ b/docs/PROGRESS.md@@ -1,10 +1,10 @@-# os-vps — Progress Log+# mso — Progress LogRunning log of what shipped each phase. Newest at top.> **Architecture note:** Phases 0–14 below were built on **Convex self-hosted +> a Control-Room host-agent bridge**. That stack was **removed** in Phase 15 —-> os-vps is now a self-contained Next.js app (`lib/host` + signed-cookie auth).+> mso is now a self-contained Next.js app (`lib/host` + signed-cookie auth).> Read those phases as history. **This file is the source of truth for what exists** —> `ARCHITECTURE.md` is no longer maintained and carries a stale-warning banner.@@ -112,7 +112,7 @@ win that costs a 258 KB lockfile regeneration on the eve of a release).Deleted docs and trees are recoverable with `git show bccd0b1:<path>`; the untracked ones —`mock-os/Apple-clone-app/`, `public/MSO_Brand_Assets_Current/`, 13 one-shot June probe-scripts — are in `~/archive/os-vps-cleanup-2026-07-30/`, since git could never bring those+scripts — are in `~/archive/mso-cleanup-2026-07-30/`, since git could never bring thoseback. Net: 1,047 → 930 tracked files, −6.3k lines, −9 MB. typecheck + lint + 1,095 tests +build + cycles + slices green.@@ -268,7 +268,7 @@ per-call approval card is a better lock); the `Skill` → `Playbook` rename; wirMSO becomes the **control plane** for applications that stay separate. Hermes and OpenClaw keeptheir own runtime, config, data, versions, health, logs and backups; nothing is copied, forked ormerged into this repo, no DOM is scraped, and nothing under `~/.hermes/` or `~/.openclaw/` is ever-written — the only writes land in `~/.os-vps/`. Everything goes through their own CLIs, their own+written — the only writes land in `~/.mso/`. Everything goes through their own CLIs, their ownloopback HTTP surfaces, and systemd/docker. Shipped as `c411187` → `52cfff5` → `0feaab4` →`5b4b5c9` → `d1fbd85` → `c597d08` → `d880f68`. (`3b45b8e`, same session, closed an unrelatedhole: the camoufox VNC rewrite was gated only by the *presence* of a cookie named `session`, so it@@ -281,11 +281,11 @@ is commented out and answers 403 until a real check can run in the nodejs middle`shell: false`, argv arrays, 128 KB cap, timeouts — no string ever reaches a shell). Four routesunder `/api/v1/managed-apps`, every one `verifyAuth()` first; actions are demo-blocked,rate-limited 12/min and audited as `managed-app.action`. Backup copies `~/<stateDir>` into- `~/.os-vps/backups/<id>/<stamp>/` and (as first shipped) refused a tree containing symlinks —+ `~/.mso/backups/<id>/<stamp>/` and (as first shipped) refused a tree containing symlinks —replaced later this phase, see the fix bullet; logs are journalctl / `docker logs` withbearer/token/secret/password redaction.- **Workspace modes + real feature discovery** — **REVERSED in `a2c3882`, all of this is deleted.** (`52cfff5`, `0feaab4`, `5b4b5c9`) — `plain | hermes- | openclaw` in `localStorage` (`os-vps:workspace-mode`), orthogonal to Shell Style, with a+ | openclaw` in `localStorage` (`mso:workspace-mode`), orthogonal to Shell Style, with aright-click Workspace submenu on all five shells sharing one store with the Dashboard select.Each app's navigation is parsed from **its own installed bundle + plugin API**, not hard-coded:Hermes 18 nav entries + 2 plugin tabs (verified against `web_dist/assets/index-*.js` and@@ -293,7 +293,7 @@ is commented out and answers 403 until a real check can run in the nodejs middleoffered (`workboard`/`plugin` are flag-gated → `available:false`). 60 s cache, min-length parseguard, and an unreachable upstream yields nothing rather than tiles that 404.- **Proxy hardening** (`5b4b5c9`, `c597d08`) — upstream must be loopback; cookies namespaced- `mapp_<id>_` and pinned to the mount so the os-vps `session` never crosses; `authorization` /+ `mapp_<id>_` and pinned to the mount so the mso `session` never crosses; `authorization` /`www-authenticate` never relayed; off-origin redirects refused (open redirect **and** a CSPpath-matching bypass); upstream service workers 404'd; request bodies counted as they stream(a chunked body has no `content-length`); route errors carry `frame-ancestors` or the browser@@ -307,7 +307,7 @@ is commented out and answers 403 until a real check can run in the nodejs middleon the cockpit origin that made upstream JS same-origin *with the cockpit*: `window.top.fetch`→ `/api/v1/exec/run` with the user's session, which no CSP can stop (a policy binds a realm, nota reference across realms). Each dashboard now has its **own host on this same process**- (`{id}.os.rahmanef.com`, DNS + `/etc/dokploy/traefik/dynamic/os-vps-managed-apps.yml`), so+ (`{id}.mso.rahmanef.com`, DNS + `/etc/dokploy/traefik/dynamic/mso-managed-apps.yml`), so`window.top` is opaque — measured in Chromium 148, with a same-origin control that still breaksthrough. `proxy.ts` rewrites every path on an app host into that app's proxy and 404s the rest(matcher widened to `/(.*)`, CSRF check moved ahead of the rewrite, `Host` authoritative over@@ -318,7 +318,7 @@ is commented out and answers 403 until a real check can run in the nodejs middlewildcard (the widened cookie would make `new Image().src` an existence oracle). The sessioncookie gained an optional `Domain` and is cleared with **and** without it; `SameSite=Strict` isunchanged and still correct because the app hosts share the registrable domain.-- **Verified live**, not just unit-tested: `https://hermes.os.rahmanef.com/` and+- **Verified live**, not just unit-tested: `https://hermes.mso.rahmanef.com/` and`openclaw.…` answer over TLS with a valid cert; `/api/v1/exec/run` and `/api/v1/sys/stats` on anapp host come back as the proxy's own 401 with `x-middleware-rewrite:/api/v1/managed-apps/<id>/proxy/…` (the cockpit route is not reachable there); `staging.os.…`@@ -341,7 +341,7 @@ is commented out and answers 403 until a real check can run in the nodejs middlecorrectness. Live after the fix, both apps through the real `listManagedApps()`: `hermes | systemd| running | healthy=true | dash=true` and `openclaw | systemd | running | healthy=true |dash=true`. (2) **Backup** walked the tree and threw on the first symlink; `~/.hermes` has 58 and- `~/.openclaw` 2063, so the action failed for every real install and `~/.os-vps/backups/` was never+ `~/.openclaw` 2063, so the action failed for every real install and `~/.mso/backups/` was nevercreated (a success would have copied 2.7 GB + 1.7 GB). The guard is gone; `fs.cp` now takes afilter that skips `node_modules`/`.venv`/`venv`/`__pycache__`/`.git`/`.cache`/`backups` — the lastbeing the app's *own* 1.1 GB backup dir — and skips symlinks (neither followed, which would copy@@ -402,7 +402,7 @@ Alfa can now save facts to memory itself, not just via Settings: a `memory.rememhost-tool (read-tier — runs immediately, no approval card, since it's a benign owner-scopedwrite) that POSTs to `/api/memory`. One catalog entry (`host-tools/catalog.ts`) + a HOST_SYSTEMguidance line; the registry test covers it as a read tool. tsc + lint + vitest green. It-complements the manual Settings → Alfa memory panel (both write the same `~/.os-vps/memory.json`).+complements the manual Settings → Alfa memory panel (both write the same `~/.mso/memory.json`).**Not redeployed** — build + restart to activate.## 2026-07-16 (round 4) — Alfa chat history (YAML threads) + cross-session memory (DONE)@@ -412,13 +412,13 @@ tests) green. Store logic is unit-tested; the full UI click-through (send → peadd fact → Alfa recalls it) is best exercised on the deploy (it needs a real provider key to stream).- **Chat history** — Alfa was stateless; now every completed turn persists to a YAML thread under- `~/.os-vps/threads/` (`lib/ai/threads.ts` — path-jailed filenames, atomic write). `/api/threads`+ `~/.mso/threads/` (`lib/ai/threads.ts` — path-jailed filenames, atomic write). `/api/threads`(list/get/save/delete). A History drawer (`thread-list.tsx`) in the Alfa header lists saved chats;resume restores BOTH the display bubbles and the wire history so the chat continues; New startsfresh. Persistence factored into a `use-thread-persistence` hook. YAML (not JSON) per the owner'srequest — readable session files (`yaml` dep added).- **Cross-session memory** — durable facts recalled into Alfa's system prompt, matched to the latest- user turn by word overlap (`lib/ai/memory.ts`; `~/.os-vps/memory.json`). `/api/memory`+ user turn by word overlap (`lib/ai/memory.ts`; `~/.mso/memory.json`). `/api/memory`(list/add/delete). The assistant route recalls + injects for EVERY provider path (codex/anthropic/openai).- **Token savers** — Settings → AI → Output style: Normal / Caveman (terse) / Ponytail (lazy seniordev) → appended to the system prompt (`OsConfig.tokenSaver`).@@ -462,7 +462,7 @@ ChatGPT authorization to exercise.provider's key row + Test hide for OAuth providers.- **Caveats (documented):** Codex is a reverse-engineered CONSUMER endpoint — needs a ChatGPTPlus/Pro subscription, can break if OpenAI changes it, and is **chat-only (no Alfa tools)**.- Tokens are stored plaintext in the 0600 host file (os-vps's existing posture; at-rest+ Tokens are stored plaintext in the 0600 host file (mso's existing posture; at-restencryption is a later pass). **Not redeployed** — build + restart to activate.## 2026-07-16 — Shell action contract (drawer + OS menu) + BYOK add-provider (DONE)@@ -492,11 +492,11 @@ behaviorally verified on an isolated `:4011` dev server (prod never touched).- Guards: iOS/Android edits live in their single-mount shells; the desktop menu addition isadditive (empty actions → nothing renders); a null custom conn keeps built-ins registry-pinned→ macOS/Windows/Dashboard byte-unchanged. **Not redeployed** — `pnpm build` + `sudo systemctl- restart os-vps.service` to activate.+ restart mso.service` to activate.## 2026-06-15 — upload-DoS P0 closed (independent QA loop)-An independent QA `/loop` rated os-vps and shipped the one **P0 a parallel audit+An independent QA `/loop` rated mso and shipped the one **P0 a parallel auditsession missed** — an authenticated DoS in `/api/v1/fs/upload`. Both on `origin/main`:- **`b4b90c5`** — `fs/upload` no longer buffers every multipart part into RAM@@ -508,9 +508,9 @@ session missed** — an authenticated DoS in `/api/v1/fs/upload`. Both on `origigrow the buffer unbounded) + `lib/host/multipart.test.ts` (6 tests incl. bothbypass vectors). `tsc` clean, vitest 293 passing.-**Not redeployed** — `pnpm build` + `sudo systemctl restart os-vps.service` to+**Not redeployed** — `pnpm build` + `sudo systemctl restart mso.service` toactivate. The concurrent-session collision lesson from that handoff is now a standing-rule in `CLAUDE.md` ("only ONE session edits os-vps at a time"); the handoff note+rule in `CLAUDE.md` ("only ONE session edits mso at a time"); the handoff noteitself was deleted on 2026-07-28 once its remaining content had expired.## Where things stand (2026-06-11) — recovery anchor@@ -670,7 +670,7 @@ lib + security done by hand. Prod rebuilt + restarted.## 2026-06-10 (round 3) — Full upstream sync into rr: shell framework + every OS app slice (DONE)-- **rr (`resources`) is no longer "basic"** — the whole os-vps feature set is+- **rr (`resources`) is no longer "basic"** — the whole mso feature set isnow consumable from the catalog by any project (`npx rr add <slug>`):- **appshell 1.4.0** in rr = byte-synced to this repo's framework (AndroidMaterial-You rebuild, macOS dock behaviour, window store + snap geometry,@@ -680,7 +680,7 @@ lib + security done by hand. Prod rebuilt + restarted.notifications/control-center/widgets/clipboard/share/quick-look/shortcut-help/lock-screen) synced into rr's bundled `appshell/features/*`.- **Dashboard shell LIFTED into the framework** (rr bundles it; brand via- `useBrand`, stats via the capability seam) — os-vps keeps its consumer copy.+ `useBrand`, stats via the capability seam) — mso keeps its consumer copy.- **12 app slices upgraded** in rr via per-slice 3-way merges that keep rr'sself-contained `lib/host.ts` seams (mock adapters + `configure*()` for realwiring): browser (multitab/screencast/AI panel), os-terminal (exec emulator@@ -777,11 +777,11 @@ Phone testing surfaced the real gaps — everything below e2e-verified on prod- **Cross-device prefs sync** (`4b7cf04`): phone no longer boots to freshdefaults (wrong wallpaper/theme, empty quicklinks, mock mode). Appearance- tweaks + quicklinks persist to `~/.os-vps/prefs.json` (atomic 0600) via+ tweaks + quicklinks persist to `~/.mso/prefs.json` (atomic 0600) viasession-gated `/api/prefs` (mirrors `/api/config`). localStorage hydratesfirst, server wins on initial GET, changes debounce 1.5 s POST per section,last-write-wins. POSTs disabled until a GET succeeds (pre-auth defaults can- never clobber server prefs); login fires `os-vps:authed` to re-pull without a+ never clobber server prefs); login fires `mso:authed` to re-pull without areload. `wallpaperStyle` is computed → stripped both sides. Demo: zero calls.Device-specific state (window layout, clipboard, profiles, recents) stayslocal on purpose.@@ -797,7 +797,7 @@ Phone testing surfaced the real gaps — everything below e2e-verified on proddismiss → `replaceState("/")`, deep-link onto a minimized app restores it.Also covers the Android shell home button.- **Persisted layout vs deep links** (`29bc59b`, found by e2e): boot- `hydrate()` rebuilt the store from `os-vps:layout` AFTER UrlSync opened the+ `hydrate()` rebuilt the store from `mso:layout` AFTER UrlSync opened thedeep-linked window — returning devices got the grid or a stale URL rewrite.New `hydrateBoot()` merges (live windows keep id/payload/focus on top,persisted single-instance dupes drop, multi apps coexist via id remap);@@ -919,7 +919,7 @@ Lift-prep done (Phase F `ee2b7a9`): de-genericised appshell's last consumerliterals (persist key + idle name → manifest), de-Convex'd os-shell metadata,added trios. Capability injection done (Phase G `b16ac0a`): appshell core nolonger imports `@/lib/{appearance,os-api}` — appearance + CPU readout come via-`manifest.capabilities`; os-vps adapts its store/host in `os-shell/capabilities.ts`.+`manifest.capabilities`; mso adapts its store/host in `os-shell/capabilities.ts`.The framework core is now brand- AND consumer-free (only the universal `cn`helper remains). Verified behaviour-neutral (theme toggle, CPU chip, wallpaper,device detection, mobile surface all intact).@@ -928,7 +928,7 @@ Feature-slice capability injection done (`eb671fa`): the `shell-*` slices no lonimport `@/lib/*` either (except the universal `cn`). Their data deps now arrive via`ShellCapabilities` — `useSearch` (Spotlight → `SearchHit[]`), `useSystemStats`(Today widgets), `useChat` (scoped AI stream), `useServerToggle` (optional control--center server tile). os-vps wires the real `@/lib` sources in `os-shell/capabilities.ts`.+center server tile). mso wires the real `@/lib` sources in `os-shell/capabilities.ts`.The **entire shell** (core + features) is now consumer-free. Verified behaviour-neutral(Spotlight search + theme command, mobile Today telemetry "CPU 61% 8 cores").@@ -959,7 +959,7 @@ brought current. `MOBILE-RESPONSIVE-PLAN` flagged as not-yet-built (DRY primitivskips node_modules/.git/…) + `/api/v1/fs/search`; Spotlight opens apps AND folders.- **Rename pre-selects the name** (`37c699c`) — typing replaces, Finder-style.- **Demo FS persists to localStorage** (`2fee6a1`) — mock tree mirrored to- `os-vps:demo-fs` so a visitor's sandbox survives reload (structure, not bytes).+ `mso:demo-fs` so a visitor's sandbox survives reload (structure, not bytes).- **Whole-window drop zone** (`15ace18`) — the entire Files window is a drop target(drops on toolbar/padding no longer fall through to the browser), with a "Drop files& folders" overlay + Uploading/Uploaded toasts + a flat-file fallback.@@ -969,17 +969,17 @@ brought current. `MOBILE-RESPONSIVE-PLAN` flagged as not-yet-built (DRY primitiv## 2026-05-30 — Phase 15: Self-contained pivot + security + MSO rebrand (DONE)The big architecture change: **dropped Convex + the external Control-Room agent.**-os-vps now runs AS a host process and controls its own machine directly.+mso now runs AS a host process and controls its own machine directly.- **Self-contained host layer** — `lib/host/` (fs/exec/sys/paths) is the singlefacade for `/api/v1`; signed-cookie auth (`lib/auth/`, HMAC `OS_SESSION_SECRET` +password + device approval) replaced `@convex-dev/auth`. Layout/registry →- localStorage; device allowlist + BYOK config → `~/.os-vps/*.json`. No Convex, no agent.+ localStorage; device allowlist + BYOK config → `~/.mso/*.json`. No Convex, no agent.- **Security pass** (`4a293cd`) — append-only JSONL audit (`lib/host/audit.ts`,- `~/.os-vps/audit.log`); exec destructive-command guard (`rm -rf /`, mkfs, dd,+ `~/.mso/audit.log`); exec destructive-command guard (`rm -rf /`, mkfs, dd,fork bomb…) bypass via `OS_EXEC_ALLOW_DESTRUCTIVE`; exec rate-limit; tight defaultFS scope (read+write = home + ~/projects); 24h sessions; README threat model.-- **Rebrand os-vps → MSO** (`56b3707`) — dropped the "OS" overclaim in all+- **Rebrand mso → MSO** (`56b3707`) — dropped the "OS" overclaim in alluser-facing strings (it's a cockpit/utility, not an OS). Repo/service/domain slugunchanged.- **os-browser to loopback** — Playwright service rebound 127.0.0.1:4002 (was 0.0.0.0);@@ -995,10 +995,10 @@ the CLI, with a persistent session/cache so logins stick + no per-site API neede- **Host service** `os-browser` (new repo `/home/rahman/projects/os-browser`,systemd, loopback :4002, secret-gated): `chromium.launchPersistentContext`- (userDataDir `~/.os-vps/chrome-profile` = cookies/cache/session on disk). HTTP+ (userDataDir `~/.mso/chrome-profile` = cookies/cache/session on disk). HTTPAPI: navigate/screenshot/state/content/click/type/key/scroll/back/forward/reload.ufw: docker0 + docker_gwbridge on 4002 (non-public).-- **os-vps**: `lib/agent/server.ts` `browserConfigured()`+`browserFetch()`; 11+- **mso**: `lib/agent/server.ts` `browserConfigured()`+`browserFetch()`; 11`app/api/v1/browser/*` routes (Convex-auth-gated → `172.18.0.1:4002`). Browserslice rewritten to a single REMOTE view: live screenshot `<img>`, click mapped tothe 1280×800 viewport, keyboard/wheel forwarded, settle-poll after actions.@@ -1106,7 +1106,7 @@ touched:(bounds hold), no-auth→401, real `whoami`/disk. Agent still 0.0.0.0:4001,CR frontend `active`, container→172.18.0.1:4001/health 200.-**os-vps frontend:**+**mso frontend:**- OsApi `exec` simplified to one-shot `run(cmd, cwd?) => {stdout,stderr,code}`(dropped unused pid/stream/kill) across types + mock + http adapters.- 9 new `app/api/v1` proxy routes (fs read/write/mkdir/delete/move/copy/usage,@@ -1216,17 +1216,17 @@ Raised feature parity across the 6 thinnest apps (parallel re-author from`AGENT_HEALTH_HOST=0.0.0.0` (keeps loopback for the CR frontend, which calls127.0.0.1:4001 — CR NOT broken) + restarted. ufw INPUT policy is DROP, so4001 stays blocked from the public iface.-- The os-vps swarm task egresses via `docker_gwbridge` (172.18.0.x); added+- The mso swarm task egresses via `docker_gwbridge` (172.18.0.x); added`ufw allow in on docker_gwbridge to any port 4001`. Verified from inside thelive container: `http://172.18.0.1:4001/health` → 200.-- Set Dokploy os-vps env `OS_AGENT_URL=http://172.18.0.1:4001` + `OS_AGENT_SECRET`+- Set Dokploy mso env `OS_AGENT_URL=http://172.18.0.1:4001` + `OS_AGENT_SECRET`(existing env preserved). Flip Settings → Server → **Live** to list the realVPS tree. Agent fs is **read-only** (only `/fs/list`) — listing is real,mutations stay mock/local.Security: agent reachable from host containers + tailnet, NOT public (ufw DROP +only docker0/docker_gwbridge allowed on 4001); every call still gated by the-os-vps Convex-auth route + the agent's `x-control-room-secret`.+mso Convex-auth route + the agent's `x-control-room-secret`.---@@ -1391,11 +1391,11 @@ deployment only — NOT in the repo. Rotating = re-issue all sessions.## 2026-05-29 — Phase 3: Ship (DONE)-Live: https://os.rahmanef.com + Convex self-hosted https://api-os.rahmanef.com-(+ site-os / dash-os), all HTTP 200. Repo `[email protected]:rahmanef63/os-vps.git`.+Live: https://mso.rahmanef.com + Convex self-hosted https://api-mso.rahmanef.com+(+ site-os / dash-os), all HTTP 200. Repo `[email protected]:rahmanef63/mso.git`.- Canonical `si-coder deploy.js`: GitHub repo + push, Dokploy project/app- `os-vps` + compose `os-vps-db` (Convex template), admin-key gen, schema push+ `mso` + compose `mso-db` (Convex template), admin-key gen, schema push(auth + windows + systemMonitor indexes), Hostinger DNS (os/api-os/site-os/dash-os), frontend build → `done`.- pnpm Dockerfile (`ARG NEXT_PUBLIC_CONVEX_URL` build-arg inlining).diff --git a/docs/SLICE-CATALOG.md b/docs/SLICE-CATALOG.mdindex 505b193b..b0bac35e 100644--- a/docs/SLICE-CATALOG.md+++ b/docs/SLICE-CATALOG.md@@ -1,4 +1,4 @@-# os-vps — Slice Catalog+# mso — Slice Catalog> **Generated from `frontend/slices/` on 2026-07-28.** The previous version listed six> slices that no longer existed (`browser` and five `shell-*` slices that converged intodiff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.mdindex bb5e8e41..fea360a6 100644--- a/docs/TROUBLESHOOTING.md+++ b/docs/TROUBLESHOOTING.md@@ -48,7 +48,7 @@ refusal (`X-Content-Type-Options: nosniff` makes that fatal on purpose).mismatched:```bash-rm -rf .next && pnpm build && sudo systemctl restart os-vps.service+rm -rf .next && pnpm build && sudo systemctl restart mso.service```### Build runs out of memory ("Ineffective mark-compacts near heap limit")@@ -88,13 +88,13 @@ Top-level system dirs are refused even if listed — keep writes narrow.Reads are bounded by `OS_FS_READ_ROOTS` (default home + `~/projects`). Set`OS_FS_READ_ROOTS=/` for read-only browsing of the whole box. Also remember-the process user's own permissions still apply — os-vps can't read what+the process user's own permissions still apply — mso can't read what`youruser` can't.-### "Access to os-vps credential files is blocked"+### "Access to mso credential files is blocked"By design: the FS API refuses the app's own `.env*` files and everything-under `~/.os-vps/` (device allowlist, BYOK key, audit log, browser profile),+under `~/.mso/` (device allowlist, BYOK key, audit log, browser profile),even inside a legal read/write root — otherwise one stolen session could read`OS_SESSION_SECRET` and forge cookies forever. Edit those files over SSH.@@ -143,7 +143,7 @@ sudo once for the deps).### Assistant returns 501No API key. Set `ANTHROPIC_API_KEY` in `.env.local` or paste a key under-Settings → AI (stored in `~/.os-vps/config.json`). It's BYOK — without a key+Settings → AI (stored in `~/.mso/config.json`). It's BYOK — without a keythe endpoint stays off and everything else works.## Service & networking@@ -161,11 +161,11 @@ firewall allows the proxy, not the app port.### Service restarts in a loop-`journalctl -u os-vps -n 50` — most common: missing `.env.local`+`journalctl -u mso -n 50` — most common: missing `.env.local`(`EnvironmentFile=` path wrong), Node not at `/usr/bin` (adjust `ExecStart`),or the build is absent (`pnpm build` never ran in that WorkingDirectory).## Still stuck?-Check the audit log (`~/.os-vps/audit.log`) for what the server actually did,-and `journalctl -u os-vps` for stack traces. Issues/PRs welcome.+Check the audit log (`~/.mso/audit.log`) for what the server actually did,+and `journalctl -u mso` for stack traces. Issues/PRs welcome.diff --git a/frontend/slices/app-store/lib/apps-store.ts b/frontend/slices/app-store/lib/apps-store.tsindex aa8c7d3b..4cb204a0 100644--- a/frontend/slices/app-store/lib/apps-store.ts+++ b/frontend/slices/app-store/lib/apps-store.ts@@ -17,7 +17,7 @@ export type AppRow = {installed: boolean;};-const KEY = "os-vps:apps";+const KEY = "mso:apps";const EMPTY: AppRow[] = [];let rows: AppRow[] | null = null;const subs = new Set<() => void>();diff --git a/frontend/slices/app-store/lib/enabled-store.ts b/frontend/slices/app-store/lib/enabled-store.tsindex 0fa2b429..c1636acd 100644--- a/frontend/slices/app-store/lib/enabled-store.ts+++ b/frontend/slices/app-store/lib/enabled-store.ts@@ -9,7 +9,7 @@ import { useSyncExternalStore } from "react";// `app-store` itself can never be disabled: it is the surface that re-enables// everything else, so disabling it would be a lock-out.-const KEY = "os-vps:disabled";+const KEY = "mso:disabled";const MANDATORY = new Set<string>(["app-store"]);let ids: string[] | null = null;diff --git a/frontend/slices/app-store/lib/host.ts b/frontend/slices/app-store/lib/host.tsindex 3f34f920..220428a6 100644--- a/frontend/slices/app-store/lib/host.ts+++ b/frontend/slices/app-store/lib/host.ts@@ -1,6 +1,6 @@"use client";-// os-vps side of the slice's host seam: everything project-specific the+// mso side of the slice's host seam: everything project-specific the// slice touches re-exports from the shell + OsApi here. The rr catalog// copy replaces this file with a self-contained version (demo exec +// no-op inspector) and bundles the Create-App flow in-slice.diff --git a/frontend/slices/appshell/components/mobile-shell.tsx b/frontend/slices/appshell/components/mobile-shell.tsxindex 4e162ffd..71f6ae2d 100644--- a/frontend/slices/appshell/components/mobile-shell.tsx+++ b/frontend/slices/appshell/components/mobile-shell.tsx@@ -203,7 +203,7 @@ export function MobileShell() {/>{/* Nav bar: transparent at rest, frosting into a hairline glass bar oncethe app scrolls (onScrollCapture on <main> catches the app's own inner- scroll container generically). Title stays put — os-vps apps carry no+ scroll container generically). Title stays put — mso apps carry noin-content large title to fade in. */}<headerclassName={cn(diff --git a/frontend/slices/appshell/features/desktop-icons/store.ts b/frontend/slices/appshell/features/desktop-icons/store.tsindex 60390216..fa69f943 100644--- a/frontend/slices/appshell/features/desktop-icons/store.ts+++ b/frontend/slices/appshell/features/desktop-icons/store.ts@@ -21,7 +21,7 @@ export type NewIcon =export const ICON_W = 76;export const ICON_H = 82;-const KEY = "os-vps:desktop-icons";+const KEY = "mso:desktop-icons";const DEFAULT: DesktopIcon[] = [{ id: "files-manager", kind: "app", app: "files-manager", x: 16, y: 12 },{ id: "system-monitor", kind: "app", app: "system-monitor", x: 16, y: 106 },diff --git a/frontend/slices/appshell/features/search/history.ts b/frontend/slices/appshell/features/search/history.tsindex 189a0de1..b7f18e67 100644--- a/frontend/slices/appshell/features/search/history.ts+++ b/frontend/slices/appshell/features/search/history.ts@@ -1,7 +1,7 @@// Spotlight MRU — recently-run command ids, newest first, capped. When the// Spotlight query is empty, these float to the top of the result list so the// last actions a user took are one keystroke away. localStorage-only, no host.-const KEY = "os-vps:spotlight-recents";+const KEY = "mso:spotlight-recents";const MAX = 6;export function loadRecents(): string[] {diff --git a/frontend/slices/appshell/features/widgets/components/widgets-defs-apps.tsx b/frontend/slices/appshell/features/widgets/components/widgets-defs-apps.tsxindex 9aaebf8c..a0f89138 100644--- a/frontend/slices/appshell/features/widgets/components/widgets-defs-apps.tsx+++ b/frontend/slices/appshell/features/widgets/components/widgets-defs-apps.tsx@@ -9,7 +9,7 @@ import { Card } from "./widget-cards";// widgets-defs.tsx): a mini calendar and a persisted task list. Split out to keep// widgets-defs.tsx under the line ceiling.-const TASKS_KEY = "os-vps:widget:tasks";+const TASKS_KEY = "mso:widget:tasks";type Task = { id: string; text: string; done: boolean };// Current-month mini calendar, today highlighted. Client-only (the desktop stackdiff --git a/frontend/slices/appshell/features/widgets/components/widgets-defs-vps.tsx b/frontend/slices/appshell/features/widgets/components/widgets-defs-vps.tsxindex fcb0b539..9f9ba123 100644--- a/frontend/slices/appshell/features/widgets/components/widgets-defs-vps.tsx+++ b/frontend/slices/appshell/features/widgets/components/widgets-defs-vps.tsx@@ -12,9 +12,9 @@ import { mdToHtml } from "./md";// and a theme toggle. Split out to keep widgets-defs.tsx under the line ceiling.// All are interactive (opt back into pointer events).-const EMBED_KEY = "os-vps:widget:embed";-const HTML_KEY = "os-vps:widget:html";-const MD_KEY = "os-vps:widget:markdown";+const EMBED_KEY = "mso:widget:embed";+const HTML_KEY = "mso:widget:html";+const MD_KEY = "mso:widget:markdown";const ls = (k: string) => (typeof localStorage !== "undefined" ? localStorage.getItem(k) ?? "" : "");const btn = "rounded-lg border border-white/10 bg-black/10 px-2 py-1 text-xs hover:bg-white/10";diff --git a/frontend/slices/appshell/features/widgets/components/widgets-defs.tsx b/frontend/slices/appshell/features/widgets/components/widgets-defs.tsxindex be03dc31..ec6e2e10 100644--- a/frontend/slices/appshell/features/widgets/components/widgets-defs.tsx+++ b/frontend/slices/appshell/features/widgets/components/widgets-defs.tsx@@ -7,7 +7,7 @@ import { Bar, Card, Row, Sparkline, gb } from "./widget-cards";import { CalendarWidget, TasksWidget } from "./widgets-defs-apps";import { VPS_WIDGETS } from "./widgets-defs-vps";-const NOTES_KEY = "os-vps:widget:notes";+const NOTES_KEY = "mso:widget:notes";// Inlined (appshell is brand-free — can't import @/lib/os-api/format).function fmtUptime(ms: number): string {diff --git a/frontend/slices/appshell/features/widgets/widget-registry.ts b/frontend/slices/appshell/features/widgets/widget-registry.tsindex d1f851c8..9301efa3 100644--- a/frontend/slices/appshell/features/widgets/widget-registry.ts+++ b/frontend/slices/appshell/features/widgets/widget-registry.ts@@ -35,7 +35,7 @@ export const WIDGET_META: WidgetMeta[] = [{ id: "shell", title: "Shell" },];-const KEY = "os-vps:desktop-widgets"; // { on, enabled[], sizes{} }+const KEY = "mso:desktop-widgets"; // { on, enabled[], sizes{} }const LEGACY_KEY = "sv:desktop-widgets"; // old "1"/"0" on-flag (pre-registry)const DEFAULT_ENABLED = ["cpu", "mem", "disk"];diff --git a/frontend/slices/appshell/index.ts b/frontend/slices/appshell/index.tsindex 8e31d98e..63f1537e 100644--- a/frontend/slices/appshell/index.ts+++ b/frontend/slices/appshell/index.ts@@ -62,7 +62,7 @@ export type { NotificationItem } from "./lib/toast";export { setActivity, clearActivity, useActivities } from "./lib/activity";export type { Activity } from "./lib/activity";// Host-I/O PORT — the generic backend seam. Apps read host data via useOsApi();-// the consumer injects a concrete adapter through HostApiProvider (os-vps wraps+// the consumer injects a concrete adapter through HostApiProvider (mso wraps// it in its own OsApiProvider). The OsApi type IS the portability contract.export { HostApiProvider, useOsApi } from "./lib/host-api";export type {diff --git a/frontend/slices/appshell/lib/host-api.tsx b/frontend/slices/appshell/lib/host-api.tsxindex a782bd3b..3da71be6 100644--- a/frontend/slices/appshell/lib/host-api.tsx+++ b/frontend/slices/appshell/lib/host-api.tsx@@ -2,7 +2,7 @@// Host-I/O PORT — the generic seam apps read to reach a backend (fs/exec/sys/// apps/auth). The interface + React context live here in the brand-free-// framework; each CONSUMER injects a concrete adapter (os-vps: HTTP→/api/v1 or+// framework; each CONSUMER injects a concrete adapter (mso: HTTP→/api/v1 or// in-browser mock; a Convex consumer: useQuery/useMutation) via// <HostApiProvider api=…>. App slices import `useOsApi` + these types through// the shell barrel (a legal alias) — never a project-specific @/lib path — so@@ -111,7 +111,7 @@ const HostApiContext = createContext<OsApi | null>(null);// The consumer computes its adapter (mock|live HTTP, or Convex) and injects it// here; every app reads it via useOsApi(). Mounting stays in the consumer-// (os-vps mounts it from app/os-root, wrapping this provider) so the brand-free+// (mso mounts it from app/os-root, wrapping this provider) so the brand-free// framework carries no route/auth assumptions.export function HostApiProvider({api,diff --git a/frontend/slices/appshell/lib/mentions.test.ts b/frontend/slices/appshell/lib/mentions.test.tsindex d1151c2c..40746103 100644--- a/frontend/slices/appshell/lib/mentions.test.ts+++ b/frontend/slices/appshell/lib/mentions.test.ts@@ -13,7 +13,7 @@ describe("/ never fires on a filesystem path", () => {"ls /home/rahman","read /etc/hosts","copy /var/log/syslog to /tmp",- "what is in /home/rahman/projects/os-vps",+ "what is in /home/rahman/projects/mso","cd ~/projects && ls /usr/share","the ratio is 3/4",])("stays closed for %j", (text) => {diff --git a/frontend/slices/assistant/lib/host.ts b/frontend/slices/assistant/lib/host.tsindex 3385f4c0..c440c14b 100644--- a/frontend/slices/assistant/lib/host.ts+++ b/frontend/slices/assistant/lib/host.ts@@ -1,6 +1,6 @@"use client";-// os-vps side of the slice's host seam: everything project-specific the+// mso side of the slice's host seam: everything project-specific the// slice touches re-exports from the shell + the root AI stream here. The// rr catalog copy replaces this file with a self-contained version// (configureAssistantStream + typing demo stream + no-op inspector) —diff --git a/frontend/slices/auth/components/auth-gate.tsx b/frontend/slices/auth/components/auth-gate.tsxindex acf03ac9..227ae687 100644--- a/frontend/slices/auth/components/auth-gate.tsx+++ b/frontend/slices/auth/components/auth-gate.tsx@@ -74,8 +74,8 @@ function Splash() {);}-const ONBOARDING_KEY = "os-vps:onboarding:v1";-const ONBOARDING_OPEN = "os-vps:onboarding:open";+const ONBOARDING_KEY = "mso:onboarding:v1";+const ONBOARDING_OPEN = "mso:onboarding:open";type StatusInfo = {linuxUser: string;diff --git a/frontend/slices/auth/lib/device.ts b/frontend/slices/auth/lib/device.tsindex 7c117f0c..bd453082 100644--- a/frontend/slices/auth/lib/device.ts+++ b/frontend/slices/auth/lib/device.ts@@ -4,8 +4,8 @@// id, so the device isn't re-minted (no needless re-approval). A full "clear// all site data" wipes both → a new id, by design (the device's stored secret// is gone, so it's correctly treated as a new device).-const KEY = "os-vps.device.id";-const COOKIE = "os-vps-device";+const KEY = "mso.device.id";+const COOKIE = "mso-device";const RE = /^[a-f0-9]{16,128}$/i;const MAX_AGE = 60 * 60 * 24 * 365 * 2; // 2 years (refreshed on every read)diff --git a/frontend/slices/code-editor/components/file-tree/index.tsx b/frontend/slices/code-editor/components/file-tree/index.tsxindex 9874cd42..174ea744 100644--- a/frontend/slices/code-editor/components/file-tree/index.tsx+++ b/frontend/slices/code-editor/components/file-tree/index.tsx@@ -1,4 +1,4 @@"use client";-// os-vps seam: the app-shared live file tree. rr bundles a copy in-slice.+// mso seam: the app-shared live file tree. rr bundles a copy in-slice.export { FileTree } from "@/shared/file-tree";diff --git a/frontend/slices/code-editor/components/host-drawer.tsx b/frontend/slices/code-editor/components/host-drawer.tsxindex 7f160072..31540646 100644--- a/frontend/slices/code-editor/components/host-drawer.tsx+++ b/frontend/slices/code-editor/components/host-drawer.tsx@@ -1,4 +1,4 @@"use client";-// os-vps seam: the shell's FormDrawer. rr ships a slice-local copy instead.+// mso seam: the shell's FormDrawer. rr ships a slice-local copy instead.export { FormDrawer } from "@/features/os-shell";diff --git a/frontend/slices/code-editor/components/host-sidebar.tsx b/frontend/slices/code-editor/components/host-sidebar.tsxindex 420ff8b2..28edc451 100644--- a/frontend/slices/code-editor/components/host-sidebar.tsx+++ b/frontend/slices/code-editor/components/host-sidebar.tsx@@ -1,4 +1,4 @@"use client";-// os-vps seam: the shell's AppSidebar. rr ships a slice-local copy instead.+// mso seam: the shell's AppSidebar. rr ships a slice-local copy instead.export { AppSidebar } from "@/features/os-shell";diff --git a/frontend/slices/code-editor/lib/host.ts b/frontend/slices/code-editor/lib/host.tsindex 8370f39d..2350d4f8 100644--- a/frontend/slices/code-editor/lib/host.ts+++ b/frontend/slices/code-editor/lib/host.ts@@ -1,6 +1,6 @@"use client";-// os-vps side of the slice's host seam: everything project-specific the+// mso side of the slice's host seam: everything project-specific the// slice touches re-exports from the shell + OsApi here. The rr catalog// copy replaces this file with a self-contained version (injectable// CodeFsAdapter + no-op inspector) — every other file is line-identical.diff --git a/frontend/slices/files-manager/lib/format.test.ts b/frontend/slices/files-manager/lib/format.test.tsindex 0bcb18f3..52414ee4 100644--- a/frontend/slices/files-manager/lib/format.test.ts+++ b/frontend/slices/files-manager/lib/format.test.ts@@ -99,19 +99,19 @@ describe("parentPath", () => {describe("crumbsFor", () => {it("root path → single crumb [root]", () => {- expect(crumbsFor("/")).toEqual([{ name: "os-vps", path: "/" }]);+ expect(crumbsFor("/")).toEqual([{ name: "mso", path: "/" }]);});it("single-level → [root, segment]", () => {expect(crumbsFor("/home")).toEqual([- { name: "os-vps", path: "/" },+ { name: "mso", path: "/" },{ name: "home", path: "/home" },]);});it("multi-level → all segments with correct paths", () => {expect(crumbsFor("/home/rahman/projects")).toEqual([- { name: "os-vps", path: "/" },+ { name: "mso", path: "/" },{ name: "home", path: "/home" },{ name: "rahman", path: "/home/rahman" },{ name: "projects", path: "/home/rahman/projects" },diff --git a/frontend/slices/files-manager/lib/format.ts b/frontend/slices/files-manager/lib/format.tsindex 1799c46d..4e2110a7 100644--- a/frontend/slices/files-manager/lib/format.ts+++ b/frontend/slices/files-manager/lib/format.ts@@ -24,7 +24,7 @@ export const parentPath = (p: string): string => {};// Breadcrumb segments for a path, including the synthetic root.-export function crumbsFor(path: string, root = "os-vps"): { name: string; path: string }[] {+export function crumbsFor(path: string, root = "mso"): { name: string; path: string }[] {const head = { name: root, path: "/" };if (path === "/") return [head];const parts = path.split("/").filter(Boolean);diff --git a/frontend/slices/image-editor/ARCHITECTURE.md b/frontend/slices/image-editor/ARCHITECTURE.mdindex 04da43b7..895719ab 100644--- a/frontend/slices/image-editor/ARCHITECTURE.md+++ b/frontend/slices/image-editor/ARCHITECTURE.md@@ -74,5 +74,5 @@ render acc- New panel → `components/panels/`, added as a tab in `side-panel`/`mobile-shell`.- New state/op → a hook in `lib/` wired into `store.tsx` (keep store thin).- Files over 200 LOC get split (e.g. transform-panel → text-props/shape-props).-- shadcn primitives only; on lift to os-vps, divergent ones (slider/tabs) are+- shadcn primitives only; on lift to mso, divergent ones (slider/tabs) arevendored under `ui/` and imports rewritten (see the lift notes).diff --git a/frontend/slices/image-editor/README.md b/frontend/slices/image-editor/README.mdindex 3e60d392..32888788 100644--- a/frontend/slices/image-editor/README.md+++ b/frontend/slices/image-editor/README.md@@ -2,7 +2,7 @@Embeddable, layer-based image editor built on Konva. Consumed as a LIBRARYslice: import `{ ImageEditor }` (or the store/model pieces) from the barrel —-it is not an app descriptor by itself (os-vps mounts it via media-studio).+it is not an app descriptor by itself (mso mounts it via media-studio).## Capabilitiesdiff --git a/frontend/slices/image-editor/image-editor.tsx b/frontend/slices/image-editor/image-editor.tsxindex 3b7300d9..b8b5be44 100644--- a/frontend/slices/image-editor/image-editor.tsx+++ b/frontend/slices/image-editor/image-editor.tsx@@ -25,7 +25,7 @@ export type ImageEditorProps = {* Optional URL to a saved document/project JSON to load on mount — either a* full Project ({v:1,doc,paint}) or a bare Doc ({width,height,layers}). This* is how a headless-CRUD'd `.doc.json` (built via /api/v1/editor/exec) renders- * in the REAL editor: "render = open in os-vps".+ * in the REAL editor: "render = open in mso".*/projectSrc?: string;/**diff --git a/frontend/slices/image-editor/lib/host.ts b/frontend/slices/image-editor/lib/host.tsindex f3f6e2fa..2c968362 100644--- a/frontend/slices/image-editor/lib/host.ts+++ b/frontend/slices/image-editor/lib/host.ts@@ -1,4 +1,4 @@-// Single integration seam between this slice and the host app (os-vps): the+// Single integration seam between this slice and the host app (mso): the// AI streaming bridge is the ONLY host service the editor uses. Lifting the// slice to the rr catalog = swap this file for an injected `streamAgentTurn`// capability (UI primitives `@/components/ui/*` + `@/lib/utils` excepted).diff --git a/frontend/slices/image-editor/server.ts b/frontend/slices/image-editor/server.tsindex 2b8afa5e..c5ce6703 100644--- a/frontend/slices/image-editor/server.ts+++ b/frontend/slices/image-editor/server.ts@@ -2,7 +2,7 @@// native deps). The API route imports from here to run the editor's command// registry against a Doc and to build a doc from an opened image. There is NO// server renderer: to SEE a doc, open it in the real editor (media-studio loads-// a `.doc.json` / `.ie.json` path) — "render = the actual os-vps editor".+// a `.doc.json` / `.ie.json` path) — "render = the actual mso editor".export { runCommands, HEADLESS_COMMANDS, HEADLESS_TOOLS, buildDocFromImage, isDoc } from "./lib/headless/run";export type { Invocation, CmdResult } from "./lib/headless/run";export { imageSize } from "./lib/headless/image-size";diff --git a/frontend/slices/managed-apps/job-panel.tsx b/frontend/slices/managed-apps/job-panel.tsxindex cd905a3e..68735970 100644--- a/frontend/slices/managed-apps/job-panel.tsx+++ b/frontend/slices/managed-apps/job-panel.tsx@@ -50,7 +50,7 @@ export function JobPanel({ job, onDismiss, onCancel }: { job: JobState; onDismis// A job holds the app's lock until it ends, so one that stops ending —// an updater that leaks a background process, a CLI that hangs below// its timeout — leaves every later action on this app answering "busy".- // The alternative escape is restarting os-vps, which is the one thing+ // The alternative escape is restarting mso, which is the one thing// not to do mid-update.<Button type="button" variant="ghost" size="sm" onClick={onCancel}>Canceldiff --git a/frontend/slices/managed-apps/rollback-panel.tsx b/frontend/slices/managed-apps/rollback-panel.tsxindex 40db4bab..34f1def3 100644--- a/frontend/slices/managed-apps/rollback-panel.tsx+++ b/frontend/slices/managed-apps/rollback-panel.tsx@@ -61,7 +61,7 @@ export function RollbackPanel({ appId, centre }: { appId: ManagedAppId; centre:{!supported ? (<p className="text-[11px] leading-relaxed text-muted-foreground">This build has no backups endpoint. Snapshots taken by the Backup action still live in- <span className="font-mono"> ~/.os-vps/backups/{appId}/</span>.+ <span className="font-mono"> ~/.mso/backups/{appId}/</span>.</p>) : backups === null ? (<p className="text-[11px] text-muted-foreground">Loading snapshots…</p>diff --git a/frontend/slices/media-studio/app.tsx b/frontend/slices/media-studio/app.tsxindex cfe928a0..feee2c28 100644--- a/frontend/slices/media-studio/app.tsx+++ b/frontend/slices/media-studio/app.tsx@@ -19,7 +19,7 @@ import { Button } from "@/components/ui/button";import { SaveImageDialog } from "./components/save-image-dialog";import { autoName, loadSavePrefs, saveImageToHost } from "./lib/save-image";-// The OS "Image Editor" app — the portable image-editor slice + os-vps wiring:+// The OS "Image Editor" app — the portable image-editor slice + mso wiring:// open host images / round-trip a saved doc, SAVE rendered images to a VPS folder,// and guard window close on unsaved changes (Save / Don't Save / Cancel).export default function MediaStudio({ payload, winId }: AppProps) {diff --git a/frontend/slices/media-studio/lib/host.ts b/frontend/slices/media-studio/lib/host.tsindex 7da01495..7b3bdbf8 100644--- a/frontend/slices/media-studio/lib/host.ts+++ b/frontend/slices/media-studio/lib/host.ts@@ -1,4 +1,4 @@-// Single host seam — re-exports the os-vps raw-bytes URL helper via the shell+// Single host seam — re-exports the mso raw-bytes URL helper via the shell// barrel (a legal alias). Lifting the slice swaps this file for an injected one;// no other file in the slice imports host I/O directly.export { rawUrl } from "@/features/os-shell";diff --git a/frontend/slices/media-studio/lib/save-image.ts b/frontend/slices/media-studio/lib/save-image.tsindex dd46cf76..2bfd9b2c 100644--- a/frontend/slices/media-studio/lib/save-image.ts+++ b/frontend/slices/media-studio/lib/save-image.ts@@ -1,6 +1,6 @@"use client";-// Host-side image saving for Media Studio (the os-vps consumer of the portable+// Host-side image saving for Media Studio (the mso consumer of the portable// image-editor slice). The editor stays backend-agnostic and just hands us a PNG// data URL; here we convert it to the chosen format and write it to a VPS folder// via the binary-safe upload route, remembering the user's choice in localStorage.diff --git a/frontend/slices/media-viewer/lib/host.ts b/frontend/slices/media-viewer/lib/host.tsindex 7da01495..7b3bdbf8 100644--- a/frontend/slices/media-viewer/lib/host.ts+++ b/frontend/slices/media-viewer/lib/host.ts@@ -1,4 +1,4 @@-// Single host seam — re-exports the os-vps raw-bytes URL helper via the shell+// Single host seam — re-exports the mso raw-bytes URL helper via the shell// barrel (a legal alias). Lifting the slice swaps this file for an injected one;// no other file in the slice imports host I/O directly.export { rawUrl } from "@/features/os-shell";diff --git a/frontend/slices/os-settings/components/about-section.tsx b/frontend/slices/os-settings/components/about-section.tsxindex adcb07f4..816d856a 100644--- a/frontend/slices/os-settings/components/about-section.tsx+++ b/frontend/slices/os-settings/components/about-section.tsx@@ -16,12 +16,12 @@ const APP_NAME = "Manef Shell OS";const APP_TAGLINE = "Browser-based visual shell";// Wipes appearance + device identity, then reloads fresh. Storage keys keep the-// historical "os-vps" prefix (changing them would orphan existing device ids).+// historical "mso" prefix (changing them would orphan existing device ids).function performReset() {try {- localStorage.removeItem("os-vps:tweaks");- localStorage.removeItem("os-vps.device.id");- localStorage.removeItem("os-vps:demo-fs");+ localStorage.removeItem("mso:tweaks");+ localStorage.removeItem("mso.device.id");+ localStorage.removeItem("mso:demo-fs");} catch {/* private mode / quota */}diff --git a/frontend/slices/os-shell/brand-marks.tsx b/frontend/slices/os-shell/brand-marks.tsxindex 735e74e9..e5968715 100644--- a/frontend/slices/os-shell/brand-marks.tsx+++ b/frontend/slices/os-shell/brand-marks.tsx@@ -8,7 +8,7 @@//// Plain <img>, not next/image: these are tiny fixed-size local assets, so the// optimizer would add a round trip and buy nothing. They live in os-shell (the-// os-vps CONSUMER), never in appshell — the framework stays brand-free.+// mso CONSUMER), never in appshell — the framework stays brand-free.//// `alt=""` on purpose: every surface that renders an app icon already labels it// with the app title, so alt text here would just repeat it to a screen reader.diff --git a/frontend/slices/os-shell/capabilities.ts b/frontend/slices/os-shell/capabilities.tsindex 0e555da2..84330d31 100644--- a/frontend/slices/os-shell/capabilities.ts+++ b/frontend/slices/os-shell/capabilities.ts@@ -64,7 +64,7 @@ function startSharedStats(api: ReturnType<typeof useOsApi>) {statsStop = startVisiblePoll(poll, 3000);}-// Adapts os-vps's appearance store + host API + AI stream to the generic AppShell+// Adapts mso's appearance store + host API + AI stream to the generic AppShell// capability contract, so `appshell` AND its feature slices carry NO dependency on// @/lib/*. These run inside os-root's AppearanceProvider + OsApiProvider (AppShell// is nested below them).diff --git a/frontend/slices/os-shell/index.ts b/frontend/slices/os-shell/index.tsindex 4d5c7971..14f0deb8 100644--- a/frontend/slices/os-shell/index.ts+++ b/frontend/slices/os-shell/index.ts@@ -1,13 +1,13 @@-// os-shell — the os-vps (MSO) consumer of the generic AppShell framework.+// os-shell — the mso (MSO) consumer of the generic AppShell framework.//// The shell runtime, registries, responsive provider, chrome and primitives now// live in the brand-free `appshell` slice (lift-ready for rr). This barrel stays// the STABLE public surface every app slice imports from (`@/features/os-shell`),-// re-exporting appshell verbatim so app slices need no edits. os-vps-specific+// re-exporting appshell verbatim so app slices need no edits. mso-specific// wiring (brand + apps + features) lives in `./shell.manifest.ts` (added in a// later phase) and is passed to <AppShell manifest=…>.export * from "@/features/appshell";-// Bridge os-vps-specific host helpers (raw-bytes URL + byte/uptime formatters)+// Bridge mso-specific host helpers (raw-bytes URL + byte/uptime formatters)// into the stable barrel so app slices reach them via @/features/os-shell (a// legal peer alias) rather than @/lib/os-api directly. The OsApi port + hook// already flow through the appshell re-export above.diff --git a/frontend/slices/os-shell/shell.manifest.ts b/frontend/slices/os-shell/shell.manifest.tsindex 46cff877..5f561890 100644--- a/frontend/slices/os-shell/shell.manifest.ts+++ b/frontend/slices/os-shell/shell.manifest.ts@@ -1,4 +1,4 @@-// MSO's shell manifest — the os-vps-specific config that drives the generic+// MSO's shell manifest — the mso-specific config that drives the generic// AppShell. This is the ONE place brand + the built-in app set + shell features// are declared; appshell core imports none of it. Runtime-installed apps are// merged on top in os-root (they come from a hook, not static config).@@ -29,7 +29,7 @@ export const TOPSIDE_BRAND: Brand = {// Preserve the historical localStorage namespace so existing saved layouts// aren't orphaned (the generic appshell default is "appshell:layout").-export const TOPSIDE_PERSIST_KEY = "os-vps:layout";+export const TOPSIDE_PERSIST_KEY = "mso:layout";// Short URL slug per app for deep-linking (`/files`), assigned here so the app// slices stay URL-agnostic. Falls back to the app id when unmapped.@@ -38,7 +38,7 @@ const withSlug = (app: AppDescriptor, slug: string): AppDescriptor => ({ ...app,const pin = (app: AppDescriptor): AppDescriptor => ({ ...app, pinned: true });// Apps that wrap a third-party product wear that product's OWN mark. Assigned here,// not in the slice: the slice stays free of brand assets, this file already owns-// every other bit of os-vps-specific identity, and `iconFill` drops the gradient+// every other bit of mso-specific identity, and `iconFill` drops the gradient// tile so a real logo is not stickered onto a synthetic one.const withMark = (app: AppDescriptor, icon: AppDescriptor["icon"]): AppDescriptor =>({ ...app, icon, iconFill: true });@@ -64,10 +64,10 @@ export const BUILTIN_APPS: AppDescriptor[] = [];// Shell features — the generic brand-free set now lives INSIDE the appshell-// slice (appshell/features/*) and ships as one bundle, DEFAULT_FEATURES. os-vps+// slice (appshell/features/*) and ships as one bundle, DEFAULT_FEATURES. mso// uses them verbatim; trim/extend by spreading ([...DEFAULT_FEATURES, …]). Each// mounts into a named slot (overlay/rightPanel/notifications/topPill/// controlCenter/today), so a feature absent from the array just doesn't render.-// Settings stays the `os-settings` app (its own slice). os-vps adds one consumer+// Settings stays the `os-settings` app (its own slice). mso adds one consumer// feature: a compact theme-preset switcher in the menu-bar status cluster.export const TOPSIDE_FEATURES: FeatureDescriptor[] = [...DEFAULT_FEATURES, themeQuickPickerFeature];diff --git a/frontend/slices/os-shell/slice.json b/frontend/slices/os-shell/slice.jsonindex 9c68bf42..7ffe6974 100644--- a/frontend/slices/os-shell/slice.json+++ b/frontend/slices/os-shell/slice.json@@ -5,7 +5,7 @@"category": "ui","kind": "full","title": "os-shell — Manef Shell OS consumer of the AppShell framework",- "description": "The os-vps (Manef Shell OS) consumer slice: shell.manifest.ts declares the brand + built-in app set + shell features, and the barrel re-exports the generic `appshell` framework so app slices import a stable `@/features/os-shell`. No backend — window layout persists to localStorage.",+ "description": "The mso (Manef Shell OS) consumer slice: shell.manifest.ts declares the brand + built-in app set + shell features, and the barrel re-exports the generic `appshell` framework so app slices import a stable `@/features/os-shell`. No backend — window layout persists to localStorage.","namespace": "@/features/os-shell","frontend": {"slicePath": "frontend/slices/os-shell",diff --git a/frontend/slices/os-shell/theme-quick-picker.tsx b/frontend/slices/os-shell/theme-quick-picker.tsxindex 003a7c5a..c5f027fc 100644--- a/frontend/slices/os-shell/theme-quick-picker.tsx+++ b/frontend/slices/os-shell/theme-quick-picker.tsx@@ -17,7 +17,7 @@ import { cn } from "@/lib/utils";// Compact menu-bar theme-preset switcher — the same live preset switch Settings// offers, without opening the Settings app. Lives in os-shell (the consumer) and// mounts into the appshell's `menuBarStatus` slot, so the brand-free appshell-// never imports the os-vps preset registry.+// never imports the mso preset registry.function ThemeQuickPicker() {const { tweaks, setTweaks } = useAppearance();const [open, setOpen] = useState(false);diff --git a/frontend/slices/os-terminal/lib/fs-model.test.ts b/frontend/slices/os-terminal/lib/fs-model.test.tsindex dc0de707..4337bb44 100644--- a/frontend/slices/os-terminal/lib/fs-model.test.ts+++ b/frontend/slices/os-terminal/lib/fs-model.test.ts@@ -44,7 +44,7 @@ describe("resolve", () => {});it("relative arg with nested path", () => {- expect(resolve(cwd, "projects/os-vps")).toBe("/home/rahman/projects/os-vps");+ expect(resolve(cwd, "projects/mso")).toBe("/home/rahman/projects/mso");});it("strips trailing slash from absolute arg", () => {diff --git a/frontend/slices/os-terminal/lib/fs-model.ts b/frontend/slices/os-terminal/lib/fs-model.tsindex 83ee70de..5fe29e67 100644--- a/frontend/slices/os-terminal/lib/fs-model.ts+++ b/frontend/slices/os-terminal/lib/fs-model.ts@@ -29,7 +29,7 @@ export function seedFs(): FsModel {{ name: "apps", kind: "dir", size: 0 },{ name: "readme.md", kind: "file", size: 1840, ext: "md" },],- "/Projects": [{ name: "os-vps", kind: "dir", size: 0 }],+ "/Projects": [{ name: "mso", kind: "dir", size: 0 }],"/Documents": [{ name: "notes.txt", kind: "file", size: 96, ext: "txt" }],"/apps": [],"/Media": [],diff --git a/frontend/slices/os-terminal/lib/host.ts b/frontend/slices/os-terminal/lib/host.tsindex 241a9324..a59a27d6 100644--- a/frontend/slices/os-terminal/lib/host.ts+++ b/frontend/slices/os-terminal/lib/host.ts@@ -1,6 +1,6 @@"use client";-// os-vps side of the slice's host seam: everything project-specific the+// mso side of the slice's host seam: everything project-specific the// slice touches re-exports from the shell + OsApi here. The rr catalog// copy replaces this file with a self-contained version (injectable// TerminalOsApi + no-op inspector) — every other file is line-identical.diff --git a/frontend/slices/reel-editor/lib/host.ts b/frontend/slices/reel-editor/lib/host.tsindex 78384ab2..83214f90 100644--- a/frontend/slices/reel-editor/lib/host.ts+++ b/frontend/slices/reel-editor/lib/host.ts@@ -1,4 +1,4 @@-// Single integration seam between this slice and the host app (os-vps).+// Single integration seam between this slice and the host app (mso).// EVERYTHING OS-specific funnels through here — shell services (toasts,// inspector, activity), the fs/api client, and responsive detection — so// lifting the slice to the rr catalog means swapping THIS file for injecteddiff --git a/frontend/slices/system-monitor/components/host-frame.tsx b/frontend/slices/system-monitor/components/host-frame.tsxindex a9bb9c44..65e1cd23 100644--- a/frontend/slices/system-monitor/components/host-frame.tsx+++ b/frontend/slices/system-monitor/components/host-frame.tsx@@ -1,4 +1,4 @@"use client";-// os-vps seam: the shell's AppFrame + TouchList. rr ships slice-local shims.+// mso seam: the shell's AppFrame + TouchList. rr ships slice-local shims.export { AppFrame, TouchList } from "@/features/os-shell";diff --git a/frontend/slices/system-monitor/lib/host.ts b/frontend/slices/system-monitor/lib/host.tsindex 3b7eddee..df0e8f64 100644--- a/frontend/slices/system-monitor/lib/host.ts+++ b/frontend/slices/system-monitor/lib/host.ts@@ -1,6 +1,6 @@"use client";-// os-vps side of the slice's host seam: everything project-specific the+// mso side of the slice's host seam: everything project-specific the// slice touches re-exports from the shell + OsApi here. The rr catalog// copy replaces this file with a self-contained version (injectable// SysMonAdapter + no-op inspector) — every other file is line-identical.diff --git a/hooks/use-mobile.ts b/hooks/use-mobile.tsindex f5d8bcd0..69f3f82f 100644--- a/hooks/use-mobile.ts+++ b/hooks/use-mobile.ts@@ -1,4 +1,4 @@-// os-vps consumer compat shim. The real implementation lives inside the+// mso consumer compat shim. The real implementation lives inside the// appshell slice (the shell owns its responsive contract); app slices that// predate the framework still import `@/hooks/use-mobile`, so this re-exports// it. Deep import (not the barrel) on purpose to avoid pulling the whole shell.diff --git a/lib/agent/server.ts b/lib/agent/server.tsindex e3d62081..76ff2b67 100644--- a/lib/agent/server.ts+++ b/lib/agent/server.ts@@ -1,5 +1,5 @@// SERVER-ONLY. Session gate for /api/v1 routes. Host fs/exec/sys are handled-// locally in @/lib/host (os-vps runs on the host). The former headless-browser+// locally in @/lib/host (mso runs on the host). The former headless-browser// bridge (OS_BROWSER_URL + OS_AGENT_TOKEN) was retired with the os-browser// service — the Browser app renders pages in a client-side iframe now.import { requireSession } from "@/lib/auth/require-session";diff --git a/lib/ai/codex-stream.ts b/lib/ai/codex-stream.tsindex ecb57fc4..ad86d12d 100644--- a/lib/ai/codex-stream.ts+++ b/lib/ai/codex-stream.ts@@ -32,7 +32,7 @@ export async function streamCodex(opts: {headers: {authorization: `Bearer ${bundle.access}`,originator: "codex_cli_rs",- "user-agent": "codex_cli_rs/0.0.0 (os-vps)",+ "user-agent": "codex_cli_rs/0.0.0 (mso)","chatgpt-account-id": bundle.accountId ?? "","openai-beta": "responses=experimental",accept: "text/event-stream",diff --git a/lib/ai/memory.test.ts b/lib/ai/memory.test.tsindex b0065fa6..0a4d3dcc 100644--- a/lib/ai/memory.test.ts+++ b/lib/ai/memory.test.ts@@ -2,12 +2,12 @@ import { describe, it, expect } from "vitest";import os from "node:os";import path from "node:path";-process.env.OS_MEMORY_STORE = path.join(os.tmpdir(), `osvps-memory-test-${process.pid}.json`);+process.env.OS_MEMORY_STORE = path.join(os.tmpdir(), `mso-memory-test-${process.pid}.json`);const { addMemory, recall, listMemories, removeMemory } = await import("./memory");describe("memory store + recall", () => {it("adds, recalls by word overlap, and removes", async () => {- const a = await addMemory("I deploy os-vps with pnpm build then restart");+ const a = await addMemory("I deploy mso with pnpm build then restart");await addMemory("My favorite color is blue");const hits = await recall("how do I deploy?");diff --git a/lib/ai/memory.ts b/lib/ai/memory.tsindex bd379c9e..b6d36b4a 100644--- a/lib/ai/memory.ts+++ b/lib/ai/memory.ts@@ -3,7 +3,7 @@ import os from "node:os";import path from "node:path";// Durable cross-session facts recalled into Alfa's system prompt. One JSON file in-// ~/.os-vps (small structured records, chmod 600). Recall is substring scoring for+// ~/.mso (small structured records, chmod 600). Recall is substring scoring for// now. ponytail: substring recall — swap for embeddings if it gets noisy at scale.export interface Memory {id: string;@@ -11,7 +11,7 @@ export interface Memory {createdAt: number;}-const FILE = process.env.OS_MEMORY_STORE || path.join(os.homedir(), ".os-vps", "memory.json");+const FILE = process.env.OS_MEMORY_STORE || path.join(os.homedir(), ".mso", "memory.json");async function read(): Promise<Memory[]> {try {diff --git a/lib/ai/threads.test.ts b/lib/ai/threads.test.tsindex 1ec754d0..8e0c4f8f 100644--- a/lib/ai/threads.test.ts+++ b/lib/ai/threads.test.ts@@ -4,7 +4,7 @@ import path from "node:path";import { promises as fs } from "node:fs";// Point the store at a temp dir BEFORE importing (the dir is read at module load).-process.env.OS_THREADS_DIR = path.join(os.tmpdir(), `osvps-threads-test-${process.pid}`);+process.env.OS_THREADS_DIR = path.join(os.tmpdir(), `mso-threads-test-${process.pid}`);const { saveThread, getThread, listThreads, deleteThread } = await import("./threads");describe("thread YAML store", () => {diff --git a/lib/ai/threads.ts b/lib/ai/threads.tsindex 00bcfd81..f4b3ecfd 100644--- a/lib/ai/threads.ts+++ b/lib/ai/threads.ts@@ -3,7 +3,7 @@ import os from "node:os";import path from "node:path";import { parse, stringify } from "yaml";-// Persistent Alfa chat threads — one YAML file per thread under ~/.os-vps/threads/.+// Persistent Alfa chat threads — one YAML file per thread under ~/.mso/threads/.// YAML (not JSON) so the session files stay human-readable (owner's call). `messages`// = the display bubbles; `history` = the wire turns needed to CONTINUE the chat.// Both are opaque to the server (stored/restored verbatim); the client owns the shape.@@ -18,7 +18,7 @@ export interface ChatThread {export type ThreadSummary = Pick<ChatThread, "id" | "title" | "createdAt" | "updatedAt">;-const DIR = process.env.OS_THREADS_DIR || path.join(os.homedir(), ".os-vps", "threads");+const DIR = process.env.OS_THREADS_DIR || path.join(os.homedir(), ".mso", "threads");// ids are app-generated but jail them anyway (path-traversal guard): alnum + -_ only.const safeId = (id: string) => id.replace(/[^a-zA-Z0-9_-]/g, "").slice(0, 64);const fileFor = (id: string) => path.join(DIR, `${safeId(id)}.yml`);diff --git a/lib/appearance/store.tsx b/lib/appearance/store.tsxindex 1626382b..9773e3cd 100644--- a/lib/appearance/store.tsx+++ b/lib/appearance/store.tsx@@ -16,7 +16,7 @@ import { normalizeLiveWallpaper, normalizeWallpaper } from "./wallpapers";import { ensureServerTargets } from "./server-targets";import { applyPreset, clearPreset } from "./presets/apply";-const KEY = "os-vps:tweaks";+const KEY = "mso:tweaks";function upgradeUnsplash(url: string): string {try {diff --git a/lib/auth/device-store.ts b/lib/auth/device-store.tsindex e3b64131..22cd403f 100644--- a/lib/auth/device-store.ts+++ b/lib/auth/device-store.ts@@ -29,10 +29,10 @@ interface DeviceStore {const MAX_PENDING = 50;-// os-vps runs as a host process (the deploy user's systemd service) → write our+// mso runs as a host process (the deploy user's systemd service) → write our// own file, no agent round-trip. Override with OS_DEVICE_STORE.const STORE_PATH =- process.env.OS_DEVICE_STORE ?? path.join(os.homedir(), ".os-vps", "auth-devices.json");+ process.env.OS_DEVICE_STORE ?? path.join(os.homedir(), ".mso", "auth-devices.json");// Device ids are client-generated 128-bit+ hex/uuid.const DEVICE_ID_RE = /^[a-f0-9-]{16,128}$/i;diff --git a/lib/auth/session-cookie.test.ts b/lib/auth/session-cookie.test.tsindex 07620a8d..7072f2b9 100644--- a/lib/auth/session-cookie.test.ts+++ b/lib/auth/session-cookie.test.ts@@ -11,7 +11,7 @@ const req = (host: string, forwarded?: string) =>headers: { host, ...(forwarded ? { "x-forwarded-host": forwarded } : {}) },});-const domainFor = (value: string | undefined, host = "os.rahmanef.com") => {+const domainFor = (value: string | undefined, host = "mso.rahmanef.com") => {if (value === undefined) delete process.env.OS_SESSION_COOKIE_DOMAIN;else process.env.OS_SESSION_COOKIE_DOMAIN = value;return sessionCookieDomain(req(host));@@ -29,21 +29,21 @@ describe("sessionCookieDomain", () => {});it("widens to the configured domain on the cockpit host", () => {- expect(domainFor("os.rahmanef.com")).toBe("os.rahmanef.com");+ expect(domainFor("mso.rahmanef.com")).toBe("mso.rahmanef.com");});it("widens on the split-origin app hosts (the whole point)", () => {- expect(domainFor("os.rahmanef.com", "hermes.os.rahmanef.com")).toBe("os.rahmanef.com");- expect(domainFor("os.rahmanef.com", "openclaw.os.rahmanef.com")).toBe("os.rahmanef.com");+ expect(domainFor("mso.rahmanef.com", "hermes.mso.rahmanef.com")).toBe("mso.rahmanef.com");+ expect(domainFor("mso.rahmanef.com", "openclaw.mso.rahmanef.com")).toBe("mso.rahmanef.com");});it("normalises a leading dot, casing, port and trailing dot", () => {- expect(domainFor(".OS.Rahmanef.com", "HERMES.os.rahmanef.com.:4005")).toBe("os.rahmanef.com");+ expect(domainFor(".MSO.Rahmanef.com", "HERMES.mso.rahmanef.com.:4005")).toBe("mso.rahmanef.com");});it.each([- ["os.rahmanef.com; Path=/", "attribute smuggling"],- ["os.rahmanef.com Path=/", "space"],+ ["mso.rahmanef.com; Path=/", "attribute smuggling"],+ ["mso.rahmanef.com Path=/", "space"],["os_rahmanef.com", "underscore"],["-bad.com", "leading hyphen"],["bad-.com", "trailing hyphen"],@@ -54,11 +54,11 @@ describe("sessionCookieDomain", () => {["os.rah\nmanef.com", "interior control char"],["ötzi.rahmanef.com", "non-ASCII (must be punycode)"],])("fails closed to host-only for %s (%s)", (value) => {- expect(domainFor(value, "hermes.os.rahmanef.com")).toBeUndefined();+ expect(domainFor(value, "hermes.mso.rahmanef.com")).toBeUndefined();});it("tolerates surrounding whitespace from a hand-edited env file", () => {- expect(domainFor(" os.rahmanef.com\n")).toBe("os.rahmanef.com");+ expect(domainFor(" mso.rahmanef.com\n")).toBe("mso.rahmanef.com");});it("fails closed when a label or the whole name is over length", () => {@@ -72,23 +72,23 @@ describe("sessionCookieDomain", () => {it("fails closed when the request host does not domain-match", () => {// Otherwise the browser drops the whole Set-Cookie and login 200s with no// session — a login loop with no error anywhere.- expect(domainFor("os.rahmanef.com", "76.13.23.37")).toBeUndefined();- expect(domainFor("os.rahmanef.com", "localhost")).toBeUndefined();+ expect(domainFor("mso.rahmanef.com", "76.13.23.37")).toBeUndefined();+ expect(domainFor("mso.rahmanef.com", "localhost")).toBeUndefined();// Suffix without a dot boundary is NOT a subdomain (RFC 6265 §5.1.3).- expect(domainFor("os.rahmanef.com", "notos.rahmanef.com")).toBeUndefined();+ expect(domainFor("mso.rahmanef.com", "notos.rahmanef.com")).toBeUndefined();});it("ignores x-forwarded-host while a real Host header is present", () => {// Host wins, so a client-settable header cannot steer the decision.- process.env.OS_SESSION_COOKIE_DOMAIN = "os.rahmanef.com";- expect(sessionCookieDomain(req("os.rahmanef.com", "evil.example"))).toBe("os.rahmanef.com");+ process.env.OS_SESSION_COOKIE_DOMAIN = "mso.rahmanef.com";+ expect(sessionCookieDomain(req("mso.rahmanef.com", "evil.example"))).toBe("mso.rahmanef.com");});});describe("sessionCookieAttrs", () => {it("keeps the host-only attribute set unchanged when no domain is configured", () => {delete process.env.OS_SESSION_COOKIE_DOMAIN;- expect(sessionCookieAttrs(req("os.rahmanef.com"), 86_400)).toEqual({+ expect(sessionCookieAttrs(req("mso.rahmanef.com"), 86_400)).toEqual({httpOnly: true,secure: true,sameSite: "strict",@@ -99,15 +99,15 @@ describe("sessionCookieAttrs", () => {it("adds only the Domain when configured — SameSite stays strict", () => {// Strict is correct across the app hosts: SameSite is per SITE (registrable- // domain), and os.rahmanef.com / hermes.os.rahmanef.com share rahmanef.com.- process.env.OS_SESSION_COOKIE_DOMAIN = "os.rahmanef.com";- expect(sessionCookieAttrs(req("os.rahmanef.com"), 0)).toEqual({+ // domain), and mso.rahmanef.com / hermes.mso.rahmanef.com share rahmanef.com.+ process.env.OS_SESSION_COOKIE_DOMAIN = "mso.rahmanef.com";+ expect(sessionCookieAttrs(req("mso.rahmanef.com"), 0)).toEqual({httpOnly: true,secure: true,sameSite: "strict",path: "/",maxAge: 0,- domain: "os.rahmanef.com",+ domain: "mso.rahmanef.com",});});});diff --git a/lib/auth/session-cookie.ts b/lib/auth/session-cookie.tsindex 4590de1d..44bea803 100644--- a/lib/auth/session-cookie.ts+++ b/lib/auth/session-cookie.ts@@ -21,7 +21,7 @@//// SameSite stays "strict" and the cross-origin iframe does NOT need it loosened:// SameSite is evaluated per SITE — scheme + registrable domain — not per origin.-// `os.rahmanef.com` and `hermes.os.rahmanef.com` share the registrable domain+// `mso.rahmanef.com` and `hermes.mso.rahmanef.com` share the registrable domain// `rahmanef.com` on the same scheme, so the frame's navigation and every// subresource it fetches are same-site (RFC 6265bis §5.2); for a nested document// the "site for cookies" is non-null when the top-level document and everydiff --git a/lib/camoufox/service.ts b/lib/camoufox/service.tsindex 238bdf53..9197adec 100644--- a/lib/camoufox/service.ts+++ b/lib/camoufox/service.ts@@ -2,7 +2,7 @@ import "server-only";import { runProgram } from "@/lib/managed-apps/runner";// The Camoufox display is a systemd USER unit (`~/.config/systemd/user/`), which is-// the whole reason this module can exist: os-vps runs as `User=rahman`, so+// the whole reason this module can exist: mso runs as `User=rahman`, so// `systemctl --user` needs neither sudo nor a polkit rule. It used to be a system// unit, and then nothing short of a root shell could stop it — the Browser app could// hide itself from the dock while a headless Firefox + Xvfb + x11vnc kept burning a@@ -46,8 +46,8 @@ async function show(): Promise<CamoufoxServiceStatus> {);// A failing systemctl is NOT the same answer as "no such unit", and collapsing// the two is how this reports "the browser is not installed on this host" when- // the truth is that os-vps cannot reach the user bus at all (a system unit gets- // no XDG_RUNTIME_DIR unless something sets it — see the os-vps.service drop-in).+ // the truth is that mso cannot reach the user bus at all (a system unit gets+ // no XDG_RUNTIME_DIR unless something sets it — see the mso.service drop-in).// Say which one it is; an unfixable-looking panel is worse than an error.if (result.code !== 0) {throw new Error(`systemctl --user failed (rc ${result.code}): ${result.stderr.trim().slice(0, 200) || "no output"}`);diff --git a/lib/config/store.ts b/lib/config/store.tsindex 9ffd86cd..05d94685 100644--- a/lib/config/store.ts+++ b/lib/config/store.ts@@ -19,7 +19,7 @@ export interface CustomProviderConn {/** An OAuth "sign in with…" token bundle (subscription providers). Stored in the* same 0600 host file as API keys — refresh tokens are account-scoped, so treat- * this file like an SSH key (which is already os-vps's trust boundary). */+ * this file like an SSH key (which is already mso's trust boundary). */export interface OAuthBundle {kind: "oauth";access: string;@@ -50,7 +50,7 @@ export interface OsConfig {}const CONFIG_PATH =- process.env.OS_CONFIG_STORE ?? path.join(os.homedir(), ".os-vps", "config.json");+ process.env.OS_CONFIG_STORE ?? path.join(os.homedir(), ".mso", "config.json");export const DEFAULT_MODEL = defaultModelFor(DEFAULT_PROVIDER);export { DEFAULT_PROVIDER };diff --git a/lib/host/audit.ts b/lib/host/audit.tsindex 94a29431..4ab15770 100644--- a/lib/host/audit.ts+++ b/lib/host/audit.ts@@ -3,7 +3,7 @@// commands MUST keep a tamper-evident record — if something goes wrong, this is// the only forensic trail. JSONL, one event per line, flushed best-effort.//-// Location: $OS_AUDIT_LOG, else ~/.os-vps/audit.log. Reads are NOT audited+// Location: $OS_AUDIT_LOG, else ~/.mso/audit.log. Reads are NOT audited// (bounded + high-volume); only state-changing actions are.import { promises as fs } from "fs";import os from "os";@@ -52,7 +52,7 @@ export interface AuditEntry {function auditPath(): string {const env = process.env.OS_AUDIT_LOG;if (env && env.trim()) return env.replace(/^~(?=$|\/)/, os.homedir());- return path.join(os.homedir(), ".os-vps", "audit.log");+ return path.join(os.homedir(), ".mso", "audit.log");}function trunc(s: string | undefined, max = 512): string | undefined {diff --git a/lib/host/child-env.ts b/lib/host/child-env.tsindex 211215d9..9279c8ba 100644--- a/lib/host/child-env.ts+++ b/lib/host/child-env.ts@@ -6,7 +6,7 @@// pass through unchanged (a real login shell still works).//// Residual (documented in SECURITY.md): a same-uid process can still read-// /proc/<pid>/environ of the os-vps process itself — the boundary is the OS+// /proc/<pid>/environ of the mso process itself — the boundary is the OS// user, not this scrub. This only stops the trivial in-terminal `printenv`.const SECRET_VARS = new Set(["OS_SESSION_SECRET",diff --git a/lib/host/destructive-patterns.test.ts b/lib/host/destructive-patterns.test.tsindex 8bb34cff..84cc5a7a 100644--- a/lib/host/destructive-patterns.test.ts+++ b/lib/host/destructive-patterns.test.ts@@ -5,7 +5,7 @@ describe("matchDestructive", () => {it("flags box-wrecking commands", () => {expect(matchDestructive("rm -rf /")).toBeTruthy();expect(matchDestructive("sudo shutdown now")).toBeTruthy();- expect(matchDestructive("systemctl stop os-vps")).toBeTruthy();+ expect(matchDestructive("systemctl stop mso")).toBeTruthy();expect(matchDestructive("mkfs.ext4 /dev/sda")).toBeTruthy();expect(matchDestructive("kill -9 1")).toBeTruthy();});diff --git a/lib/host/exec-filter.test.ts b/lib/host/exec-filter.test.tsindex 24b27162..5b967d34 100644--- a/lib/host/exec-filter.test.ts+++ b/lib/host/exec-filter.test.ts@@ -20,8 +20,8 @@ describe("destructiveReason blocks catastrophic commands", () => {["chmod -R 777 /", /recursive chmod\/chown/],["chown -R nobody /", /recursive chmod\/chown/],["systemctl stop nginx", /systemctl/],- ["systemctl restart os-vps.service", /systemctl/],- ["sudo systemctl disable os-vps", /systemctl/],+ ["systemctl restart mso.service", /systemctl/],+ ["sudo systemctl disable mso", /systemctl/],["service nginx restart", /service stop\/restart/],["service ssh stop", /service stop\/restart/],["shutdown -h now", /shutdown\/reboot\/poweroff/],@@ -128,7 +128,7 @@ describe("runCommand", () => {});it("refuses systemctl stop with a pointer to SSH", async () => {- const res = await runCommand("systemctl stop os-vps.service");+ const res = await runCommand("systemctl stop mso.service");expect(res.code).toBe(126);expect(res.stderr).toMatch(/refused/);expect(res.stderr).toMatch(/SSH/);diff --git a/lib/host/fs-zip.test.ts b/lib/host/fs-zip.test.tsindex d2d74691..2cc697e4 100644--- a/lib/host/fs-zip.test.ts+++ b/lib/host/fs-zip.test.ts@@ -24,7 +24,7 @@ describe("appSecretExcludes", () => {const appName = path.basename(appDir);it("strips the app's .env* when a PARENT is the archive base", () => {- // The exploit: zip ~/projects (parent) with os-vps nested inside.+ // The exploit: zip ~/projects (parent) with mso nested inside.expect(appSecretExcludes(path.dirname(appDir))).toEqual([`${appName}/.env`,`${appName}/.env.*`,@@ -59,7 +59,7 @@ describe("zipStream against the real zip binary", () => {};beforeAll(() => {- base = realpathSync(mkdtempSync(path.join(os.tmpdir(), "osvps-zip-")));+ base = realpathSync(mkdtempSync(path.join(os.tmpdir(), "mso-zip-")));process.env.OS_FS_READ_ROOTS = base;mkdirSync(path.join(base, "node_modules"), { recursive: true });mkdirSync(path.join(base, "proj", "node_modules"), { recursive: true });diff --git a/lib/host/fs.test.ts b/lib/host/fs.test.tsindex 48351d41..86eaa949 100644--- a/lib/host/fs.test.ts+++ b/lib/host/fs.test.ts@@ -25,7 +25,7 @@ let writeRoot = "";let outside = "";beforeAll(() => {- base = realpathSync(mkdtempSync(path.join(os.tmpdir(), "osvps-fs-")));+ base = realpathSync(mkdtempSync(path.join(os.tmpdir(), "mso-fs-")));readRoot = path.join(base, "read");writeRoot = path.join(readRoot, "write");outside = path.join(base, "outside");diff --git a/lib/host/index.ts b/lib/host/index.tsindex d243af16..9657e407 100644--- a/lib/host/index.ts+++ b/lib/host/index.ts@@ -1,5 +1,5 @@// Host facade — the single import for /api/v1 route handlers. All host access-// (fs/exec/sys) is LOCAL: os-vps runs as a host process, so it touches the+// (fs/exec/sys) is LOCAL: mso runs as a host process, so it touches the// filesystem and spawns commands directly. No external agent. Bounds + auth// live in paths.ts and the route's verifyAuth() gate.export { listDir, readFile, writeFile, makeDir, remove, move, copy, searchFs, usage, statReadable, fileStream } from "./fs";diff --git a/lib/host/paths-credentials.test.ts b/lib/host/paths-credentials.test.tsindex 0e64f5e1..3168d39b 100644--- a/lib/host/paths-credentials.test.ts+++ b/lib/host/paths-credentials.test.ts@@ -23,7 +23,7 @@ let fakeHome = "";let parent = ""; // ~/.local/share — denied by neither itself nor its parentbeforeAll(() => {- base = realpathSync(mkdtempSync(path.join(os.tmpdir(), "osvps-cred-")));+ base = realpathSync(mkdtempSync(path.join(os.tmpdir(), "mso-cred-")));fakeHome = path.join(base, "home");parent = path.join(fakeHome, ".local", "share");mkdirSync(path.join(parent, "keyrings"), { recursive: true });diff --git a/lib/host/paths.test.ts b/lib/host/paths.test.tsindex 4a27a2d1..0f848ea9 100644--- a/lib/host/paths.test.ts+++ b/lib/host/paths.test.ts@@ -25,7 +25,7 @@ let writeRoot = "";let outside = "";beforeAll(() => {- base = realpathSync(mkdtempSync(path.join(os.tmpdir(), "osvps-paths-")));+ base = realpathSync(mkdtempSync(path.join(os.tmpdir(), "mso-paths-")));readRoot = path.join(base, "read");writeRoot = path.join(readRoot, "write");outside = path.join(base, "outside");@@ -82,7 +82,7 @@ describe("resolveReadable bounds", () => {describe("credential denylist (read root = / so only the denylist gates)", () => {const home = os.homedir();const sshDir = path.join(home, ".ssh");- const storeDir = path.join(home, ".os-vps");+ const storeDir = path.join(home, ".mso");const envLocal = path.join(process.cwd(), ".env.local");const envExample = path.join(process.cwd(), ".env.example");@@ -91,7 +91,7 @@ describe("credential denylist (read root = / so only the denylist gates)", () =>await expect(resolveReadable(sshDir)).rejects.toThrow(/credential|sensitive/i);});- it.skipIf(!existsSync(storeDir))("blocks the ~/.os-vps config store", async () => {+ it.skipIf(!existsSync(storeDir))("blocks the ~/.mso config store", async () => {useRoots("/", writeRoot);await expect(resolveReadable(storeDir)).rejects.toThrow(/credential|sensitive/i);});diff --git a/lib/host/paths.ts b/lib/host/paths.tsindex 83525f36..5d6ead8d 100644--- a/lib/host/paths.ts+++ b/lib/host/paths.ts@@ -1,4 +1,4 @@-// SERVER-ONLY. Path resolution + bounds for host filesystem access. os-vps runs+// SERVER-ONLY. Path resolution + bounds for host filesystem access. mso runs// as a host process, so /api/v1 talks to the FS directly (no agent). READ and// WRITE roots are separate: reads can be wide (browse), writes are narrow so the// browser shell can't clobber system files. Symlinks are realpath-resolved BEFORE the@@ -45,7 +45,7 @@ export function isUnderRoot(target: string, root: string): boolean {// Credential denylist: even inside a legal root, the app's OWN secret files are// off-limits to the FS API. Reading .env.local would leak OS_SESSION_SECRET —// turning one stolen session into the ability to mint cookies forever — and-// ~/.os-vps holds the device allowlist, BYOK key and browser profile (cookies).+// ~/.mso holds the device allowlist, BYOK key and browser profile (cookies).// Other projects' .env files stay readable (session = owner, their call).const APP_DIR = (() => {try {@@ -100,7 +100,7 @@ export function isAppSecret(real: string): boolean {}function isCredentialPath(real: string): boolean {- const store = path.join(homeDir(), ".os-vps");+ const store = path.join(homeDir(), ".mso");if (real === store || isUnderRoot(real, store)) return true;if (isSensitivePath(real)) return true;const base = path.basename(real);@@ -133,7 +133,7 @@ function appSecretsUnder(realBase: string): string[] {function sensitiveUnder(realBase: string): string[] {if (process.env.OS_FS_ALLOW_SENSITIVE === "1") return [];const h = homeDir();- return [...SENSITIVE_HOME, ".os-vps"]+ return [...SENSITIVE_HOME, ".mso"].map((n) => path.join(h, n)).filter((p) => p !== realBase && isUnderRoot(p, realBase) && existsSync(p));}@@ -198,7 +198,7 @@ function assertNotCredential(real: string): void {// intermediate dir can't redirect the write outside), and (3) `full` is not a// credential/sensitive file — the same denylist writeFile/move/copy enforce but// the upload path was skipping (a session could otherwise drop-// ~/.ssh/authorized_keys or ~/.os-vps/auth-devices.json via /api/v1/fs/upload).+// ~/.ssh/authorized_keys or ~/.mso/auth-devices.json via /api/v1/fs/upload).export async function assertUploadTarget(full: string, destReal: string): Promise<void> {if (!isUnderRoot(full, destReal)) throw new HostError("Upload path escapes destination");for (let anc = path.dirname(full); ; ) {diff --git a/lib/managed-apps/backups.ts b/lib/managed-apps/backups.tsindex e97483a4..3d7771d7 100644--- a/lib/managed-apps/backups.ts+++ b/lib/managed-apps/backups.ts@@ -37,7 +37,7 @@ export function stateDirFor(definition: ManagedAppDefinition): string {}export function backupsRoot(id: ManagedAppId): string {- return path.join(os.homedir(), ".os-vps", "backups", id);+ return path.join(os.homedir(), ".mso", "backups", id);}export async function createBackup(definition: ManagedAppDefinition, reason: ManagedAppBackup["reason"]): Promise<ManagedAppBackup> {diff --git a/lib/managed-apps/install.test.ts b/lib/managed-apps/install.test.tsindex 7ba6b52c..ad93b6b9 100644--- a/lib/managed-apps/install.test.ts+++ b/lib/managed-apps/install.test.ts@@ -62,10 +62,10 @@ describe("install job options", () => {// allowlist, which reads as a broken dashboard on a gateway that is fine.// origin.ts reads the template at module load, so this needs a fresh graph.vi.resetModules();- vi.stubEnv("NEXT_PUBLIC_MANAGED_APP_HOST_TEMPLATE", "{id}.os.rahmanef.com");+ vi.stubEnv("NEXT_PUBLIC_MANAGED_APP_HOST_TEMPLATE", "{id}.mso.rahmanef.com");const fresh = await import("./install");await fresh.startInstall("openclaw");- expect(started().env?.MSO_INSTALL_APP_ORIGIN).toBe("https://openclaw.os.rahmanef.com");+ expect(started().env?.MSO_INSTALL_APP_ORIGIN).toBe("https://openclaw.mso.rahmanef.com");vi.unstubAllEnvs();});diff --git a/lib/managed-apps/install.ts b/lib/managed-apps/install.tsindex 353b9eb3..e67a01e2 100644--- a/lib/managed-apps/install.ts+++ b/lib/managed-apps/install.ts@@ -20,7 +20,7 @@ import type { ManagedAppId, ManagedAppJob } from "./types";// inside job-child.ts and dropped). So the argv stays two elements long and the// secret travels in the environment.-/** Where the sequence lives. Resolved against the server's cwd — os-vps runs+/** Where the sequence lives. Resolved against the server's cwd — mso runs* with `WorkingDirectory` at the repo root, and the script ships with the repo,* so a fresh clone on another machine needs no path configuration. */const INSTALL_SCRIPT = path.join(process.cwd(), "scripts", "managed-app-install");diff --git a/lib/managed-apps/job-child.test.ts b/lib/managed-apps/job-child.test.tsindex 4c3877f5..6d899cde 100644--- a/lib/managed-apps/job-child.test.ts+++ b/lib/managed-apps/job-child.test.ts@@ -56,7 +56,7 @@ describe("a child that leaves something behind holding its output", () => {// service it starts inherits the child's stdout. `close` waits for those// pipes to reach EOF, so it never fires — the job sat at `running` with// the lock held and every later action on the app answered 409, with no- // cure short of restarting os-vps.+ // cure short of restarting mso.const script = await stub("leaks-a-daemon",`const { spawn } = require("child_process");@@ -136,7 +136,7 @@ describe("what cancel refuses", () => {kind: "update",argv: [process.execPath, await stub("after-backup", 'console.log("ran");')],prepare: async (append) => {- append("[os-vps] pre-update backup\n");+ append("[mso] pre-update backup\n");await gate;},});diff --git a/lib/managed-apps/job-child.ts b/lib/managed-apps/job-child.tsindex 3b88d6a6..f2f3d812 100644--- a/lib/managed-apps/job-child.ts+++ b/lib/managed-apps/job-child.ts@@ -13,7 +13,7 @@ import type { ManagedAppJobStatus, StartManagedAppJobOptions } from "./types";// npm leaves helpers, a service the updater started inherits the same stdout.// Waiting on `close` alone therefore left the job `running` FOREVER — with the// app's operation lock held, so every later action on that app 409'd, and the-// only cure was restarting os-vps (which the docs tell the operator not to do+// only cure was restarting mso (which the docs tell the operator not to do// mid-update). Reproduced by killing the child's group exactly as the timeout// does: the child is reaped, the grandchild keeps the pipe, the job never ends.//@@ -103,7 +103,7 @@ export function spawnJobChild(argv: readonly string[], options: StartManagedAppJconst terminate = (why: string): void => {if (terminated) return;terminated = why;- hooks.append(`[os-vps] ${why} - terminating\n`);+ hooks.append(`[mso] ${why} - terminating\n`);signalTree(child, "SIGTERM");setTimeout(() => signalTree(child, "SIGKILL"), KILL_GRACE_MS).unref?.();};@@ -124,7 +124,7 @@ export function spawnJobChild(argv: readonly string[], options: StartManagedAppJ// The child is gone; only its pipes might not be. Wait a moment for the// tail of its output, then finish regardless — see the header.reaper = setTimeout(() => {- hooks.append(`[os-vps] the child exited but something it started still holds its output; finishing anyway\n`);+ hooks.append(`[mso] the child exited but something it started still holds its output; finishing anyway\n`);child.stdout?.destroy();child.stderr?.destroy();done(code, signal);diff --git a/lib/managed-apps/job-runner.ts b/lib/managed-apps/job-runner.tsindex 81ae716f..6e3bf118 100644--- a/lib/managed-apps/job-runner.ts+++ b/lib/managed-apps/job-runner.ts@@ -12,9 +12,9 @@ import type { ManagedAppId, ManagedAppJob, ManagedAppJobStatus, StartManagedAppJ//// THE CHILD IS IN-PROCESS — spawned by this server and killed with it. Detaching// would not change that, and believing otherwise is the dangerous mistake here:-// `systemctl show os-vps.service -p KillMode -p Delegate` says `control-group`+// `systemctl show mso.service -p KillMode -p Delegate` says `control-group`// and `no`, so stopping or restarting the unit SIGTERMs every pid in-// /system.slice/os-vps.service, and `detached: true` makes a new process GROUP,+// /system.slice/mso.service, and `detached: true` makes a new process GROUP,// never a new cgroup. (It is still passed — see job-child.ts: a timeout has to// signal git/pip/npm, not just the CLI that started them.) Surviving a// deploy for real would take `systemd-run --scope`, i.e. a second supervisor@@ -129,7 +129,7 @@ function finish(rt: Runtime, status: ManagedAppJobStatus, exitCode: number | nul/** Stop a job this process is running: the same SIGTERM its timeout would send,* up to an hour early. The way OUT of an operation that is stuck holding the- * app's lock — without it the only cure was restarting os-vps, which the docs+ * app's lock — without it the only cure was restarting mso, which the docs* tell the operator not to do mid-update.** It cannot end a healthy job by accident. It needs the job's exact 24-hex iddiff --git a/lib/managed-apps/job-store.test.ts b/lib/managed-apps/job-store.test.tsindex 49a85fab..01d6a9c3 100644--- a/lib/managed-apps/job-store.test.ts+++ b/lib/managed-apps/job-store.test.ts@@ -73,10 +73,10 @@ describe("a job whose owner is gone is interrupted, not running forever", () =>const read = await readJobRecord(stranded.id);expect(read?.status).toBe("interrupted");- expect(read?.error).toContain("os-vps stopped while this job was running");+ expect(read?.error).toContain("mso stopped while this job was running");expect(read?.endedAt).not.toBeNull();// The verdict is persisted, so every later reader agrees without re-deriving.- const onDisk = JSON.parse(await fs.readFile(path.join(home, ".os-vps", "managed-app-jobs", `${stranded.id}.json`), "utf8"));+ const onDisk = JSON.parse(await fs.readFile(path.join(home, ".mso", "managed-app-jobs", `${stranded.id}.json`), "utf8"));expect(onDisk.status).toBe("interrupted");});diff --git a/lib/managed-apps/job-store.ts b/lib/managed-apps/job-store.tsindex 4a699345..73230dd7 100644--- a/lib/managed-apps/job-store.ts+++ b/lib/managed-apps/job-store.ts@@ -5,7 +5,7 @@ import path from "node:path";import type { ManagedAppId, ManagedAppJob } from "./types";// Durable half of the job layer: one JSON file per job under-// ~/.os-vps/managed-app-jobs/ (0700 dir, 0600 files, tmp+rename), matching how+// ~/.mso/managed-app-jobs/ (0700 dir, 0600 files, tmp+rename), matching how// the device store and the config store already keep state. One file per job// rather than one index: a running job rewrites its own record every couple of// seconds and must never read-modify-write a file another job is appending to,@@ -27,7 +27,7 @@ export function isManagedAppJobId(value: unknown): value is string {}function jobsDir(): string {- return path.join(os.homedir(), ".os-vps", "managed-app-jobs");+ return path.join(os.homedir(), ".mso", "managed-app-jobs");}function pidAlive(pid: number): boolean {@@ -53,7 +53,7 @@ export function reconcile(record: ManagedAppJob): ManagedAppJob {...record,status: "interrupted",endedAt: new Date().toISOString(),- error: "os-vps stopped while this job was running; the child process was killed with it",+ error: "mso stopped while this job was running; the child process was killed with it",};}@@ -61,7 +61,7 @@ export async function writeJobRecord(record: ManagedAppJob): Promise<void> {const dir = jobsDir();await fs.mkdir(dir, { recursive: true, mode: 0o700 });const file = path.join(dir, `${record.id}.json`);- // pid in the tmp name: two os-vps processes sharing $HOME must not collide on+ // pid in the tmp name: two mso processes sharing $HOME must not collide on// one another's partial write.const tmp = `${file}.${process.pid}.tmp`;await fs.writeFile(tmp, JSON.stringify(record), { encoding: "utf8", mode: 0o600 });diff --git a/lib/managed-apps/jobs.test.ts b/lib/managed-apps/jobs.test.tsindex 877ce0fd..55fd1e45 100644--- a/lib/managed-apps/jobs.test.ts+++ b/lib/managed-apps/jobs.test.ts@@ -51,7 +51,7 @@ describe("a job outlives the request that started it", () => {// reason the layer exists, since the HTTP response cannot wait 30 minutes.expect(started.status).toBe("running");expect(started.endedAt).toBeNull();- const file = path.join(home, ".os-vps", "managed-app-jobs", `${started.id}.json`);+ const file = path.join(home, ".mso", "managed-app-jobs", `${started.id}.json`);expect((await fs.stat(file)).mode & 0o777).toBe(0o600);expect((await fs.stat(path.dirname(file))).mode & 0o777).toBe(0o700);diff --git a/lib/managed-apps/jobs.ts b/lib/managed-apps/jobs.tsindex 91b96ee4..8153c81f 100644--- a/lib/managed-apps/jobs.ts+++ b/lib/managed-apps/jobs.ts@@ -69,7 +69,7 @@ export async function startManagedAppJob(options: StartManagedAppJobOptions): Prif (!isManagedAppId(applicationId)) throw new Error("unknown managed application");if (!(MANAGED_APP_JOB_KINDS as readonly string[]).includes(kind)) throw new Error("unsupported managed application job");const argv = normaliseArgv(options.argv);- // Durable half of the lock. A second os-vps process on the same $HOME (a dev+ // Durable half of the lock. A second mso process on the same $HOME (a dev// server on :3000) has its own in-memory Map and would happily start a second// `hermes update` on the same git checkout; only the records are shared.// Jobs whose owner is gone were already reconciled away by listJobRecords().@@ -108,7 +108,7 @@ export async function readManagedAppJob(jobId: string, since = 0): Promise<Manag}/** Stop a running job's child, freeing the app's lock without restarting- * os-vps. `false` = there is no live, cancellable job with that id for that app+ * mso. `false` = there is no live, cancellable job with that id for that app* — an unknown id, one that already finished, one belonging to another app, or* one still inside its mandatory pre-flight backup. See job-runner's* `cancelJob` for why each of those refuses. Callers must not report `false` asdiff --git a/lib/managed-apps/lock.ts b/lib/managed-apps/lock.tsindex 0eade079..b1db496a 100644--- a/lib/managed-apps/lock.ts+++ b/lib/managed-apps/lock.ts@@ -8,7 +8,7 @@ import type { ManagedAppId } from "./types";//// In-memory ON PURPOSE, and that is the correct scope: every operation this// process holds the lock for — a `systemctl restart`, a backup, a 30-minute-// update — is executed BY this process and dies with it (os-vps.service is+// update — is executed BY this process and dies with it (mso.service is// KillMode=control-group, Delegate=no; see the jobs.ts header). A lock that// outlived the process would therefore be a claim about work that is no longer// running, and would wedge the app until someone deleted a file.@@ -16,7 +16,7 @@ import type { ManagedAppId } from "./types";// What must survive a restart is the RECORD, not the lock, and that is where// the durable half lives: job-store.ts reconciles a job whose owner process is// gone to `interrupted`, and startManagedAppJob() refuses to start while a-// record for the app is still live — which is also what stops a SECOND os-vps+// record for the app is still live — which is also what stops a SECOND mso// process on the same $HOME (a dev server on :3000) from running a concurrent// update, something no in-process Map could ever notice.diff --git a/lib/managed-apps/manager.test.ts b/lib/managed-apps/manager.test.tsindex 7349042d..4a531d4a 100644--- a/lib/managed-apps/manager.test.ts+++ b/lib/managed-apps/manager.test.ts@@ -96,7 +96,7 @@ describe("backup copies a real install instead of refusing it", () => {systemctl({ "openclaw-gateway.service": ACTIVE });await performManagedAppAction("openclaw", "backup");- const root = path.join(home, ".os-vps", "backups", "openclaw");+ const root = path.join(home, ".mso", "backups", "openclaw");const [stamp] = await fs.readdir(root);const backup = path.join(root, stamp);diff --git a/lib/managed-apps/origin.ts b/lib/managed-apps/origin.tsindex bb826962..45f2dc6f 100644--- a/lib/managed-apps/origin.ts+++ b/lib/managed-apps/origin.ts@@ -5,7 +5,7 @@// made them same-origin with the cockpit: upstream JS could reach `window.top` and// call /api/v1/exec with the user's session, and no CSP can stop it (CSP binds a// realm, not a reference across realms). So each app gets its OWN host, pointed at-// this same process: `hermes.os.rahmanef.com`, `openclaw.os.rahmanef.com`.+// this same process: `hermes.mso.rahmanef.com`, `openclaw.mso.rahmanef.com`.// `window.top` is then cross-origin and opaque.//// One host PER APP, not one shared host: a shared one would put Hermes and@@ -21,7 +21,7 @@// node:os). NEXT_PUBLIC_ because the iframe `src` is built in the browser.import { MANAGED_APP_IDS, type ManagedAppId } from "./types";-/** e.g. `{id}.os.rahmanef.com`. Empty/unset = single-origin mode. */+/** e.g. `{id}.mso.rahmanef.com`. Empty/unset = single-origin mode. */const TEMPLATE = process.env.NEXT_PUBLIC_MANAGED_APP_HOST_TEMPLATE?.trim() ?? "";const TOKEN = "{id}";@@ -47,7 +47,7 @@ export function managedAppIdForHost(host: string | null | undefined): ManagedAppreturn MANAGED_APP_IDS.find((id) => managedAppHost(id) === bare) ?? null;}-/** The name the app hosts live under (`{id}.os.rahmanef.com` → `os.rahmanef.com`).+/** The name the app hosts live under (`{id}.mso.rahmanef.com` → `mso.rahmanef.com`).* Deployment-owned; null in single-origin mode or when the leftover is a single* label ("com", ""), which is nobody's deployment. */function templateParent(): string | null {@@ -59,10 +59,10 @@ function templateParent(): string | null {}/** A host INSIDE the app namespace that is not one of the apps — e.g. someone adds- * `staging.os.rahmanef.com` pointing at this port, or a `*.os` wildcard appears.+ * `staging.mso.rahmanef.com` pointing at this port, or a `*.os` wildcard appears.** Such a host must 404, not serve the cockpit: the session cookie is widened to- * `Domain=os.rahmanef.com` so it is sent there, and a page on it would be+ * `Domain=mso.rahmanef.com` so it is sent there, and a page on it would be* same-origin with a full cockpit — the exact reach the split removes, handed back* by a DNS edit nobody connected to this file. Only the namespace is refused, never* the parent itself, so this cannot lock the operator out of the cockpit.@@ -93,8 +93,8 @@ export const MANAGED_APP_HOST_HEADER = "x-os-managed-app-host";* OS_PUBLIC_ORIGIN is not NEXT_PUBLIC — in the browser only the fallback* resolves, and every caller is server-side.*- * Fallback is the template's parent name (`{id}.os.rahmanef.com` →- * `https://os.rahmanef.com`), which is deployment-owned too. A wrong value fails+ * Fallback is the template's parent name (`{id}.mso.rahmanef.com` →+ * `https://mso.rahmanef.com`), which is deployment-owned too. A wrong value fails* CLOSED — naming the wrong origin means the frame is refused, which is visible.* null when nothing resolves, and the caller must then refuse framing outright* rather than guess. */diff --git a/lib/managed-apps/proxy-csp.test.ts b/lib/managed-apps/proxy-csp.test.tsindex 5030f4db..fc71661c 100644--- a/lib/managed-apps/proxy-csp.test.ts+++ b/lib/managed-apps/proxy-csp.test.ts@@ -6,8 +6,8 @@ import { describe, expect, it } from "vitest";import { contentSecurityPolicy } from "./proxy-csp";// The app is always root-mounted on its own host now; the cockpit is the framer.-const PREFIX_URL = "https://hermes.os.rahmanef.com/";-const COCKPIT = "https://os.rahmanef.com";+const PREFIX_URL = "https://hermes.mso.rahmanef.com/";+const COCKPIT = "https://mso.rahmanef.com";const MOUNT = { cockpitOrigin: COCKPIT };const OPENCLAW =@@ -17,7 +17,7 @@ const OPENCLAW ="media-src 'self' data: blob:; font-src 'self' https://fonts.gstatic.com; worker-src 'self'; " +"connect-src 'self' ws: wss: https://api.openai.com https://tweakcn.com";-const SOCKET = "wss://hermes.os.rahmanef.com/";+const SOCKET = "wss://hermes.mso.rahmanef.com/";const directive = (csp: string, name: string) =>csp@@ -34,9 +34,9 @@ describe("contentSecurityPolicy without an upstream policy (Hermes sends none)",for (const name of ["default-src", "connect-src", "form-action", "base-uri", "frame-src"]) {expect(directive(csp, name)).toContain(PREFIX_URL);}- expect(directive(csp, "connect-src")).toBe(`connect-src ${PREFIX_URL} wss://hermes.os.rahmanef.com/ data: blob:`);- expect("https://os.rahmanef.com/api/v1/exec".startsWith(PREFIX_URL)).toBe(false);- expect("https://os.rahmanef.com/api/v1/term".startsWith(PREFIX_URL)).toBe(false);+ expect(directive(csp, "connect-src")).toBe(`connect-src ${PREFIX_URL} wss://hermes.mso.rahmanef.com/ data: blob:`);+ expect("https://mso.rahmanef.com/api/v1/exec".startsWith(PREFIX_URL)).toBe(false);+ expect("https://mso.rahmanef.com/api/v1/term".startsWith(PREFIX_URL)).toBe(false);});it("never grants 'self' — that would re-open the origin via a nested iframe", () => {@@ -93,7 +93,7 @@ describe("contentSecurityPolicy intersected with the live OpenClaw policy", () =expect(directive(csp, "style-src")).toBe(`style-src ${PREFIX_URL} 'unsafe-inline' https://fonts.googleapis.com`);expect(directive(csp, "font-src")).toBe(`font-src ${PREFIX_URL} https://fonts.gstatic.com`);expect(directive(csp, "connect-src")).toBe(- `connect-src ${PREFIX_URL} wss://hermes.os.rahmanef.com/ https://api.openai.com https://tweakcn.com`,+ `connect-src ${PREFIX_URL} wss://hermes.mso.rahmanef.com/ https://api.openai.com https://tweakcn.com`,);// The upstream's bare `wss:` is not copied — it would be every host on earth.// The only socket source is the app's OWN origin, added by us: CSP matches the@@ -131,7 +131,7 @@ describe("contentSecurityPolicy refuses to be widened by the upstream", () => {it("never honours our own origin — that is the /api/v1/exec hole itself", () => {const csp = contentSecurityPolicy(PREFIX_URL,- "connect-src 'self' https://os.rahmanef.com https://os.rahmanef.com/api/v1/exec",+ "connect-src 'self' https://mso.rahmanef.com https://mso.rahmanef.com/api/v1/exec",MOUNT,);expect(directive(csp, "connect-src")).toBe(`connect-src ${PREFIX_URL} ${SOCKET}`);@@ -145,7 +145,7 @@ describe("contentSecurityPolicy refuses to be widened by the upstream", () => {MOUNT,);expect(directive(csp, "img-src")).toBe(`img-src ${PREFIX_URL} data:`);- expect(directive(csp, "connect-src")).toBe(`connect-src ${PREFIX_URL} wss://hermes.os.rahmanef.com/ data: blob:`);+ expect(directive(csp, "connect-src")).toBe(`connect-src ${PREFIX_URL} wss://hermes.mso.rahmanef.com/ data: blob:`);expect(csp).not.toContain("evil.example");expect(csp).not.toContain("tracker.example");expect(csp).not.toContain("unsafe-eval");@@ -193,7 +193,7 @@ describe("contentSecurityPolicy refuses to be widened by the upstream", () => {it("treats our own origin on another port, or trailing-dot, as ours — not external", () => {const csp = contentSecurityPolicy(PREFIX_URL,- "connect-src 'self' https://os.rahmanef.com:8443 https://os.rahmanef.com./x",+ "connect-src 'self' https://mso.rahmanef.com:8443 https://mso.rahmanef.com./x",MOUNT,);expect(directive(csp, "connect-src")).toBe(`connect-src ${PREFIX_URL} ${SOCKET}`);diff --git a/lib/managed-apps/proxy-csp.ts b/lib/managed-apps/proxy-csp.tsindex e66859e8..4600a4e0 100644--- a/lib/managed-apps/proxy-csp.ts+++ b/lib/managed-apps/proxy-csp.ts@@ -23,14 +23,14 @@ export interface PolicyMount {/** The cockpit origin. Root-mounted, the frame is CROSS-origin, so* frame-ancestors must name it or the browser refuses to display the dashboard.* It is also the one external host never honoured out of an upstream policy: a- * compromised upstream granting itself `connect-src https://os.rahmanef.com`+ * compromised upstream granting itself `connect-src https://mso.rahmanef.com`* would be calling the cockpit API from inside the frame. Missing ⇒ 'none',* because a frame that will not display is a visible failure while a guessed* framer is a silent invitation. */cockpitOrigin?: string | null;}-// Containment for the iframe: it runs on the os-vps origin with+// Containment for the iframe: it runs on the mso origin with// allow-same-origin, so without this any JS the upstream serves could fetch// /api/v1/exec with the cockpit session. CSP source expressions match fetch// directives by PATH PREFIX when the source ends in "/", so scoping every@@ -133,7 +133,7 @@ const isHash = (src: string) => /^'sha(?:256|384|512)-/i.test(src);const isScheme = (src: string) => /^[a-z][a-z0-9+.\-]*:$/i.test(src);// hostname, not host: `URL.host` carries the port, and cookies are port-agnostic,-// so `https://os.rahmanef.com:8443` must still count as our own origin. Trailing+// so `https://mso.rahmanef.com:8443` must still count as our own origin. Trailing// dot is the same name to DNS.const canonHost = (url: string): string | null => {try {@@ -165,7 +165,7 @@ function survives(src: string, theirs: string[], prefixUrl: string): boolean {// An upstream can rewrite its own policy at will, so a honoured source is capped:// https only, no wildcards, and NEVER our own origin — `connect-src-// https://os.rahmanef.com` from a compromised upstream would hand its JS+// https://mso.rahmanef.com` from a compromised upstream would hand its JS// /api/v1/exec, which is the one thing the scoping exists to prevent. The cockpit// is excluded separately because root-mounted it is no longer the same host as// prefixUrl, so `sameHost` alone would let the upstream name it.diff --git a/lib/managed-apps/proxy-headers.test.ts b/lib/managed-apps/proxy-headers.test.tsindex 3ce3a97d..e69f6c34 100644--- a/lib/managed-apps/proxy-headers.test.ts+++ b/lib/managed-apps/proxy-headers.test.ts@@ -12,7 +12,7 @@ import {} from "./proxy-headers";const PREFIX = proxyPrefix("hermes");-const PREFIX_URL = `https://os.rahmanef.com${PREFIX}/`;+const PREFIX_URL = `https://mso.rahmanef.com${PREFIX}/`;describe("publicProxyUrl", () => {afterEach(() => {@@ -20,7 +20,7 @@ describe("publicProxyUrl", () => {});it("prefers OS_PUBLIC_ORIGIN over anything a request can carry", () => {- process.env.OS_PUBLIC_ORIGIN = "https://os.rahmanef.com";+ process.env.OS_PUBLIC_ORIGIN = "https://mso.rahmanef.com";const spoofed = new Request(`http://localhost:4005${PREFIX}/chat`, {headers: { "x-forwarded-host": "evil.example", "x-forwarded-proto": "https", host: "evil.example" },});@@ -28,14 +28,14 @@ describe("publicProxyUrl", () => {});it("ignores a malformed OS_PUBLIC_ORIGIN instead of emitting junk", () => {- process.env.OS_PUBLIC_ORIGIN = "os.rahmanef.com";- const req = new Request(`http://localhost:4005${PREFIX}/chat`, { headers: { host: "os.rahmanef.com" } });- expect(publicProxyUrl(req, "hermes")).toBe(`http://os.rahmanef.com${PREFIX}/`);+ process.env.OS_PUBLIC_ORIGIN = "mso.rahmanef.com";+ const req = new Request(`http://localhost:4005${PREFIX}/chat`, { headers: { host: "mso.rahmanef.com" } });+ expect(publicProxyUrl(req, "hermes")).toBe(`http://mso.rahmanef.com${PREFIX}/`);});it("trusts the real Host header over a client-settable X-Forwarded-Host", () => {const spoofed = new Request(`http://localhost:4005${PREFIX}/chat`, {- headers: { host: "os.rahmanef.com", "x-forwarded-host": "evil.example", "x-forwarded-proto": "https" },+ headers: { host: "mso.rahmanef.com", "x-forwarded-host": "evil.example", "x-forwarded-proto": "https" },});// The host decides which origin the whole policy is scoped to.expect(publicProxyUrl(spoofed, "hermes")).toBe(PREFIX_URL);@@ -43,14 +43,14 @@ describe("publicProxyUrl", () => {it("uses the hop the browser made, not the plain-http hop from Traefik", () => {const req = new Request(`http://localhost:4005${PREFIX}/chat`, {- headers: { "x-forwarded-proto": "https,http", "x-forwarded-host": "os.rahmanef.com" },+ headers: { "x-forwarded-proto": "https,http", "x-forwarded-host": "mso.rahmanef.com" },});expect(publicProxyUrl(req, "hermes")).toBe(PREFIX_URL);});it("falls back to the Host header, then to the request URL", () => {- const withHost = new Request(`http://localhost:4005${PREFIX}/chat`, { headers: { host: "os.rahmanef.com" } });- expect(publicProxyUrl(withHost, "hermes")).toBe(`http://os.rahmanef.com${PREFIX}/`);+ const withHost = new Request(`http://localhost:4005${PREFIX}/chat`, { headers: { host: "mso.rahmanef.com" } });+ expect(publicProxyUrl(withHost, "hermes")).toBe(`http://mso.rahmanef.com${PREFIX}/`);expect(publicProxyUrl(new Request(`http://localhost:4005${PREFIX}/chat`), "hermes")).toBe(`http://localhost:4005${PREFIX}/`,);@@ -60,7 +60,7 @@ describe("publicProxyUrl", () => {describe("buildUpstreamHeaders", () => {const base = new URL("http://127.0.0.1:9119");const withHeaders = (init: Record<string, string>) =>- new Request("https://hermes.os.rahmanef.com/api/config", { headers: init });+ new Request("https://hermes.mso.rahmanef.com/api/config", { headers: init });it("forwards Hermes' own session token, because dropping it 401s every fetch", () => {// Loopback Hermes injects an ephemeral token into the SPA HTML and requires itdiff --git a/lib/managed-apps/proxy-headers.ts b/lib/managed-apps/proxy-headers.tsindex 37e8700c..0822450a 100644--- a/lib/managed-apps/proxy-headers.ts+++ b/lib/managed-apps/proxy-headers.ts@@ -3,14 +3,14 @@//// Cookie model: every cookie crossing the boundary is namespaced per app AND// pinned to that app's proxy path. An upstream (Hermes, OpenClaw) therefore can-// neither read nor overwrite the os-vps `session` cookie — which is unprefixed+// neither read nor overwrite the mso `session` cookie — which is unprefixed// and Path=/ — nor a sibling managed app's cookies.// `authorization` is deliberately NOT forwarded and `www-authenticate` is// deliberately NOT returned: together they turn the proxy into a credential// relay — an upstream Basic challenge would make the browser prompt on the-// os-vps origin and then preemptively attach that Authorization header to other-// os-vps paths, which we would forward onward.+// mso origin and then preemptively attach that Authorization header to other+// mso paths, which we would forward onward.const REQUEST_HEADERS = ["accept","accept-language",@@ -56,8 +56,8 @@ const RESPONSE_HEADERS = [];// Cookie NAMESPACE, not a path. Load-bearing on an app host too: the cockpit-// session cookie now carries Domain=os.rahmanef.com, so it IS sent to-// hermes.os.rahmanef.com — and Hermes' own cookies are `hermes_session_at` /+// session cookie now carries Domain=mso.rahmanef.com, so it IS sent to+// hermes.mso.rahmanef.com — and Hermes' own cookies are `hermes_session_at` /// `_rt` / `_provider` / `_pkce` / `hermes_sso_attempt`, any of which could just as// easily have been called `session` (OpenClaw sets none at all today).export const cookiePrefix = (id: string): string => `mapp_${id}_`;@@ -69,7 +69,7 @@ export const cookiePrefix = (id: string): string => `mapp_${id}_`;export const proxyPrefix = (id: string): string => `/api/v1/managed-apps/${id}/proxy`;// Browser → upstream: keep ONLY our namespaced cookies and restore the real-// names. Anything else (`session`, `os-vps-device`, …) never leaves the host.+// names. Anything else (`session`, `mso-device`, …) never leaves the host.export function upstreamCookieHeader(raw: string | null, prefix: string): string | null {if (!raw) return null;const out: string[] = [];@@ -231,7 +231,7 @@ export function rewriteLocation(raw: string, target: URL, base: URL, id: string,}// Service workers are the one thing a proxied bundle can leave behind: registered-// from proxied bytes they install on the OS-VPS origin, scoped to this prefix,+// from proxied bytes they install on the MSO origin, scoped to this prefix,// and keep answering fetches after the window is closed. OpenClaw's control UI// does exactly that — `navigator.serviceWorker.register(new URL(ct('sw.js'), …))`// where `ct()` derives its base from window.location.pathname, i.e. our prefix.diff --git a/lib/managed-apps/redact.test.ts b/lib/managed-apps/redact.test.tsindex 5c61fa0f..9df3b518 100644--- a/lib/managed-apps/redact.test.ts+++ b/lib/managed-apps/redact.test.ts@@ -9,7 +9,7 @@ import { redact } from "./redact";/** Assembled from the shapes actually seen in `hermes update` / `openclaw* update` output, plus the two journald formats getManagedAppLogs asks for. */const TRANSCRIPT = [- "[os-vps] pre-update backup of /home/rahman/.hermes",+ "[mso] pre-update backup of /home/rahman/.hermes","npm WARN deprecated [email protected]: This module is not supported","npm notice New major version of npm available! 10.8.2 -> 11.0.0","added 412 packages, and audited 413 packages in 9s",@@ -26,7 +26,7 @@ const TRANSCRIPT = ["2026-07-25T10:11:12.345Z INFO update complete in 42s","Jul 25 10:11:12 srv614914 openclaw-gateway[1234]: token bucket refilled, 5 left","2026-07-25T10:11:13+0000 hermes-dashboard[9119]: listening on 127.0.0.1:9119",- "[os-vps] restored 314 files (12.4 MB)",+ "[mso] restored 314 files (12.4 MB)",];describe("secrets that reached a persisted transcript before this widened", () => {diff --git a/lib/managed-apps/restore.test.ts b/lib/managed-apps/restore.test.tsindex be32c413..b724c9eb 100644--- a/lib/managed-apps/restore.test.ts+++ b/lib/managed-apps/restore.test.ts@@ -48,7 +48,7 @@ afterEach(async () => {/** A snapshot directory written by hand — the shape an attacker or a bad copy* would leave behind, which `createBackup` would never produce. */async function planted(id: string, manifest: Record<string, unknown> | null, files: Record<string, string> = {}): Promise<string> {- const dir = path.join(home, ".os-vps", "backups", "hermes", id);+ const dir = path.join(home, ".mso", "backups", "hermes", id);await fs.mkdir(dir, { recursive: true });if (manifest) await fs.writeFile(path.join(dir, "manifest.json"), JSON.stringify(manifest));for (const [name, body] of Object.entries(files)) await fs.writeFile(path.join(dir, name), body);@@ -111,7 +111,7 @@ describe("what restore refuses before a byte moves", () => {await fs.writeFile(outside, "untouched");const backup = await createBackup(definition(), "manual");// A file in the snapshot whose counterpart in the state dir became a link.- await fs.writeFile(path.join(home, ".os-vps", "backups", "hermes", backup.id, "token.txt"), "would follow the link");+ await fs.writeFile(path.join(home, ".mso", "backups", "hermes", backup.id, "token.txt"), "would follow the link");await fs.symlink(outside, path.join(state, "token.txt"));await fs.writeFile(path.join(state, "config.yaml"), "version: 2\n");await fs.writeFile(path.join(state, "sessions", "one.json"), '{"kept":true}');@@ -168,7 +168,7 @@ describe("what a restore actually does", () => {// The undo: the state as it was a moment ago, saved before the overwrite.const safety = (await listBackups("hermes")).find((entry) => entry.id === result.safetyBackupId);expect(safety?.reason).toBe("pre-restore");- expect(await fs.readFile(path.join(home, ".os-vps", "backups", "hermes", result.safetyBackupId, "config.yaml"), "utf8")).toBe("version: 2\n");+ expect(await fs.readFile(path.join(home, ".mso", "backups", "hermes", result.safetyBackupId, "config.yaml"), "utf8")).toBe("version: 2\n");const transcript = lines.join("");expect(transcript).toContain("NOT restored (never in a snapshot)");diff --git a/lib/managed-apps/restore.ts b/lib/managed-apps/restore.tsindex 630ecfa6..7405fbf8 100644--- a/lib/managed-apps/restore.ts+++ b/lib/managed-apps/restore.ts@@ -146,12 +146,12 @@ export async function restoreManagedAppBackup(id: ManagedAppId, backupId: stringconst { dir, source } = await resolveSource(id, backupId);const target = await resolveTarget(definition, source);await assertNoSymlinkCollisions(dir, target);- append(`[os-vps] restoring ${backupId} into ${target}\n`);+ append(`[mso] restoring ${backupId} into ${target}\n`);// The undo. Taken AFTER the gates so a refused restore does not litter, and// before the first write so the current state is always recoverable.const safety = await createBackup(definition, "pre-restore");- append(`[os-vps] current state saved as ${safety.id} (${safety.files ?? "?"} files) before overwriting\n`);+ append(`[mso] current state saved as ${safety.id} (${safety.files ?? "?"} files) before overwriting\n`);const manifestFile = path.join(dir, "manifest.json");let filesRestored = 0;@@ -191,9 +191,9 @@ export async function restoreManagedAppBackup(id: ManagedAppId, backupId: string}const notRestored = [...BACKUP_SKIPPED_DIRS];- append(`[os-vps] restored ${filesRestored} files (${(bytesRestored / 1024 / 1024).toFixed(1)} MB)\n`);- append(`[os-vps] NOT restored (never in a snapshot): ${notRestored.join(", ")}\n`);- append("[os-vps] files created since the snapshot were left in place - a restore overwrites, it does not delete\n");- append(`[os-vps] undo this with backup ${safety.id}\n`);+ append(`[mso] restored ${filesRestored} files (${(bytesRestored / 1024 / 1024).toFixed(1)} MB)\n`);+ append(`[mso] NOT restored (never in a snapshot): ${notRestored.join(", ")}\n`);+ append("[mso] files created since the snapshot were left in place - a restore overwrites, it does not delete\n");+ append(`[mso] undo this with backup ${safety.id}\n`);return { applicationId: id, backupId, target, filesRestored, bytesRestored, safetyBackupId: safety.id, notRestored, overwriteOnly: true };}diff --git a/lib/managed-apps/types.ts b/lib/managed-apps/types.tsindex 15685973..c6796af3 100644--- a/lib/managed-apps/types.ts+++ b/lib/managed-apps/types.ts@@ -84,7 +84,7 @@ export interface ManagedAppJob {/** Random per-server-process id. A record naming a runner that is gone was* killed with it: the child never outlives the server (see jobs.ts). */runnerId: string;- /** pid of the os-vps process that owns the job — NOT the child's. */+ /** pid of the mso process that owns the job — NOT the child's. */serverPid: number;/** Last write. A running job heartbeats, so this doubles as liveness. */updatedAt: string;diff --git a/lib/managed-apps/update-types.ts b/lib/managed-apps/update-types.tsindex 26221326..be14c6ed 100644--- a/lib/managed-apps/update-types.ts+++ b/lib/managed-apps/update-types.ts@@ -79,7 +79,7 @@ export interface ManagedAppUpdateOptions {noRestart?: boolean;}-/** One snapshot under `~/.os-vps/backups/<id>/`, as its manifest records it. */+/** One snapshot under `~/.mso/backups/<id>/`, as its manifest records it. */export interface ManagedAppBackup {/** The stamp directory name. It is also a path segment and an API parameter,* so it is pattern-checked before it is ever joined to a path. */diff --git a/lib/managed-apps/update.test.ts b/lib/managed-apps/update.test.tsindex ad746a72..bd5b7575 100644--- a/lib/managed-apps/update.test.ts+++ b/lib/managed-apps/update.test.ts@@ -44,7 +44,7 @@ afterEach(async () => {});/** A stub CLI on PATH. `body` is sh because the shell is the TEST's tool, not- * the product's — os-vps never spawns one (`shell: false` everywhere). */+ * the product's — mso never spawns one (`shell: false` everywhere). */async function stub(name: string, body: string): Promise<void> {await fs.writeFile(path.join(bin, name), `#!/bin/sh\n${body}\n`, { mode: 0o755 });}@@ -125,7 +125,7 @@ describe("a backup gates the update it is protecting", () => {const [backup] = await listBackups("hermes");expect(backup.reason).toBe("pre-update");expect(backup.files).toBe(1);- expect(await fs.readFile(path.join(home, ".os-vps", "backups", "hermes", backup.id, "config.yaml"), "utf8")).toBe("state: kept\n");+ expect(await fs.readFile(path.join(home, ".mso", "backups", "hermes", backup.id, "config.yaml"), "utf8")).toBe("state: kept\n");// Order is visible in the transcript: the backup lines land before the// child's first byte because `prepare` runs before anything spawns.expect(job.log.indexOf("pre-update backup")).toBeLessThan(job.log.indexOf("done"));diff --git a/lib/managed-apps/update.ts b/lib/managed-apps/update.tsindex 91e0b75c..3aa3fde5 100644--- a/lib/managed-apps/update.ts+++ b/lib/managed-apps/update.ts@@ -111,7 +111,7 @@ const exists = (target: string): Promise<boolean> =>* update" (jobs.ts `prepare`). Null = there was nothing to snapshot. */async function snapshot(definition: ManagedAppDefinition, reason: ManagedAppBackup["reason"], append: (text: string) => void): Promise<ManagedAppBackup | null> {const source = stateDirFor(definition);- append(`[os-vps] ${reason} backup of ${source}\n`);+ append(`[mso] ${reason} backup of ${source}\n`);// UNINSTALL only: a missing state dir left an app whose data was already// removed by hand permanently un-uninstallable — the job died here and the// uninstall never ran, with no way out through the UI. There is nothing left to@@ -119,7 +119,7 @@ async function snapshot(definition: ManagedAppDefinition, reason: ManagedAppBack// dir is also the install (Hermes' is a git checkout), so its absence means// something is wrong that an update should not paper over.if (reason === "pre-uninstall" && !(await exists(source))) {- append(`[os-vps] nothing to back up - ${source} does not exist\n`);+ append(`[mso] nothing to back up - ${source} does not exist\n`);return null;}let backup: ManagedAppBackup;@@ -129,11 +129,11 @@ async function snapshot(definition: ManagedAppDefinition, reason: ManagedAppBackthrow new Error(`${reason} backup failed, nothing was run: ${message(error)}`);}const mb = backup.bytes === null ? "?" : (backup.bytes / 1024 / 1024).toFixed(1);- append(`[os-vps] backup ${backup.id} - ${backup.files ?? "?"} files, ${mb} MB\n`);+ append(`[mso] backup ${backup.id} - ${backup.files ?? "?"} files, ${mb} MB\n`);// Said out loud every time, because it is what makes this a STATE snapshot// rather than an install image: restoring it will not rebuild a git checkout// or a node_modules tree.- append(`[os-vps] not in the backup (and not restorable from it): ${backup.skipped.dirNames.join(", ")}\n`);+ append(`[mso] not in the backup (and not restorable from it): ${backup.skipped.dirNames.join(", ")}\n`);return backup;}diff --git a/lib/os-api/index.tsx b/lib/os-api/index.tsxindex de096bec..82e2e861 100644--- a/lib/os-api/index.tsx+++ b/lib/os-api/index.tsx@@ -33,7 +33,7 @@ export function zipUrl(return "/api/v1/fs/zip?" + p.toString();}-// os-vps adapter injection: pick mock (default) ↔ live, then hand the concrete+// mso adapter injection: pick mock (default) ↔ live, then hand the concrete// api to the framework's HostApiProvider (which owns the context useOsApi reads).// Live talks to SAME-ORIGIN `/api/v1` route handlers (base url ""); the signed// session cookie rides along, the routes verify it, then proxy to the host agentdiff --git a/lib/os-api/mock-data.ts b/lib/os-api/mock-data.tsindex 0317b053..5e976cfe 100644--- a/lib/os-api/mock-data.ts+++ b/lib/os-api/mock-data.ts@@ -83,7 +83,7 @@ export const MOCK_ROOTS: FsRoot[] = [// Demo persistence — the mock FS tree (folder/file STRUCTURE, not file bytes)// is mirrored to localStorage so a visitor's sandbox survives a page reload.// Bytes are intentionally not stored (5 MB cap + binary); reads stay mock.-const DEMO_FS_KEY = "os-vps:demo-fs";+const DEMO_FS_KEY = "mso:demo-fs";const DEMO_FS_VERSION = 2;export function loadDemoTree(): Record<string, FsEntry[]> {diff --git a/lib/os-api/types.ts b/lib/os-api/types.tsindex 1bc95e26..b9f0bd46 100644--- a/lib/os-api/types.ts+++ b/lib/os-api/types.ts@@ -1,7 +1,7 @@// os-rr Cloud API contract — the single boundary between the OS and the VPS.// The OsApi PORT + host data types now live in the appshell framework// (appshell/lib/host-api) so app slices import them via a legal alias; this-// module keeps the os-vps CONFIG + the concrete adapters (http/mock) that+// module keeps the mso CONFIG + the concrete adapters (http/mock) that// satisfy the port. MockAdapter simulates in-browser; HttpAdapter calls the agent.export const API_VERSION = "v1";diff --git a/lib/prefs/store.test.ts b/lib/prefs/store.test.tsindex a33a4a0e..3fe11955 100644--- a/lib/prefs/store.test.ts+++ b/lib/prefs/store.test.ts@@ -9,7 +9,7 @@ let dir: string;let file: string;beforeEach(async () => {- dir = await fs.mkdtemp(path.join(os.tmpdir(), "os-vps-prefs-"));+ dir = await fs.mkdtemp(path.join(os.tmpdir(), "mso-prefs-"));file = path.join(dir, "prefs.json");process.env.OS_PREFS_PATH = file;});diff --git a/lib/prefs/store.ts b/lib/prefs/store.tsindex 234cab24..97936681 100644--- a/lib/prefs/store.ts+++ b/lib/prefs/store.ts@@ -20,7 +20,7 @@ export interface OsPrefs {// Resolved lazily (not module-level) so tests can point OS_PREFS_PATH at a tmp dir.function prefsPath(): string {- return process.env.OS_PREFS_PATH ?? path.join(os.homedir(), ".os-vps", "prefs.json");+ return process.env.OS_PREFS_PATH ?? path.join(os.homedir(), ".mso", "prefs.json");}export async function readPrefs(): Promise<OsPrefs> {diff --git a/lib/prefs/use-prefs-sync.ts b/lib/prefs/use-prefs-sync.tsindex 5fece97a..520a9ce3 100644--- a/lib/prefs/use-prefs-sync.ts+++ b/lib/prefs/use-prefs-sync.ts@@ -6,7 +6,7 @@ import { IS_DEMO } from "@/lib/demo";const DEBOUNCE_MS = 1500;/** Fired by the auth slice when a login lands (providers mount outside AuthGate). */-export const AUTHED_EVENT = "os-vps:authed";+export const AUTHED_EVENT = "mso:authed";// Shared server-sync seam for the appearance + quicklinks providers. Offline-first:// mount → GET /api/prefs → apply the stored section (server wins on initial load) →diff --git a/lib/quicklinks/store.tsx b/lib/quicklinks/store.tsxindex d1be3bb5..da065f18 100644--- a/lib/quicklinks/store.tsx+++ b/lib/quicklinks/store.tsx@@ -18,16 +18,16 @@ import { usePrefsSync } from "@/lib/prefs/use-prefs-sync";// pops a new native browser tab.export type Quicklink = { id: string; title: string; url: string };-const KEY = "os-vps:quicklinks";+const KEY = "mso:quicklinks";// Seed for a fresh visitor (localStorage/server-synced edits win once present).// Keep defaults generic: the public demo should not look connected to a real// personal account or private server.const DEFAULTS: Quicklink[] = [- { id: "repo", title: "MSO GitHub", url: "https://github.com/rahmanef63/os-vps" },- { id: "docs", title: "Install docs", url: "https://github.com/rahmanef63/os-vps/blob/main/docs/INSTALL.md" },- { id: "demo", title: "Demo script", url: "https://github.com/rahmanef63/os-vps/blob/main/docs/DEMO-SCRIPT.md" },- { id: "security", title: "Security policy", url: "https://github.com/rahmanef63/os-vps/blob/main/SECURITY.md" },+ { id: "repo", title: "MSO GitHub", url: "https://github.com/rahmanef63/mso" },+ { id: "docs", title: "Install docs", url: "https://github.com/rahmanef63/mso/blob/main/docs/INSTALL.md" },+ { id: "demo", title: "Demo script", url: "https://github.com/rahmanef63/mso/blob/main/docs/DEMO-SCRIPT.md" },+ { id: "security", title: "Security policy", url: "https://github.com/rahmanef63/mso/blob/main/SECURITY.md" },];type Ctx = {diff --git a/next.config.mjs b/next.config.mjsindex 9acff477..cf9f4ff0 100644--- a/next.config.mjs+++ b/next.config.mjs@@ -9,7 +9,7 @@ const nextConfig = {// Don't advertise the framework/version — the shell is now public; minimize// the fingerprint an unauthenticated visitor can use for CVE matching.poweredByHeader: false,- // Cache Components off: os-vps is a fully dynamic app (auth-gated OS shell,+ // Cache Components off: mso is a fully dynamic app (auth-gated OS shell,// no SSG marketing pages), so static prerendering adds no value and conflicts// with the auth provider's cookie reads. Re-enable only if static routes land.cacheComponents: false,diff --git a/os-browser/README.md b/os-browser/README.mdindex e25e66fb..2aeaeecc 100644--- a/os-browser/README.md+++ b/os-browser/README.md@@ -1,11 +1,11 @@# os-browser — headless Chromium service for the Browser appA tiny HTTP wrapper around a REAL Playwright Chromium running on the VPS.-The os-vps Browser app proxies to it server-to-server, so any site renders+The mso Browser app proxies to it server-to-server, so any site renders(no `X-Frame-Options` problem — it's a browser, not an iframe). One-persistent profile (`~/.os-vps/chrome-profile`) keeps logins across restarts.+persistent profile (`~/.mso/chrome-profile`) keeps logins across restarts.-Optional: without it, every other os-vps app still works.+Optional: without it, every other mso app still works.## Run@@ -31,7 +31,7 @@ OS_BROWSER_SECRET=<the same secret>| `OS_BROWSER_SECRET` | — (required, ≥16) | Shared secret; never reaches the client || `OS_BROWSER_PORT` | `4002` | Listen port || `OS_BROWSER_HOST` | `127.0.0.1` | **Keep loopback.** Override only behind a private bridge |-| `OS_BROWSER_PROFILE` | `~/.os-vps/chrome-profile` | Persistent browser profile dir |+| `OS_BROWSER_PROFILE` | `~/.mso/chrome-profile` | Persistent browser profile dir |## Securitydiff --git a/os-browser/server.mjs b/os-browser/server.mjsindex e73efe75..b799c64e 100644--- a/os-browser/server.mjs+++ b/os-browser/server.mjs@@ -9,7 +9,7 @@ import { chromium } from "playwright";// stick across restarts) but ONE PAGE PER CONSUMER: the human viewer ("ui") and// the agent ("agent") each get their own tab, so they never fight over the same// page — while still SHARING the login/profile (a tab is cheap; a second-// Chromium would not be). Loopback + secret; os-vps is the only caller. An+// Chromium would not be). Loopback + secret; mso is the only caller. An// http(s) target CAN reach LAN/metadata by design, so never expose this port and// never let an unauthenticated relay forward here.@@ -17,7 +17,7 @@ const PORT = Number(process.env.OS_BROWSER_PORT || 4002);const HOST = process.env.OS_BROWSER_HOST || "127.0.0.1";const SECRET = process.env.OS_BROWSER_SECRET || "";const USER_DATA_DIR =- process.env.OS_BROWSER_PROFILE || path.join(os.homedir(), ".os-vps", "chrome-profile");+ process.env.OS_BROWSER_PROFILE || path.join(os.homedir(), ".mso", "chrome-profile");const VIEWPORT = {width: Number(process.env.OS_BROWSER_WIDTH || 1280),height: Number(process.env.OS_BROWSER_HEIGHT || 800),diff --git a/package.json b/package.jsonindex bbb8f775..94af7808 100644--- a/package.json+++ b/package.json@@ -1,5 +1,5 @@{- "name": "os-vps",+ "name": "mso","version": "0.2.0","private": true,"engines": {diff --git a/proxy-websocket.test.ts b/proxy-websocket.test.tsindex 6454532f..4abdb5d2 100644--- a/proxy-websocket.test.ts+++ b/proxy-websocket.test.ts@@ -9,7 +9,7 @@ import { signSession } from "./lib/auth/session";const approved = vi.hoisted(() => ({ value: true }));vi.mock("@/lib/auth/device-store", () => ({ isApproved: async () => approved.value }));-const TEMPLATE = "{id}.os.rahmanef.com";+const TEMPLATE = "{id}.mso.rahmanef.com";/** Env is read at module load, so each case needs a fresh module graph. */async function loadProxy(template: string) {@@ -57,24 +57,24 @@ describe("WebSocket upgrade on an app host", () => {it("hands an authenticated upgrade to the app's own loopback gateway", async () => {const proxy = await load();- const res = await proxy(upgradeReq("openclaw.os.rahmanef.com", "/chat?tab=1", session()));+ const res = await proxy(upgradeReq("openclaw.mso.rahmanef.com", "/chat?tab=1", session()));// Cross-origin destination = Next proxies it; that fork IS the transport.expect(rewriteOf(res)).toBe(`${GATEWAY}/chat?tab=1`);});it("refuses an upgrade carrying no session — nothing downstream would have", async () => {const proxy = await load();- const res = await proxy(upgradeReq("openclaw.os.rahmanef.com"));+ const res = await proxy(upgradeReq("openclaw.mso.rahmanef.com"));expect(res.status).toBe(404);expect(rewriteOf(res)).toBeNull();});it("refuses a forged cookie, and a real one whose device was revoked", async () => {const proxy = await load();- expect((await proxy(upgradeReq("openclaw.os.rahmanef.com", "/", "not-a-real-cookie"))).status).toBe(404);+ expect((await proxy(upgradeReq("openclaw.mso.rahmanef.com", "/", "not-a-real-cookie"))).status).toBe(404);// Valid HMAC is not enough: revoking a device must kill its live sockets too.approved.value = false;- expect((await proxy(upgradeReq("openclaw.os.rahmanef.com", "/", session()))).status).toBe(404);+ expect((await proxy(upgradeReq("openclaw.mso.rahmanef.com", "/", session()))).status).toBe(404);});it("refuses to relay off-box when the gateway env points somewhere public", async () => {@@ -82,12 +82,12 @@ describe("WebSocket upgrade on an app host", () => {vi.stubEnv("OS_SESSION_SECRET", SECRET);approved.value = true;const proxy = await loadProxy(TEMPLATE);- expect((await proxy(upgradeReq("openclaw.os.rahmanef.com", "/", session()))).status).toBe(404);+ expect((await proxy(upgradeReq("openclaw.mso.rahmanef.com", "/", session()))).status).toBe(404);});it("leaves the cockpit host alone — the branch is app-hosts only", async () => {const proxy = await load();- const res = await proxy(upgradeReq("os.rahmanef.com", "/apps", session()));+ const res = await proxy(upgradeReq("mso.rahmanef.com", "/apps", session()));// Not merely "not the gateway" — the cockpit is not rewritten at all, so a// session-bearing upgrade there can never become a relay into an agent.expect(rewriteOf(res)).toBeNull();@@ -96,7 +96,7 @@ describe("WebSocket upgrade on an app host", () => {it("does not fire for an ordinary request that merely mentions upgrade", async () => {const proxy = await load();const res = await proxy(- req("openclaw.os.rahmanef.com", "/chat", { upgrade: "h2c", cookie: `session=${session()}` }),+ req("openclaw.mso.rahmanef.com", "/chat", { upgrade: "h2c", cookie: `session=${session()}` }),);expect(rewriteOf(res)).toContain("/api/v1/managed-apps/openclaw/proxy");});@@ -132,13 +132,13 @@ describe("per-app upgrade adapters", () => {it("never relays the cockpit session cookie into an agent process", async () => {// OS_SESSION_COOKIE_DOMAIN widens that cookie to the app hosts, so the browser// sends it here. The HTTP path has always stripped it; the upgrade did not.- for (const host of ["hermes.os.rahmanef.com", "openclaw.os.rahmanef.com"]) {+ for (const host of ["hermes.mso.rahmanef.com", "openclaw.mso.rahmanef.com"]) {expect((await upstream(host, "/")).header("cookie")).toBeNull();}});it("presents Hermes the loopback Host/Origin its rebinding guard demands", async () => {- const { rewrite, header } = await upstream("hermes.os.rahmanef.com", "/api/pty?ticket=t1&channel=c");+ const { rewrite, header } = await upstream("hermes.mso.rahmanef.com", "/api/pty?ticket=t1&channel=c");expect(rewrite).toBe("http://127.0.0.1:9119/api/pty?ticket=t1&channel=c");// This assertion used to be the exact opposite, on the premise that Hermes binds// 0.0.0.0 and accepts any Origin. It binds 127.0.0.1, and FastAPI runs no HTTP@@ -154,13 +154,13 @@ describe("per-app upgrade adapters", () => {});it("presents OpenClaw the REAL browser origin, so an allowlist entry can match it", async () => {- const { rewrite, header } = await upstream("openclaw.os.rahmanef.com", "/chat");+ const { rewrite, header } = await upstream("openclaw.mso.rahmanef.com", "/chat");expect(rewrite).toBe("http://127.0.0.1:18789/chat");// Rewriting this to the loopback origin looked like consistency with the HTTP// path and was the opposite of a fix: OpenClaw matches its allowedOrigins against// the origin AS PRESENTED, so a rewritten one is exactly what would stop the// operator adding this host to that list from working.- expect(header("origin")).toBe("https://openclaw.os.rahmanef.com");+ expect(header("origin")).toBe("https://openclaw.mso.rahmanef.com");});});// The Camoufox VNC bridge — noVNC over websockify in front of x11vnc, i.e. live@@ -186,7 +186,7 @@ describe("the camoufox VNC bridge", () => {}const vnc = (cookie?: string, path = "/camoufox-vnc/vnc_lite.html", extra: Record<string, string> = {}) =>- req("os.rahmanef.com", path, cookie ? { cookie: `session=${cookie}`, ...extra } : extra);+ req("mso.rahmanef.com", path, cookie ? { cookie: `session=${cookie}`, ...extra } : extra);it("404s a request with no cookie at all", async () => {const proxy = await load();diff --git a/proxy.test.ts b/proxy.test.tsindex 2f0f88f4..875202ec 100644--- a/proxy.test.ts+++ b/proxy.test.ts@@ -11,7 +11,7 @@ import { afterEach, describe, expect, it, vi } from "vitest";import { NextRequest } from "next/server";-const TEMPLATE = "{id}.os.rahmanef.com";+const TEMPLATE = "{id}.mso.rahmanef.com";const HERMES = "/api/v1/managed-apps/hermes/proxy";const APP_HOST_HEADER = "x-os-managed-app-host";@@ -50,19 +50,19 @@ describe("app host → that app's proxy, and nothing else", () => {["/sessions/", `${HERMES}/sessions`],])("rewrites %s into the proxy", async (path, expected) => {const proxy = await loadProxy(TEMPLATE);- const res = await proxy(req("hermes.os.rahmanef.com", path));+ const res = await proxy(req("hermes.mso.rahmanef.com", path));expect(new URL(rewriteOf(res)!).pathname).toBe(expected);});it("preserves the query string", async () => {const proxy = await loadProxy(TEMPLATE);- const res = await proxy(req("hermes.os.rahmanef.com", "/login?next=%2Fchat"));- expect(rewriteOf(res)).toBe(`https://hermes.os.rahmanef.com${HERMES}/login?next=%2Fchat`);+ const res = await proxy(req("hermes.mso.rahmanef.com", "/login?next=%2Fchat"));+ expect(rewriteOf(res)).toBe(`https://hermes.mso.rahmanef.com${HERMES}/login?next=%2Fchat`);});it("routes each host to its OWN app — one origin per app, never a shared one", async () => {const proxy = await loadProxy(TEMPLATE);- const res = await proxy(req("openclaw.os.rahmanef.com", "/chat"));+ const res = await proxy(req("openclaw.mso.rahmanef.com", "/chat"));expect(new URL(rewriteOf(res)!).pathname).toBe("/api/v1/managed-apps/openclaw/proxy/chat");expect(stampedHost(res)).toBe("openclaw");});@@ -77,7 +77,7 @@ describe("app host → that app's proxy, and nothing else", () => {["the service worker", "/sw.js"],])("sends %s into the app proxy instead of the cockpit", async (_label, path) => {const proxy = await loadProxy(TEMPLATE);- const res = await proxy(req("hermes.os.rahmanef.com", path, { headers: { "sec-fetch-site": "same-origin" } }));+ const res = await proxy(req("hermes.mso.rahmanef.com", path, { headers: { "sec-fetch-site": "same-origin" } }));const rewritten = new URL(rewriteOf(res)!).pathname;expect(rewritten).toBe(`${HERMES}${path}`);// Whatever the upstream answers, it is not the cockpit route of that name.@@ -91,7 +91,7 @@ describe("app host → that app's proxy, and nothing else", () => {"404s %s on an app host",async (path) => {const proxy = await loadProxy(TEMPLATE);- const res = await proxy(req("hermes.os.rahmanef.com", path));+ const res = await proxy(req("hermes.mso.rahmanef.com", path));expect(res.status).toBe(404);expect(rewriteOf(res)).toBeNull();},@@ -100,14 +100,14 @@ describe("app host → that app's proxy, and nothing else", () => {// Hermes' index.html links `/favicon.ico`, so this one belongs to the app.it("still proxies /favicon.ico, which the dashboard serves itself", async () => {const proxy = await loadProxy(TEMPLATE);- expect(new URL(rewriteOf(await proxy(req("hermes.os.rahmanef.com", "/favicon.ico")))!).pathname).toBe(+ expect(new URL(rewriteOf(await proxy(req("hermes.mso.rahmanef.com", "/favicon.ico")))!).pathname).toBe(`${HERMES}/favicon.ico`,);});it("never stamps the cockpit document policy on an app host", async () => {const proxy = await loadProxy(TEMPLATE);- const res = await proxy(req("hermes.os.rahmanef.com", "/"));+ const res = await proxy(req("hermes.mso.rahmanef.com", "/"));// The route sets its own, scoped to the app origin — see proxy-csp.ts.expect(res.headers.get("content-security-policy")).toBeNull();expect(res.headers.get("x-middleware-request-x-nonce")).toBeNull();@@ -117,13 +117,13 @@ describe("app host → that app's proxy, and nothing else", () => {const proxy = await loadProxy(TEMPLATE);// Forged, it would buy root-mounted mode: upstream cookies at Path=/ and a// policy naming the cockpit as a legal framer.- const res = await proxy(req("hermes.os.rahmanef.com", "/", { headers: { [APP_HOST_HEADER]: "openclaw" } }));+ const res = await proxy(req("hermes.mso.rahmanef.com", "/", { headers: { [APP_HOST_HEADER]: "openclaw" } }));expect(stampedHost(res)).toBe("hermes");});it("leaves a host that is not an app host on the cockpit", async () => {const proxy = await loadProxy(TEMPLATE);- const res = await proxy(req("os.rahmanef.com", "/apps"));+ const res = await proxy(req("mso.rahmanef.com", "/apps"));expect(rewriteOf(res)).toBeNull();expect(res.headers.get("content-security-policy")).toContain("default-src 'self'");});@@ -134,9 +134,9 @@ describe("app host → that app's proxy, and nothing else", () => {// host and claims the cockpit, which would reach /api/v1/exec with a session// cookie that IS sent here.const res = await proxy(- req("hermes.os.rahmanef.com", "/api/v1/exec/run", {+ req("hermes.mso.rahmanef.com", "/api/v1/exec/run", {method: "POST",- headers: { "x-forwarded-host": "os.rahmanef.com", "sec-fetch-site": "same-origin" },+ headers: { "x-forwarded-host": "mso.rahmanef.com", "sec-fetch-site": "same-origin" },}),);expect(new URL(rewriteOf(res)!).pathname).toBe(`${HERMES}/api/v1/exec/run`);@@ -149,7 +149,7 @@ describe("CSRF depth-2 on an app host", () => {it("passes the frame's own same-origin form POST", async () => {const proxy = await loadProxy(TEMPLATE);const res = await proxy(- req("hermes.os.rahmanef.com", "/auth/password-login", {+ req("hermes.mso.rahmanef.com", "/auth/password-login", {method: "POST",headers: { "sec-fetch-site": "same-origin" },}),@@ -166,7 +166,7 @@ describe("CSRF depth-2 on an app host", () => {])("blocks a mutating request from %s", async (_label, site) => {const proxy = await loadProxy(TEMPLATE);const res = await proxy(- req("hermes.os.rahmanef.com", "/api/tasks", { method: "POST", headers: { "sec-fetch-site": site } }),+ req("hermes.mso.rahmanef.com", "/api/tasks", { method: "POST", headers: { "sec-fetch-site": site } }),);expect(res.status).toBe(403);expect(rewriteOf(res)).toBeNull();@@ -175,31 +175,31 @@ describe("CSRF depth-2 on an app host", () => {it("falls back to an Origin host match for non-browser clients", async () => {const proxy = await loadProxy(TEMPLATE);const ok = await proxy(- req("hermes.os.rahmanef.com", "/api/tasks", {+ req("hermes.mso.rahmanef.com", "/api/tasks", {method: "POST",- headers: { origin: "https://hermes.os.rahmanef.com" },+ headers: { origin: "https://hermes.mso.rahmanef.com" },}),);expect(rewriteOf(ok)).not.toBeNull();const bad = await proxy(- req("hermes.os.rahmanef.com", "/api/tasks", { method: "POST", headers: { origin: "https://evil.example" } }),+ req("hermes.mso.rahmanef.com", "/api/tasks", { method: "POST", headers: { origin: "https://evil.example" } }),);expect(bad.status).toBe(403);});it("still routes a GET, which mutates nothing", async () => {const proxy = await loadProxy(TEMPLATE);- const res = await proxy(req("hermes.os.rahmanef.com", "/chat", { headers: { "sec-fetch-site": "cross-site" } }));+ const res = await proxy(req("hermes.mso.rahmanef.com", "/chat", { headers: { "sec-fetch-site": "cross-site" } }));expect(new URL(rewriteOf(res)!).pathname).toBe(`${HERMES}/chat`);});});-// The session cookie is widened to Domain=os.rahmanef.com, so ANY host under that+// The session cookie is widened to Domain=mso.rahmanef.com, so ANY host under that// name receives it. A host in the namespace that is not one of the apps must// therefore 404 rather than serve the cockpit — otherwise adding a DNS record is// enough to hand a page a fully authenticated cockpit, with no code change at all.describe("an unclaimed host inside the app namespace serves nothing", () => {- it.each(["staging.os.rahmanef.com", "deep.sub.os.rahmanef.com", "xhermes.os.rahmanef.com"])("404s %s", async (host) => {+ it.each(["staging.mso.rahmanef.com", "deep.sub.mso.rahmanef.com", "xhermes.mso.rahmanef.com"])("404s %s", async (host) => {const proxy = await loadProxy(TEMPLATE);for (const path of ["/", "/api/v1/exec/run", "/api/auth/login", "/_next/static/chunks/main.js"]) {const res = await proxy(req(host, path));@@ -210,18 +210,18 @@ describe("an unclaimed host inside the app namespace serves nothing", () => {it("refuses only the namespace: the cockpit, its siblings and single-origin mode all still serve", async () => {const split = await loadProxy(TEMPLATE);- for (const host of ["os.rahmanef.com", "api-os.rahmanef.com", "rahmanef.com"]) {+ for (const host of ["mso.rahmanef.com", "api-mso.rahmanef.com", "rahmanef.com"]) {expect((await split(req(host, "/files"))).status).toBe(200);}const single = await loadProxy("");- expect((await single(req("staging.os.rahmanef.com", "/files"))).status).toBe(200);+ expect((await single(req("staging.mso.rahmanef.com", "/files"))).status).toBe(200);});});describe("single-origin mode (template unset) is unchanged", () => {it("stamps a nonce + document policy on a page", async () => {const proxy = await loadProxy("");- const res = await proxy(req("os.rahmanef.com", "/files"));+ const res = await proxy(req("mso.rahmanef.com", "/files"));const csp = res.headers.get("content-security-policy")!;expect(csp).toContain("frame-ancestors 'none'");expect(csp).toMatch(/script-src 'self' 'nonce-[^']+' 'strict-dynamic'/);@@ -231,7 +231,7 @@ describe("single-origin mode (template unset) is unchanged", () => {it("waves through the paths the matcher used to exclude, with no policy", async () => {const proxy = await loadProxy("");for (const path of ["/_next/static/chunks/main.js", "/_next/image?url=%2Fx.png", "/favicon.ico"]) {- const res = await proxy(req("os.rahmanef.com", path));+ const res = await proxy(req("mso.rahmanef.com", path));expect(res.status).toBe(200);expect(res.headers.get("content-security-policy")).toBeNull();expect(res.headers.get("x-middleware-request-x-nonce")).toBeNull();@@ -240,17 +240,17 @@ describe("single-origin mode (template unset) is unchanged", () => {it("never treats an app-shaped host as an app host", async () => {const proxy = await loadProxy("");- const res = await proxy(req("hermes.os.rahmanef.com", "/"));+ const res = await proxy(req("hermes.mso.rahmanef.com", "/"));expect(rewriteOf(res)).toBeNull();});it("still blocks a cross-site mutating /api and leaves reads alone", async () => {const proxy = await loadProxy("");const blocked = await proxy(- req("os.rahmanef.com", "/api/v1/exec/run", { method: "POST", headers: { "sec-fetch-site": "cross-site" } }),+ req("mso.rahmanef.com", "/api/v1/exec/run", { method: "POST", headers: { "sec-fetch-site": "cross-site" } }),);expect(blocked.status).toBe(403);- const read = await proxy(req("os.rahmanef.com", "/api/v1/sys/status"));+ const read = await proxy(req("mso.rahmanef.com", "/api/v1/sys/status"));expect(read.status).toBe(200);expect(read.headers.get("content-security-policy")).toBeNull();});@@ -259,7 +259,7 @@ describe("single-origin mode (template unset) is unchanged", () => {// destination) lives in proxy-websocket.test.ts, which has the session harness.it("does not let an unverified cookie near the camoufox VNC bridge", async () => {const proxy = await loadProxy("");- const res = await proxy(req("os.rahmanef.com", "/camoufox-vnc/", { headers: { cookie: "session=anything" } }));+ const res = await proxy(req("mso.rahmanef.com", "/camoufox-vnc/", { headers: { cookie: "session=anything" } }));expect(res.status).toBe(404);expect(res.headers.get("x-middleware-rewrite")).toBeNull();});@@ -272,7 +272,7 @@ describe("the app-host header is never accepted from a client", () => {// at the old same-origin URL — cookies at Path=/ and the cockpit named as a// permitted framer, i.e. exactly the hole the split closes.const res = await proxy(- req("os.rahmanef.com", `${HERMES}/chat`, { headers: { [APP_HOST_HEADER]: "hermes" } }),+ req("mso.rahmanef.com", `${HERMES}/chat`, { headers: { [APP_HOST_HEADER]: "hermes" } }),);expect(stampedHost(res)).toBeNull();expect(res.headers.get("x-middleware-override-headers") ?? "").not.toContain(APP_HOST_HEADER);@@ -280,7 +280,7 @@ describe("the app-host header is never accepted from a client", () => {it("strips it from a cockpit document request too", async () => {const proxy = await loadProxy(TEMPLATE);- const res = await proxy(req("os.rahmanef.com", "/apps", { headers: { [APP_HOST_HEADER]: "hermes" } }));+ const res = await proxy(req("mso.rahmanef.com", "/apps", { headers: { [APP_HOST_HEADER]: "hermes" } }));expect(stampedHost(res)).toBeNull();});});diff --git a/proxy.ts b/proxy.tsindex 3d0d29cf..5f64ac02 100644--- a/proxy.ts+++ b/proxy.ts@@ -3,7 +3,7 @@// NEXT_PUBLIC_MANAGED_APP_HOST_TEMPLATE) EVERY path is rewritten into that// app's proxy route, so the dashboard is root-mounted at "/" on its own origin// and the cockpit — pages, /api/v1/exec, /api/auth/* — does not exist there.-// That gating is what makes the widened session cookie (Domain=os.rahmanef.com)+// That gating is what makes the widened session cookie (Domain=mso.rahmanef.com)// safe to hand to those hosts.// 2. CSRF depth-2 for mutating /api — every /api route already verifies the// signed session cookie via requireSession(); this adds the second factor@@ -150,7 +150,7 @@ export async function proxy(request: NextRequest) {const host = request.headers.get("host") ?? request.nextUrl.host;const managedApp = managedAppIdForHost(host);- // A host inside the app namespace that is NOT an app (a new `X.os.rahmanef.com`+ // A host inside the app namespace that is NOT an app (a new `X.mso.rahmanef.com`// record, or a `*.os` wildcard) must not serve the cockpit: the session cookie is// widened to that name, so such a host would be same-origin with a fully// authenticated cockpit — the reach the split exists to remove, re-opened by a DNSdiff --git a/scripts/approve-device.js b/scripts/approve-device.jsindex 024537c1..a968ebb3 100644--- a/scripts/approve-device.js+++ b/scripts/approve-device.js@@ -1,20 +1,20 @@#!/usr/bin/env node-// Seed / list / revoke trusted login devices for os-vps (no Convex — flat JSON,+// Seed / list / revoke trusted login devices for mso (no Convex — flat JSON,// same model as the VPS Control Room).//// node scripts/approve-device.js <deviceId> [label] # approve a device// node scripts/approve-device.js --list # show approved + pending// node scripts/approve-device.js --revoke <deviceId> # un-trust a device//-// Store path = ~/.os-vps/auth-devices.json unless OS_DEVICE_STORE is set (must-// match what the os-vps service sees).+// Store path = ~/.mso/auth-devices.json unless OS_DEVICE_STORE is set (must+// match what the mso service sees).const fs = require("fs");const os = require("os");const path = require("path");const STORE =- process.env.OS_DEVICE_STORE || path.join(os.homedir(), ".os-vps", "auth-devices.json");+ process.env.OS_DEVICE_STORE || path.join(os.homedir(), ".mso", "auth-devices.json");const DEVICE_ID_RE = /^[a-f0-9-]{16,128}$/i;function read() {diff --git a/scripts/camoufox-vnc-service b/scripts/camoufox-vnc-serviceindex a22ed450..bf23363b 100755--- a/scripts/camoufox-vnc-service+++ b/scripts/camoufox-vnc-service@@ -92,7 +92,7 @@ fi# one display silently opened THREE listeners: 127.0.0.1:$VNC_PORT, [::1]:$VNC_PORT and# [::1]:5900. The v6 pair bypasses websockify, noVNC and the session gate in proxy.ts# entirely — reachable with a plain `ssh -L` — which is the one thing "only through-# os-vps" forbids. -noipv6 alone drops [::1]:$VNC_PORT but NOT [::1]:5900: that one is+# mso" forbids. -noipv6 alone drops [::1]:$VNC_PORT but NOT [::1]:5900: that one is# libvncserver's own IPv6 port, which x11vnc does not route through its noipv6 flag, so it# has to be disabled by hand with -rfbportv6 -1 (verified against this build: with only# -noipv6, ss still showed [::1]:5900). websockify below dials the IPv4 literal, sodiff --git a/scripts/e2e.sh b/scripts/e2e.shindex 817106a2..874121d1 100755--- a/scripts/e2e.sh+++ b/scripts/e2e.sh@@ -16,24 +16,24 @@ if curl -fso /dev/null "$E2E_URL"; thenfi"$BROWSER" health >/dev/null || { echo "os-browser service down"; exit 1; }-NEXT_PUBLIC_OS_DEMO=1 npx next dev -p "$E2E_PORT" >/tmp/osvps-e2e-next.log 2>&1 &+NEXT_PUBLIC_OS_DEMO=1 npx next dev -p "$E2E_PORT" >/tmp/mso-e2e-next.log 2>&1 &SERVER=$!trap 'kill "$SERVER" 2>/dev/null' EXITfor _ in $(seq 1 90); docurl -fso /dev/null "$E2E_URL" && breaksleep 0.5done-curl -fso /dev/null "$E2E_URL" || { echo "server never came up"; tail -20 /tmp/osvps-e2e-next.log; exit 1; }+curl -fso /dev/null "$E2E_URL" || { echo "server never came up"; tail -20 /tmp/mso-e2e-next.log; exit 1; }pass=0 fail=0for check in scripts/e2e/*.sh; do[ -e "$check" ] || continuename="$(basename "$check" .sh)"if [ "$#" -gt 0 ]; then case " $* " in *" $name "*) ;; *) continue ;; esac; fi- if bash "$check" >"/tmp/osvps-e2e-$name.log" 2>&1; then+ if bash "$check" >"/tmp/mso-e2e-$name.log" 2>&1; thenecho "PASS $name"; pass=$((pass + 1))else- echo "FAIL $name — /tmp/osvps-e2e-$name.log:"; tail -5 "/tmp/osvps-e2e-$name.log"; fail=$((fail + 1))+ echo "FAIL $name — /tmp/mso-e2e-$name.log:"; tail -5 "/tmp/mso-e2e-$name.log"; fail=$((fail + 1))fidoneecho "e2e: $pass pass, $fail fail"diff --git a/scripts/gen-readme-media.mjs b/scripts/gen-readme-media.mjsindex 0376cc7e..dd682afa 100644--- a/scripts/gen-readme-media.mjs+++ b/scripts/gen-readme-media.mjs@@ -1,5 +1,5 @@#!/usr/bin/env node-// Regenerate the README demo (docs/media/demo.gif) against a LIVE os-vps instance,+// Regenerate the README demo (docs/media/demo.gif) against a LIVE mso instance,// so the recording tracks the current UI.//// OS_MEDIA_DEVICE=<approved-device-id> node scripts/gen-readme-media.mjs@@ -22,7 +22,7 @@ import { chromium } from "../os-browser/node_modules/playwright/index.mjs";const ROOT = path.join(path.dirname(fileURLToPath(import.meta.url)), "..");const OUT = path.join(ROOT, "docs", "media");-const TMP = path.join(os.tmpdir(), "os-vps-media");+const TMP = path.join(os.tmpdir(), "mso-media");const BASE = process.env.OS_MEDIA_BASE || "http://127.0.0.1:4005";const DEVICE = process.env.OS_MEDIA_DEVICE;if (!DEVICE) throw new Error("set OS_MEDIA_DEVICE=<approved-device-id> (scripts/approve-device.js --list)");@@ -42,7 +42,7 @@ const host = new URL(BASE).hostname;const cookie = { name: "session", value: `${enc}.${sig}`, domain: host, path: "/" };const seed = () => {localStorage.setItem("sv:shell", JSON.stringify({ desktop: "macos", mobile: "ios" }));- localStorage.setItem("os-vps:tweaks", JSON.stringify({ theme: "dark" }));+ localStorage.setItem("mso:tweaks", JSON.stringify({ theme: "dark" }));};const wait = (p, ms) => p.waitForTimeout(ms);diff --git a/scripts/install.sh b/scripts/install.shindex 9df91d1e..bf3f7a0f 100755--- a/scripts/install.sh+++ b/scripts/install.sh@@ -1,7 +1,7 @@#!/usr/bin/env bash-# os-vps (Manef Shell OS) one-command installer — fresh single-owner Linux VPS.+# mso (Manef Shell OS) one-command installer — fresh single-owner Linux VPS.#-# curl -fsSL https://raw.githubusercontent.com/rahmanef63/os-vps/main/scripts/install.sh | bash+# curl -fsSL https://raw.githubusercontent.com/rahmanef63/mso/main/scripts/install.sh | bash## Idempotent: re-running updates the checkout, rebuilds, and restarts the# service. Fully non-interactive (safe for curl|bash — no tty): the login@@ -10,12 +10,12 @@set -euo pipefail# ---- config: env override > flag > default -----REPO_URL="${OSVPS_REPO:-https://github.com/rahmanef63/os-vps.git}"-DIR="${OSVPS_DIR:-$HOME/os-vps}"+REPO_URL="${MSO_REPO:-https://github.com/rahmanef63/mso.git}"+DIR="${MSO_DIR:-$HOME/mso}"DIR_EXPLICIT=0-REF="${OSVPS_REF:-main}"-PORT="${OSVPS_PORT:-4005}"-SERVICE="os-vps.service"+REF="${MSO_REF:-main}"+PORT="${MSO_PORT:-4005}"+SERVICE="mso.service"DO_SERVICE=1DO_UNINSTALL=0# Let corepack fetch the pnpm version pinned in package.json without a tty prompt.@@ -34,14 +34,14 @@ die() { printf '%s✗%s %s\n' "$C_ERR" "$C_RST" "$*" >&2; exit 1; }usage() {cat <<EOF-os-vps installer- --dir PATH install dir (default: \$HOME/os-vps, or an existing service's dir)+mso installer+ --dir PATH install dir (default: \$HOME/mso, or an existing service's dir)--ref REF git ref/branch/tag to check out (default: main)--port N listen port (default: 4005)--no-service build only; skip the systemd unit- --uninstall stop+disable+remove the systemd unit (keeps code + ~/.os-vps)+ --uninstall stop+disable+remove the systemd unit (keeps code + ~/.mso)-h, --help this help-Env: OSVPS_DIR OSVPS_REF OSVPS_PORT OSVPS_REPO+Env: MSO_DIR MSO_REF MSO_PORT MSO_REPOEOF}@@ -58,7 +58,7 @@ while [ $# -gt 0 ]; dodone# ---- never as root: an authed session gets shell as this user -----[ "$(id -u)" -ne 0 ] || die "run as your normal NON-root user, not root (os-vps runs shell as the process user)."+[ "$(id -u)" -ne 0 ] || die "run as your normal NON-root user, not root (mso runs shell as the process user)."sudo_do() { if command -v sudo >/dev/null 2>&1; then sudo "$@"; else die "need root for: $* (install sudo or run the step by hand)"; fi; }@@ -77,7 +77,7 @@ if [ "$DO_UNINSTALL" -eq 1 ]; thensudo_do systemctl daemon-reloadok "removed $SERVICE"fi- info "code left at $DIR and data at ~/.os-vps — delete by hand if you want them gone."+ info "code left at $DIR and data at ~/.mso — delete by hand if you want them gone."exit 0fi@@ -170,7 +170,7 @@ info "installing dependencies…"pnpm install --frozen-lockfile || pnpm install# ---- data dir + secrets (write .env.local only if absent) -----mkdir -p "$HOME/.os-vps" && chmod 700 "$HOME/.os-vps"+mkdir -p "$HOME/.mso" && chmod 700 "$HOME/.mso"GEN_PW=""if [ ! -f .env.local ]; then@@ -178,13 +178,13 @@ if [ ! -f .env.local ]; thenGEN_PW="$(rand_password)"( umask 077cat > .env.local <<EOF-# os-vps — generated by install.sh. Private; NEVER commit.+# mso — generated by install.sh. Private; NEVER commit.OS_LOGIN_PASSWORD=$GEN_PWOS_SESSION_SECRET=$SECRET# SESSION_EXPIRY_HOURS=24# OS_FS_READ_ROOTS=~:~/projects# OS_FS_WRITE_ROOTS=~:~/projects-# OS_AUDIT_LOG=~/.os-vps/audit.log+# OS_AUDIT_LOG=~/.mso/audit.logEOF)chmod 600 .env.local@@ -223,7 +223,7 @@ TimeoutStopSec=20MemoryMax=3GStandardOutput=journalStandardError=journal-SyslogIdentifier=os-vps+SyslogIdentifier=mso[Install]WantedBy=multi-user.target@@ -238,13 +238,13 @@ EOFif curl -fsS --max-time 3 "http://127.0.0.1:$PORT/api/health" >/dev/null 2>&1; then up=1; ok "health OK"; break; fisleep 2done- [ "$up" -eq 1 ] || warn "no /api/health answer yet — check: journalctl -u os-vps -e"+ [ "$up" -eq 1 ] || warn "no /api/health answer yet — check: journalctl -u mso -e"else[ "$DO_SERVICE" -eq 1 ] && warn "no systemctl here — skipping service. Run manually: PORT=$PORT pnpm start"fi# ---- next steps -----ok "os-vps installed at $DIR"+ok "mso installed at $DIR"cat <<EOFOpen: http://<this-host>:$PORT (put Tailscale/TLS in front — do NOT expose :$PORT raw)@@ -260,7 +260,7 @@ cat <<EOFnode $DIR/scripts/approve-device.js <deviceId> "my phone" # approve it3. Reload + log in. Approve later devices from Settings → Devices.- Logs: journalctl -u os-vps -f+ Logs: journalctl -u mso -fUpdate: re-run this installer (pull + rebuild + restart), or --uninstall to remove- Security: firewall :$PORT (and :4002) from the public net; review ~/.os-vps/audit.log+ Security: firewall :$PORT (and :4002) from the public net; review ~/.mso/audit.logEOFdiff --git a/scripts/managed-app-install b/scripts/managed-app-installindex 9e3eada9..ca0d491e 100755--- a/scripts/managed-app-install+++ b/scripts/managed-app-install@@ -9,7 +9,7 @@# persisted job record down to two elements.## SECRETS. The provider key arrives in the ENVIRONMENT and never in this script's-# argv, because os-vps stores a job's argv in the job record and writes it to the+# argv, because mso stores a job's argv in the job record and writes it to the# audit log (app/api/v1/managed-apps/[id]/install/route.ts). Where an upstream CLI# has no env path, the key is re-exported to it as a flag: that argv belongs to a# transient child of this box, visible in `ps` only to the uid that could read the@@ -29,7 +29,7 @@ BIND="${MSO_INSTALL_GATEWAY_BIND:-loopback}"PROVIDER="${MSO_INSTALL_PROVIDER:-}"KEY="${MSO_INSTALL_API_KEY:-}"# The origin MSO will frame this app's dashboard from (lib/managed-apps/origin.ts:-# https://<id>.os.rahmanef.com). Empty in single-origin deployments.+# https://<id>.mso.rahmanef.com). Empty in single-origin deployments.APP_ORIGIN="${MSO_INSTALL_APP_ORIGIN:-}"log() { printf '\n=== %s\n' "$*"; }@@ -138,7 +138,7 @@ UNIT# Order matters and cost three consecutive failed installs to learn. The installer's own# launcher at ~/.local/bin/hermes is a bash wrapper that unsets PYTHONPATH/PYTHONHOME and# execs the VENV python — that is the one that works. But `~/.local/bin` is NOT on the PATH-# a systemd service inherits (os-vps gets+# a systemd service inherits (mso gets# /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/snap/bin), so `command -v hermes`# misses it, and the next candidate down — ~/.hermes/hermes-agent/hermes — carries a# `#!/usr/bin/env python3` shebang. That runs the SYSTEM python, which has no `dotenv`, anddiff --git a/scripts/post-deploy-smoke.sh b/scripts/post-deploy-smoke.shindex 5e4d859a..c2bdc127 100755--- a/scripts/post-deploy-smoke.sh+++ b/scripts/post-deploy-smoke.sh@@ -1,5 +1,5 @@#!/usr/bin/env bash-# Post-deploy smoke test. Run AFTER `pnpm build && sudo systemctl restart os-vps.service`.+# Post-deploy smoke test. Run AFTER `pnpm build && sudo systemctl restart mso.service`.# Catches the chunk-MIME drift that has bitten this deploy twice (per CLAUDE.md).## REQUIRES: devDependencies installed on host (vitest lives in devDeps). Run