Skip to content

armgit / mso

Public Imported from GitHub
0

Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.

refactor: rename os-vps -> mso across code, config and prod wiring

Rahman439dd2bb6abe
diff --git a/.env.example b/.env.example
index 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 /api
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index a5a9f107..8ea64314 100644
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -1,5 +1,5 @@
blank_issues_enabled: false
contact_links:
- name: Security vulnerability
- url: https://github.com/rahmanef63/os-vps/security/advisories/new
+ url: https://github.com/rahmanef63/mso/security/advisories/new
about: Please report vulnerabilities privately through GitHub Security Advisories.
diff --git a/.gitignore b/.gitignore
index 31ec59af..24f51098 100644
--- a/.gitignore
+++ b/.gitignore
@@ -16,7 +16,7 @@ os-browser/*
!os-browser/package-lock.json
!os-browser/README.md
convex-backend/
-.os-vps/
+.mso/
# local session progress log (not tracked)
progress.md
diff --git a/CLAUDE.md b/CLAUDE.md
index 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 UI
metaphor 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 the
UI brand. **Self-contained**: a single Next.js app, no database, no external
agent — 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 feature
slice. (`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 + app
list + 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`. ALWAYS
build-then-restart, never the reverse, and never rebuild again after restarting
without restarting once more — `next start` loads the build manifest at boot, so if
the 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` and
check `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 further
host-side facts the repo cannot carry, and the feature dies quietly without either: (1) `loginctl enable-linger rahman`, or the unit stops at
logout 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 files
into the other's commit. Before a long loop, `git log --oneline -10` — unexpected
diff --git a/README.md b/README.md
index 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 start
Demo 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 proces
flowchart LR
U["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.md
index 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 control
in 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-http
deployment 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 own
config: 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 in
the client bundle. To rotate a key, stop MSO, edit the config file or remove the
provider 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 audit
logs without checking for private paths, command names, or other sensitive
context.
diff --git a/app/api/auth/session-cookie.test.ts b/app/api/auth/session-cookie.test.ts
index 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.ts
index 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 token
diff --git a/app/api/sw/route.ts b/app/api/sw/route.ts
index 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 not
diff --git a/app/api/threads/route.ts b/app/api/threads/route.ts
index 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 } fro
export 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.ts
index 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 job
diff --git a/app/api/v1/managed-apps/[id]/proxy/[[...path]]/route.ts b/app/api/v1/managed-apps/[id]/proxy/[[...path]]/route.ts
index 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; path
if (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.ts
index 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 the
diff --git a/app/api/v1/managed-apps/job-cancel-route.test.ts b/app/api/v1/managed-apps/job-cancel-route.test.ts
index 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.ts
index 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.ts
index 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.ts
index 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.tsx
index 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.tsx
index 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.md
index 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 the
CLIs 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 the
dragged 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 registers
it `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 applicatio
their 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, its
own 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's
features 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 is
which apps exist, a shell is what they look like. Switching writes one key and fires one
event: 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 i
The 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 a
general-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 never
forwarded and `www-authenticate` never returned (together they would make the proxy a
credential relay), off-origin redirects are refused rather than passed on (they are an
open 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 closes
that — 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 in
Chromium 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/*` routes
to 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 else
still 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`, each
its 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 the
process sees the public name). Adding an app to the catalog means adding a router there and a
DNS record **in the same change**: the host template applies to every catalog id, so a new
app's iframe points at `<newid>.os.…` the moment it exists, and with no record for that name
diff --git a/docs/AUDIT-2026-06-11.md b/docs/AUDIT-2026-06-11.md
index 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 jail
with 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 the
denylist's stated purpose (persistence after revocation). Scrub `OS_*` +
diff --git a/docs/AUDIT-2026-06-14.md b/docs/AUDIT-2026-06-14.md
index 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 stays
diff --git a/docs/DESIGN-RECONCILE.md b/docs/DESIGN-RECONCILE.md
index 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 a
defined **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 host
process); 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.md
index 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 mso
corepack enable pnpm # uses the pinned pnpm (see "pnpm version" below)
pnpm install
cp .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` (no
no host access, forced mock data), served on `:4006` via its own systemd unit. For a
non-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 version
diff --git a/docs/DRAWER-MENU-BYOK-PLAN.md b/docs/DRAWER-MENU-BYOK-PLAN.md
index 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 React
components 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 the
home 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.md
index 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.js
SSH to the box. Either approve your current device id (shown on the login
screen) 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 is
Nothing needs one. Sessions are stateless signed cookies; the device
allowlist, 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) are
published 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 (stable
for paths, systemd units and the domain); **Manef Shell OS** is the product
name; **MSO** is the short mark shown in the UI chrome. Renaming the slug would
break every deploy path, so it stays.
diff --git a/docs/HERMES-INTEGRATION.md b/docs/HERMES-INTEGRATION.md
index 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`. There
is 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 its
own `/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 falls
back 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 than
2.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 rebas
treats a bare `/` as the fallback it is by sending the window to its own route instead of
the 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 in
single-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 the
proxy 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.com
x-middleware-rewrite: /api/v1/managed-apps/hermes/proxy
```
diff --git a/docs/INSTALL.md b/docs/INSTALL.md
index 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 VPS
Step-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 ~/mso
pnpm 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 allowlist
gate 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 |
```bash
cp .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=~:~/projects
OS_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 are
unreadable 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=simple
User=youruser
-WorkingDirectory=/home/youruser/os-vps
-EnvironmentFile=/home/youruser/os-vps/.env.local
+WorkingDirectory=/home/youruser/mso
+EnvironmentFile=/home/youruser/mso/.env.local
Environment=PORT=4005
Environment=HOSTNAME=0.0.0.0
ExecStart=/usr/bin/pnpm start --hostname 0.0.0.0 --port 4005
@@ -117,7 +117,7 @@ RestartSec=5
MemoryMax=3G
StandardOutput=journal
StandardError=journal
-SyslogIdentifier=os-vps
+SyslogIdentifier=mso
[Install]
WantedBy=multi-user.target
@@ -125,8 +125,8 @@ WantedBy=multi-user.target
```bash
sudo 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 ~/mso
git status --short # must be clean before updating
git fetch origin main
git merge --ff-only FETCH_HEAD
pnpm install --frozen-lockfile
pnpm 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=all
auto-restarts (catches hangs that `Restart=always`, crash-only, can't). All a
no-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 rahman
size 1M
rotate 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.md
index 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 accepted
exception), ≤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 (no
such 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 their
own in-content toolbars. Skip *(system-monitor's optional nav-action slot is the one place to
revisit 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.md
index 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 single
origin 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, because
to claim the cockpit host while on an app host would escape the rewrite (`proxy.ts:112`). On an
app host **every path** is rewritten into that app's proxy (`:146`), so `/api/v1/exec/run` does
not 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 name
is 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 nonce
matches 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` out
of a compromised upstream is the thing scoping exists to stop. Hosts that *nothing* grants are
disclosed 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 first
curl -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-only
curl -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 Hermes
install 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 counte
Everything destructive is a **job** (`jobs.ts` + `job-runner.ts` + `job-store.ts`): the POST starts
one 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 job
whose 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, the
browser still points at the old same-origin URL the server has stopped answering, and the
window 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 the
dashboard 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 was
diff --git a/docs/MODELS-INTEGRATION.md b/docs/MODELS-INTEGRATION.md
index 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-gated
endpoint 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 — never
import 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; mso
streams 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 the
session-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 once
a key is set (Settings → AI or the provider env var).
diff --git a/docs/OPENCLAW-INTEGRATION.md b/docs/OPENCLAW-INTEGRATION.md
index 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 no
system-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 Protocols
The 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 socket
crosses 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 param
appear 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, no
fragment — and nothing in `lib/managed-apps/` reads `openclaw.json` (grep: the only upstream
reads 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 URL
from `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 cannot
service an `Upgrade`**: it is handed a `Request` and returns a `Response`, and the proxy's
transport 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-audio
socket 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 the
framing grant both working, before auth. Full verification set:
[MANAGED-APPS.md §5](./MANAGED-APPS.md).
diff --git a/docs/PROGRESS.md b/docs/PROGRESS.md
index 30a87bd0..f267215e 100644
--- a/docs/PROGRESS.md
+++ b/docs/PROGRESS.md
@@ -1,10 +1,10 @@
-# os-vps — Progress Log
+# mso — Progress Log
Running 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 those
back. 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; wir
MSO becomes the **control plane** for applications that stay separate. Hermes and OpenClaw keep
their own runtime, config, data, versions, health, logs and backups; nothing is copied, forked or
merged 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 own
loopback HTTP surfaces, and systemd/docker. Shipped as `c411187` → `52cfff5` → `0feaab4` →
`5b4b5c9` → `d1fbd85` → `c597d08` → `d880f68`. (`3b45b8e`, same session, closed an unrelated
hole: 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 routes
under `/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` with
bearer/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 a
right-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 middle
offered (`workboard`/`plugin` are flag-gated → `available:false`). 60 s cache, min-length parse
guard, 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 CSP
path-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 middle
on 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, not
a 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 breaks
through. `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 middle
wildcard (the widened cookie would make `new Image().src` an existence oracle). The session
cookie gained an optional `Domain` and is cleared with **and** without it; `SameSite=Strict` is
unchanged 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 an
app 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 middle
correctness. 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 never
created (a success would have copied 2.7 GB + 1.7 GB). The guard is gone; `fs.cp` now takes a
filter that skips `node_modules`/`.venv`/`venv`/`__pycache__`/`.git`/`.cache`/`backups` — the last
being 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.remem
host-tool (read-tier — runs immediately, no approval card, since it's a benign owner-scoped
write) that POSTs to `/api/memory`. One catalog entry (`host-tools/catalog.ts`) + a HOST_SYSTEM
guidance 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 → pe
add 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 starts
fresh. Persistence factored into a `use-thread-persistence` hook. YAML (not JSON) per the owner's
request — 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 senior
dev) → 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 ChatGPT
Plus/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-rest
encryption 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 is
additive (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 audit
session 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 `origi
grow the buffer unbounded) + `lib/host/multipart.test.ts` (6 tests incl. both
bypass 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` to
activate. 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 note
itself 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 is
now consumable from the catalog by any project (`npx rr add <slug>`):
- **appshell 1.4.0** in rr = byte-synced to this repo's framework (Android
Material-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's
self-contained `lib/host.ts` seams (mock adapters + `configure*()` for real
wiring): 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 fresh
defaults (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) via
session-gated `/api/prefs` (mirrors `/api/config`). localStorage hydrates
first, 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 a
reload. `wallpaperStyle` is computed → stripped both sides. Demo: zero calls.
Device-specific state (window layout, clipboard, profiles, recents) stays
local on purpose.
@@ -797,7 +797,7 @@ Phone testing surfaced the real gaps — everything below e2e-verified on prod
dismiss → `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 the
deep-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 consumer
literals (persist key + idle name → manifest), de-Convex'd os-shell metadata,
added trios. Capability injection done (Phase G `b16ac0a`): appshell core no
longer 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 lon
import `@/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 primitiv
skips 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 single
facade 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 default
FS 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 all
user-facing strings (it's a cockpit/utility, not an OS). Repo/service/domain slug
unchanged.
- **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). HTTP
API: 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`). Browser
slice rewritten to a single REMOTE view: live screenshot `<img>`, click mapped to
the 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 calls
127.0.0.1:4001 — CR NOT broken) + restarted. ufw INPUT policy is DROP, so
4001 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 the
live 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 real
VPS 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.md
index 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 into
diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md
index 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 501
No 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 key
the 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.ts
index 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.ts
index 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.ts
index 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.tsx
index 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 once
the 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 no
in-content large title to fade in. */}
<header
className={cn(
diff --git a/frontend/slices/appshell/features/desktop-icons/store.ts b/frontend/slices/appshell/features/desktop-icons/store.ts
index 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.ts
index 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.tsx
index 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 stack
diff --git a/frontend/slices/appshell/features/widgets/components/widgets-defs-vps.tsx b/frontend/slices/appshell/features/widgets/components/widgets-defs-vps.tsx
index 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.tsx
index 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.ts
index 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.ts
index 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.tsx
index 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.ts
index 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.ts
index 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.tsx
index 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.ts
index 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.tsx
index 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.tsx
index 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.tsx
index 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.ts
index 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.ts
index 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.ts
index 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.md
index 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) are
vendored under `ui/` and imports rewritten (see the lift notes).
diff --git a/frontend/slices/image-editor/README.md b/frontend/slices/image-editor/README.md
index 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 LIBRARY
slice: 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).
## Capabilities
diff --git a/frontend/slices/image-editor/image-editor.tsx b/frontend/slices/image-editor/image-editor.tsx
index 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.ts
index 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.ts
index 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.tsx
index 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}>
Cancel
diff --git a/frontend/slices/managed-apps/rollback-panel.tsx b/frontend/slices/managed-apps/rollback-panel.tsx
index 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.tsx
index 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.ts
index 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.ts
index 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.ts
index 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.tsx
index 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.tsx
index 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.ts
index 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.ts
index 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.ts
index 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.json
index 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.tsx
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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 injected
diff --git a/frontend/slices/system-monitor/components/host-frame.tsx b/frontend/slices/system-monitor/components/host-frame.tsx
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.tsx
index 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.ts
index 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.ts
index 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.ts
index 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 every
diff --git a/lib/camoufox/service.ts b/lib/camoufox/service.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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 parent
beforeAll(() => {
- 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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: StartManagedAppJ
const 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.ts
index 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 id
diff --git a/lib/managed-apps/job-store.test.ts b/lib/managed-apps/job-store.test.ts
index 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.ts
index 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.ts
index 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.ts
index 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): Pr
if (!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` as
diff --git a/lib/managed-apps/lock.ts b/lib/managed-apps/lock.ts
index 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.ts
index 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.ts
index 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): ManagedApp
return 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.ts
index 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.ts
index 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.ts
index 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 it
diff --git a/lib/managed-apps/proxy-headers.ts b/lib/managed-apps/proxy-headers.ts
index 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.ts
index 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.ts
index 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.ts
index 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: string
const { 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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: ManagedAppBack
throw 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.tsx
index 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 agent
diff --git a/lib/os-api/mock-data.ts b/lib/os-api/mock-data.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.tsx
index 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.mjs
index 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.md
index 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 app
A 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 |
## Security
diff --git a/os-browser/server.mjs b/os-browser/server.mjs
index 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.json
index 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.ts
index 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.ts
index 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.ts
index 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 DNS
diff --git a/scripts/approve-device.js b/scripts/approve-device.js
index 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-service
index 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, so
diff --git a/scripts/e2e.sh b/scripts/e2e.sh
index 817106a2..874121d1 100755
--- a/scripts/e2e.sh
+++ b/scripts/e2e.sh
@@ -16,24 +16,24 @@ if curl -fso /dev/null "$E2E_URL"; then
fi
"$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' EXIT
for _ in $(seq 1 90); do
curl -fso /dev/null "$E2E_URL" && break
sleep 0.5
done
-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=0
for check in scripts/e2e/*.sh; do
[ -e "$check" ] || continue
name="$(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; then
echo "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))
fi
done
echo "e2e: $pass pass, $fail fail"
diff --git a/scripts/gen-readme-media.mjs b/scripts/gen-readme-media.mjs
index 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.sh
index 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=1
DO_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_REPO
EOF
}
@@ -58,7 +58,7 @@ while [ $# -gt 0 ]; do
done
# ---- 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 ]; then
sudo_do systemctl daemon-reload
ok "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 0
fi
@@ -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 ]; then
GEN_PW="$(rand_password)"
( umask 077
cat > .env.local <<EOF
-# os-vps — generated by install.sh. Private; NEVER commit.
+# mso — generated by install.sh. Private; NEVER commit.
OS_LOGIN_PASSWORD=$GEN_PW
OS_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.log
EOF
)
chmod 600 .env.local
@@ -223,7 +223,7 @@ TimeoutStopSec=20
MemoryMax=3G
StandardOutput=journal
StandardError=journal
-SyslogIdentifier=os-vps
+SyslogIdentifier=mso
[Install]
WantedBy=multi-user.target
@@ -238,13 +238,13 @@ EOF
if curl -fsS --max-time 3 "http://127.0.0.1:$PORT/api/health" >/dev/null 2>&1; then up=1; ok "health OK"; break; fi
sleep 2
done
- [ "$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 <<EOF
Open: http://<this-host>:$PORT (put Tailscale/TLS in front — do NOT expose :$PORT raw)
@@ -260,7 +260,7 @@ cat <<EOF
node $DIR/scripts/approve-device.js <deviceId> "my phone" # approve it
3. Reload + log in. Approve later devices from Settings → Devices.
- Logs: journalctl -u os-vps -f
+ Logs: journalctl -u mso -f
Update: 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.log
EOF
diff --git a/scripts/managed-app-install b/scripts/managed-app-install
index 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`, and
diff --git a/scripts/post-deploy-smoke.sh b/scripts/post-deploy-smoke.sh
index 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