# ORACLE-OS-WORKSPACE-COMPUTER-GOAL.md  
## Boot experience + OS-like Control Panel (workspace sandbox)

| | |
|---|---|
| **Version** | v1 (2026-07-21) |
| **Owner** | Ryan (nastermodx) |
| **Status** | **B0+B0.5 SHIPPED (v9.10.458)** — boot, Ecosystem/Programs, immersive Workspace + Log off |
| **Surface** | Antigravity tab → Oracle OS desktop (`oracle-os/shell/desktop.js`, boot HTML in `oracle.html`) |
| **Related** | `ORACLE-OS-WORKSPACE-SETTINGS-GOAL.md`, `ORACLE-OS-CONTROL-PANEL-SETTINGS-GOAL.md` (dashboard Settings — separate) |

---

## 1. Owner intent

1. **Boot like a real computer** when opening the Antigravity / workspace tab:
   - **BIOS / motherboard POST** with KAI Oracle system mark  
   - **Oracle OS boot** (logo, loading bar, sounds)  
   - **Login**  
   - Stages are **timed** and also **wait** for workspace tools/services to become ready so programs can launch.
2. **Control Panel (workspace Settings)** is OS-like: each section richer; **Ecosystem** services can be activated/deactivated, load/change programs, etc.
3. Dashboard **control panel Settings** (account/plan/privacy) continues under its own goal — both get work, but this file owns the **sandbox computer** feel.

---

## 2. Boot phases (product)

| Phase | Feel | Gate |
|-------|------|------|
| **B1 BIOS** | Green/amber POST, Oracle/KAI firmware mark, hardware lines | Min time + paint complete |
| **B2 OS load** | Dark splash, Oracle icon, progress of “drivers / services / storage / AI” | Min time + readiness probes |
| **B3 Login** | User identity + PIN | Session `/api/me` painted |
| **B4 Desktop** | Session restore / apps | Enter Workspace |

### Readiness probes (B2)
- `/health` (dashboard + engine)  
- `/api/me` (identity)  
- `/api/storage/usage` or VFS (cloud disk)  
- `/api/workspace/jobs/runtime` (optional — plan may gate)  
- `/api/antigravity` (optional)  

Probes run in parallel; UI shows checkmarks as each completes. Max wait cap so boot never hangs forever.

### Sounds
- POST beep (optional short)  
- Boot chime on OS splash (respect mute / boot chime prefs)  
- Soft click optional on login

### Skip
- `sessionStorage kai.os.booted=1` still skips animation on same tab session (fast re-entry).  
- Setting later: “Always play boot sequence”.

---

## 3. Workspace Control Panel sections (target)

| Section | Role |
|---------|------|
| System | About PC, uptime, build, reset boot flag |
| Account | Identity, plan |
| Appearance | Wallpaper, theme |
| **Ecosystem** | Toggle services: AI bridge, jobs runner, cloud disk, neural net display |
| **Programs** | Installed apps enable/disable, default open on login |
| Network | Live probes |
| Storage | Drive |
| Sound | Boot chime, mute |
| Security | PIN, lock |
| Activity / About | Logs, version |

Service toggles stored per-user (`localStorage kai.os.svc.*` → later `/api/me/settings` `os.services`).

---

## 4. Phases

### B0 — Boot rewrite + Ecosystem panel  ✅ v9.10.457
- [x] Goal doc  
- [x] BIOS + OS splash + readiness probes + sounds  
- [x] Ecosystem + Programs settings panels  
- [x] System: Play full boot next time  


### B0.5 — Immersive Workspace + Log off  ✅ v9.10.458
- [x] Rename rail label **Workspace** (id stays `antigravity` for routes)  
- [x] Enter Workspace → hide top bar + left rail + bottom tabs (fullscreen computer)  
- [x] Boot every enter from Social (`_osWorkspaceSessionActive`, not sticky sessionStorage alone)  
- [x] Start → **Log off Workspace** → shutdown cinema → Home social  
- [x] Leaving chrome navigates via Log off (cannot “just switch tabs” out)

### B1 — Deeper programs catalog + in-OS social popups  
### B2 — Persist services to server `userSettings.os`  
### B3 — Optional full-screen BIOS art assets  

---

## 5. RESUME HERE

1. Verify boot on Antigravity first open (hard-refresh, clear `sessionStorage kai.os.booted` to retest).  
2. Open Settings → Ecosystem / Programs.  
3. Continue B1 program catalog if needed.

---

*Not the dashboard Settings modal — that remains `ORACLE-OS-CONTROL-PANEL-SETTINGS-GOAL.md`.*