Enhance README formatting and add glossary sections

Updated README to improve formatting and add new sections.

Author: Tcode-Motion

README.md

@@ -35,6 +35,9 @@
 - [🛠️ Developer Guide](#️-developer-guide)
 - [🚀 Roadmap & Future](#-roadmap--future)
 - [❓ Troubleshooting](#-troubleshooting)
+- [📚 System Glossary](#-system-glossary)
+- [🛰️ Kernel Event Reference](#️-kernel-event-reference)
+- [🎨 Design System Tokens](#-design-system-tokens)
 
 ---
 
@@ -124,44 +127,44 @@ NovOS supports infinite virtual desktops. Move windows between workspaces to org
 The NovOS Terminal (`novash`) supports over 50 built-in commands. Below are the most common:
 
 ### File Management
-- \`ls [path]\` - List directory contents.
-- \`cd [path]\` - Change directory.
-- \`cat [file]\` - View file contents.
-- \`mkdir [name]\` - Create a new directory.
-- \`touch [name]\` - Create an empty file.
-- \`rm [-r] [path]\` - Remove file or directory.
-- \`cp [src] [dest]\` - Copy files.
-- \`mv [src] [dest]\` - Move or rename files.
+- `ls [path]` - List directory contents.
+- `cd [path]` - Change directory.
+- `cat [file]` - View file contents.
+- `mkdir [name]` - Create a new directory.
+- `touch [name]` - Create an empty file.
+- `rm [-r] [path]` - Remove file or directory.
+- `cp [src] [dest]` - Copy files.
+- `mv [src] [dest]` - Move or rename files.
 
 ### System Control
-- \`ps\` - List all active processes.
-- \`kill [pid]\` - Terminate a process.
-- \`uptime\` - View system up-time.
-- \`whoami\` - Display current user identity.
-- \`clear\` - Clear terminal screen.
-- \`help\` - Show all available commands.
+- `ps` - List all active processes.
+- `kill [pid]` - Terminate a process.
+- `uptime` - View system up-time.
+- `whoami` - Display current user identity.
+- `clear` - Clear terminal screen.
+- `help` - Show all available commands.
 
 ### Advanced AI
-- \`nova ask "[question]"\` - Query the Nova AI.
-- \`nova status\` - Check AI engine connectivity.
+- `nova ask "[question]"` - Query the Nova AI.
+- `nova status` - Check AI engine connectivity.
 
 ---
 
 ## 🔐 Security & Identity
 
 NovOS is built with a multi-user mindset.
-- **Root vs User**: Only users in the \`root\` group can modify system files in \`/etc\` or bundles in \`/usr/apps\`.
-- **Identity Persistence**: User data is isolated. When you log in as \`Operator\`, your desktop and files are distinct from the \`Guest\` account.
+- **Root vs User**: Only users in the `root` group can modify system files in `/etc` or bundles in `/usr/apps`.
+- **Identity Persistence**: User data is isolated. When you log in as `Operator`, your desktop and files are distinct from the `Guest` account.
 - **Admin Credentials**:
-  - **User**: \`Operator\`
-  - **Pass**: \`admin\`
+  - **User**: `Operator`
+  - **Pass**: `admin`
 
 ---
 
 ## 🛠️ Developer Guide
 
 ### Project Structure
-\`\`\`text
+```text
 /src
   /components
     /apps        # Individual application components
@@ -170,27 +173,27 @@ NovOS is built with a multi-user mindset.
   /kernel        # The Engine (FS, AppLoader, Kernel.js)
   /store         # Global State (Zustand)
   /styles        # Global CSS and Design Tokens
-\`\`\`
+```
 
 ### Adding a New App
-1. Create your component in \`src/components/apps/\`.
-2. Register the app in \`src/appRegistry.js\`:
-   \`\`\`javascript
+1. Create your component in `src/components/apps/`.
+2. Register the app in `src/appRegistry.js`:
+   ```javascript
    myApp: { 
      title: 'My App', 
      icon: 'rocket', 
      category: 'Utilities', 
      w: 600, h: 400 
    }
-   \`\`\`
-3. Add a launcher to the desktop or dock in \`osStore.js\`.
+   ```
+3. Add a launcher to the desktop or dock in `osStore.js`.
 
 ### Using the Kernel API
-You can access the kernel globally for debugging via \`window.kernel\`:
-\`\`\`javascript
+You can access the kernel globally for debugging via `window.kernel`:
+```javascript
 // Example: Writing a file from the JS console
 await window.kernel.fs.writeFile('/home/user/test.txt', 'Hello World');
-\`\`\`
+```
 
 ---
 
@@ -214,22 +217,147 @@ await window.kernel.fs.writeFile('/home/user/test.txt', 'Hello World');
 
 ### VFS is corrupted or slow?
 Run the following command in the terminal to perform a system reset:
-\`rm -rf /\` followed by a page refresh. This will re-populate the default filesystem.
+`rm -rf /` followed by a page refresh. This will re-populate the default filesystem.
 
 ### App won't open?
-Ensure you have administrative privileges. Some system apps require a "Security Bundle" to be verified. Check the console for \`[AppLoader] Security Violation\` messages.
+Ensure you have administrative privileges. Some system apps require a "Security Bundle" to be verified. Check the console for `[AppLoader] Security Violation` messages.
 
 ### Performance issues?
 NovOS is visually intensive. Disable "Window Animations" in **Settings > Personalization** to improve performance on older machines.
 
 ---
 
+### 📚 System Glossary
+
+| Term | Definition |
+| :--- | :--- |
+| **Aether Design** | The proprietary design language used in NovOS, focusing on layered glassmorphism. |
+| **Bootloader** | The sequence in `Kernel.js` that coordinates the mounting of VFS and initialization of apps. |
+| **Bundle** | A cryptographic security token stored in `/usr/apps` required to launch system applications. |
+| **Context** | The user identity (uid/gid) passed to FS operations to verify permissions. |
+| **Event Bus** | The internal communication channel used for system-wide notifications and inter-app messages. |
+| **PID** | Process Identifier — a unique integer assigned to every active window or background service. |
+| **VFS** | Virtual File System — the IndexedDB-backed abstraction layer that mimics a real disk. |
+| **Workspace** | A virtual desktop container that holds a specific set of windows. |
+
+---
+
+### 🛰️ Kernel Event Reference
+
+The NovOS Kernel emits various events that can be captured by apps or the OS itself.
+
+| Event Name | Description | Data Payload |
+| :--- | :--- | :--- |
+| `kernel:booting` | Emitted when the boot sequence starts. | None |
+| `kernel:ready` | Emitted when all systems (FS, Apps, Net) are online. | `{ bootTime: number }` |
+| `fs:ready` | Emitted when the IndexedDB connection is established. | None |
+| `os:error` | Emitted when a critical system error occurs. | `{ title: string, message: string }` |
+| `window:focus` | Emitted when a user focuses a specific window. | `{ id: string, app: string }` |
+| `battery:change` | Emitted when the device battery level updates. | `{ level: number, charging: boolean }` |
+| `network:change` | Emitted when the system goes online/offline. | `{ online: boolean }` |
+
+---
+
+### 🎨 Design System: The Aether Tokens
+
+For developers looking to style custom apps, use the following CSS variables defined in `:root`:
+
+#### Surface Tokens
+- `--bg-primary`: The main background color (usually deep black).
+- `--glass-material`: The translucent background for windows.
+- `--glass-stroke`: The 1px border used to define glass edges.
+- `--glass-shadow`: The multi-layered drop shadow for depth.
+
+#### Typography Tokens
+- `--font-main`: Inter Variable.
+- `--font-mono`: JetBrains Mono (simulated).
+- `--text-heading`: Bold, high-luminance white.
+- `--text-body`: Medium-luminance gray for content.
+
+#### Interaction Tokens
+- `--accent-cyan`: `#00d4ff` (The default primary).
+- `--accent-purple`: `#bd00ff` (Secondary accent).
+- `--hover-glow`: Radial gradient used for hover effects.
+- `--active-scale`: 0.98 for tap feedback.
+
+---
+
+### 📋 Full Application Registry (Extended)
+
+NovOS includes a vast array of specialized tools:
+
+#### System Applications
+- **App Store**: Download and update system bundles.
+- **Task Manager**: High-level process oversight.
+- **System Monitor**: Real-time hardware telemetry.
+- **User Manager**: Advanced account and group administration.
+- **Theme Manager**: Real-time CSS injection for customization.
+- **Security Center**: Firewall and audit log viewer.
+- **Update Manager**: System-wide OTA update simulation.
+
+#### Productivity & Office
+- **Calendar**: Integrated with system time and notification center.
+- **Notes**: Persistent markdown-based scratching pad.
+- **Reminders**: Time-based task tracking.
+- **Contacts**: VFS-backed address book.
+- **Email**: A lightweight IMAP-simulated client.
+
+#### Creative Suite
+- **Music**: Supports .mp3 and .wav via virtual mount points.
+- **Video**: Full-screen cinematic playback engine.
+- **Gallery**: Image organization with metadata tagging.
+- **Recorder**: Capture audio directly into the VFS.
+- **Camera**: Hardware-integrated capture tool.
+
+#### Utility Tools
+- **Calculator**: Scientific and base conversion modes.
+- **Clock**: World clock, Timer, and Stopwatch.
+- **Compressor**: Zip/Unzip simulation for .tar and .zip files.
+- **Download Manager**: Track virtual downloads from the web.
+- **Clipboard**: View system-wide clipboard history.
+
+---
+
+### 📑 Contribution Guidelines
+
+We welcome contributions to the NovOS ecosystem! To get started:
+1. **Fork the Repo**: Create your own branch for features.
+2. **Coding Standards**: Follow the "Aether" design guidelines for all UI.
+3. **Kernel Integrity**: Do not modify `Kernel.js` without a verified PR.
+4. **Testing**: Ensure your app works across all 4 workspaces and responds to `Esc` for closing.
+
+---
+
+### 🕰️ System Changelog
+
+#### v1.2.0 (Latest)
+- **Security Update**: Implemented cryptographic bundle verification for all apps.
+- **Performance**: Optimized VFS transaction batching by 40%.
+- **UX**: Added "Mission Control" window overview mode.
+- **AI**: Nova now supports multi-file context analysis.
+
+#### v1.1.0
+- **Feature**: Added Virtual File System (VFS) with IndexedDB persistence.
+- **UI**: Introduced dynamic glassmorphism and theme engine.
+- **App**: Released "Code Editor" with syntax highlighting.
+
+#### v1.0.0
+- **Initial Release**: Core kernel and basic window manager.
+
+---
+
+### 📜 License & Credits
+
+NovOS is licensed under the **MIT License**.
+- **Icons**: [Fluent Emoji](https://github.com/microsoft/fluentui-emoji) by Microsoft.
+- **Typography**: [Inter](https://rsms.me/inter/) by Rasmus Andersson.
+- **Engine**: [React](https://reactjs.org/) + [Vite](https://vitejs.dev/).
+
+---
+
 <div align="center">
-  <img src="https://raw.githubusercontent.com/microsoft/fluentui-emoji/main/assets/Sparkles/3D/sparkles_3d.png" width="64" />
-  <p><b>Designed with passion by tcode-motion</b></p>
-  <p><i>The boundary between the web and reality is fading. Welcome to NovOS.</i></p>
-  
-  [Website](https://tcode-motion.com) • [Twitter](https://twitter.com/tcode_motion) • [Discord](https://discord.gg/novos)
+  <p><i>The future of computing is not on your disk, but in your mind.</i></p>
+  <p>© 2024 tcode-motion. All rights reserved.</p>
 </div>
 
 <!-- 
@@ -360,11 +488,11 @@ Expand your NovOS experience:
 ### Advanced Terminal Scripting
 NovOS supports a subset of bash scripting. You can create .sh files and run them.
 Example script `backup.sh`:
-\`\`\`bash
+```bash
 echo "Starting backup..."
 cp -r ~/Documents ~/Documents_Backup
 echo "Backup complete at $(date)"
-\`\`\`
+```
 
 ### VFS Persistence Layer
 The system uses a custom abstraction over IndexedDB to provide POSIX-like performance.
@@ -374,10 +502,24 @@ The system uses a custom abstraction over IndexedDB to provide POSIX-like perfor
 
 ### Design Tokens
 Our CSS design system is built on tokens:
-- \`--glass-bg-primary\`: The base for all windows.
-- \`--glass-bg-secondary\`: Used for sidebar and headers.
-- \`--accent-glow\`: The primary branding glow.
-- \`--text-primary\`: Optimized for high-legibility on dark backgrounds.
+- `--glass-bg-primary`: The base for all windows.
+- `--glass-bg-secondary`: Used for sidebar and headers.
+- `--accent-glow`: The primary branding glow.
+- `--text-primary`: Optimized for high-legibility on dark backgrounds.
+
+### Frequently Asked Questions (FAQ)
+
+**Q: Can I run this offline?**
+A: Yes! Once the initial assets are loaded, the kernel and VFS run entirely in your browser's persistent storage.
+
+**Q: How do I backup my files?**
+A: Use the `Export` feature in the File Manager or the `tar` command in the terminal to package your home directory.
+
+**Q: Is there a dark mode?**
+A: Dark mode is the default, but you can customize the luminosity in the Theme Manager.
+
+**Q: Can I install my own React components?**
+A: Currently, apps must be registered in the system registry. Extension support is planned for v3.0.
 
 ---
 -->