# ORACLE-OS-WORKSPACE-SETTINGS-GOAL.md — in-OS Settings (the “computer” Settings app)

| | |
|---|---|
| **Version** | v2 (2026-07-21) |
| **Owner** | Ryan (nastermodx) |
| **Status** | **Phases A–E shipped (v9.10.455)**. Session module: `oracle-os/apps/settings/session.js`. |
| **Surface** | Antigravity **Oracle OS → Settings** (`oracle-os/shell/desktop.js` `osSettingsNav`) |
| **NOT this file** | Host industrial Config → `ORACLE-OS-SETTINGS-GOAL.md`. **Full dashboard Settings panel** → `ORACLE-OS-CONTROL-PANEL-SETTINGS-GOAL.md`. |

---

## 1. Owner vision

Wallpaper/media come from **workspace Drive**, not URL paste. Settings sections are **live data**, not fake OS cosplay cards.

---

## 2. Phases

### Phase A — Appearance ✅ v9.10.452
- Gallery from Drive · External upload · themes · FM set-as-wallpaper · no URL-first

### Phase B — Storage + Files bridge ✅ v9.10.453
- [x] Real quota bar + plan meta  
- [x] Upload External / Open FM / Appearance  
- [x] **Places** → File Manager virtual folders (Home, Desktop, Documents, Images, Videos)  
- [x] **Recent on Drive** list (+ set wallpaper on images)

### Phase C — System / Network / Sound ✅ v9.10.453
- [x] System: plan, role, uptime, dashboard build, jobs runtime, storage mode  
- [x] Network: live probes (health, engine, Drive, Antigravity, jobs)  
- [x] Sound: boot chime + mute-all UI (persisted)

### Phase D — Account / Preferences ✅ v9.10.453
- [x] Avatar / plan / role card  
- [x] Reduce motion + mute prefs  
- [x] Deep link to dashboard profile Config  
- [ ] Server `userSettings.os` multi-device sync (optional later)

### Phase E — Extract `oracle-os/apps/settings/` ✅ v9.10.455
- [x] `session.js` identity + session helpers module (loaded from `oracle.html`)  
- [x] Structural tests for session module + control-panel S0 hooks  
- [ ] Full move of `osSettingsNav` panels out of `desktop.js` (optional follow-up)

### Upload fix (ops)
Binary Drive upload + **dashboard restart** required after server changes (`readJsonBody` 64KB trap).

---

## 3. RESUME HERE

1. Optional: multi-device `userSettings.os` wallpaper/theme sync.  
2. Full panel extract from `desktop.js` if it keeps growing.  
3. Hard-refresh after client edits; **restart dashboard** after `command-center-server.mjs` edits.  
4. Control-panel next: **Phase S1** in `ORACLE-OS-CONTROL-PANEL-SETTINGS-GOAL.md`.

---

*Companion: `oracle-os/ARCHITECTURE.md`, `GOOGLE-DRIVE-STORAGE-SPEC.md`.*