# Omni System Hub OS

> **Canonical URL**: https://newjosh.com/work/omni-os  
> **Author**: Joshua M. Abrams  
> **Category**: Systems & Bare-Metal (2024–Present) | **Status**: Active  
> **Related Manifest**: https://newjosh.com/llms.txt  

## Executive Summary
Omni System Hub OS is a sovereign declarative operating system running Windows (Wine), Android (Waydroid), macOS (Darling), and native Linux binaries simultaneously under a custom Go exokernel supervisor (PID 1), a low-latency wlroots C Wayland compositor, and a Unified Glass desktop shell.

## Problem Statement
Modern computing is fractured into corporate walled gardens. Developers and operators must maintain multiple physical machines or run sluggish, memory-hogging virtual machines just to run platform-specific software. Furthermore, traditional OS supervisors rely on naive polling loops (PIDs, CPU ticks) that fail to detect semantic UI deadlocks or window pipeline freezes.

## Architectural Thesis
Omni OS replaces the passive best-effort model with a Declarative Constraint-Solver Reasoning Engine. Subsystems publish immutable, generation-tracked evidence snapshots to `/run/omni/evidence/`. An event-driven solver continuously verifies abstract semantic contracts (display boundaries, session preservation, viewport fit), diagnosing root causes and executing surgical capability graph repairs before escalating to restarts.

## Core Subsystems
1. **Sovereign Exokernel Init**: Custom-hardened Linux kernel boots into a compiled Go orchestrator as PID 1, managing daemons, watchdogs, and capability graphs.
2. **Custom wlroots Compositor**: Low-latency C Wayland compositor managing hardware-accelerated surface presentation across X11, Wayland, and runtime emulators.
3. **Multi-Runtime Execution Matrix**: Natively bridges Win32 (Wine 9.0 Pro), Android (Waydroid container), and Darwin (Darling Mach-O) directly to Wayland surfaces without hypervisors.
4. **Declarative Constraint-Solver Engine**: Evaluates semantic obligations from immutable JSON snapshots in `/run/omni/evidence/` upon filesystem commit.
5. **Tiered Glass UI Shell**: Primary Glassmorphic desktop surface engineered in Tauri + React, paired with an automated fallback to a Tier 3 native Skia/Softbuffer renderer.