dollspace.gay
Microkernel based hobby OS
dollspacegay.tngl.sh
1# GENESIS.scroll
2# The Philosophical and Architectural Foundation of AethelOS
3
4## The Prime Covenant: Symbiotic Computing
5
6AethelOS does not command—it harmonizes.
7The OS does not dominate the hardware, nor does the user dominate the OS.
8Instead, all three exist in a symbiotic relationship, a living equilibrium.
9
10```
11 The User
12 |
13 (Intent & Will)
14 |
15 +-------+-------+
16 | |
17 The OS Hardware
18(Harmony) (Foundation)
19 | |
20 +-------+-------+
21 (Symbiosis)
22```
23
24## Core Principles
25
26### 1. Harmony Over Force
27The system does not preempt; it negotiates.
28Resources are not seized; they are allocated through consensus.
29A greedy process is not killed—it is first soothed, its intentions understood.
30
31### 2. Memory Over Forgetting
32The World-Tree remembers all.
33Every file carries the memory-rings of its history.
34No data is truly destroyed, only archived in the deeper roots.
35
36### 3. Beauty as Necessity
37Aesthetics are not decoration—they are the language of intuition.
38The system reveals its state through living metaphor:
39- Windows ripple when dragged (energy, life)
40- The cursor leaves traces (memory, path)
41- Text shimmers with activity (breath, presence)
42
43### 4. Security Through Nature
44Safety is not imposed by walls, but by the natural boundaries of capability.
45No process can reach beyond its sphere of influence.
46Trust is earned through provenance, not declared through privilege.
47
48## Architectural Pillars
49
50### The Heartwood (Kernel)
51The minimal, sacred core. A hybrid microkernel that manages:
52- **The Loom of Fate**: Harmony-based cooperative scheduling
53- **The Mana Pool**: Capability-based, object-oriented memory
54- **The Nexus**: High-speed, asynchronous message passing (IPC)
55- **Attunement Layer**: Abstract hardware interface
56
57Design Philosophy: Minimal trusted computing base (TCB).
58Everything that can run in user space, does.
59
60### The Groves (User-Space Services)
61Isolated processes that grow from the Heartwood:
62- **World-Tree Grove**: Relational database filesystem
63- **The Weave Grove**: Vector-based scene graph compositor
64- **Lanthir Grove**: Window management service
65- **Network Sprite**: Connection to other realms
66
67Design Philosophy: Resilience through isolation.
68A failing Grove cannot corrupt the Heartwood.
69
70### The Ancient Runes (Core Libraries)
71The APIs and tools for developers to build within AethelOS:
72- **Corelib**: Standard data structures and functions
73- **Weaving API**: Toolkit for graphical applications
74- **Eldarin Script**: Shell interaction library
75
76Design Philosophy: Expressive power through abstraction.
77Developers work with intentions, not implementation details.
78
79## Technical Innovations
80
81### 1. The Loom of Fate (Scheduler)
82- Cooperative, not preemptive
83- Thread states: Weaving, Resting, Tangled, Fading
84- Resource negotiation based on system-wide harmony
85- Parasite detection and throttling
86- Implicit yielding encouraged by language design
87
88### 2. The Mana Pool (Memory)
89- No raw pointers in user space
90- Capability-based security enforced by MMU
91- Purpose-driven allocation:
92 - Sanctuary: Long-lived, stable objects
93 - Ephemeral Mist: Short-lived, volatile data
94- Handle-based memory access only
95
96### 3. World-Tree Filesystem
97- Files are objects with mandatory metadata:
98 - Creator, Genesis Time, Essence (type), Connections
99- Query-based access, not path-based
100- Built-in versioning (Chronurgy) via copy-on-write
101- Transactional, relational database foundation
102- Memory-rings: Access any historical state
103
104### 4. The Weave (Graphics)
105- Fully retained-mode, scene graph architecture
106- Vector-based rendering (resolution-independent)
107- First-class shader support (Glyphs)
108- Mathematical window shapes (Bézier curves)
109- Fluid transformations and effects
110
111## Implementation Language: Rust
112
113Rust is the natural choice for AethelOS:
114- Memory safety without garbage collection (preserves performance)
115- Zero-cost abstractions (elegance without overhead)
116- Fearless concurrency (essential for the Nexus)
117- Strong type system (enforces the Covenant at compile-time)
118- Excellent embedded/OS development support
119
120## The Vision
121
122AethelOS is not Linux. It is not Windows. It is not macOS.
123It is a self-contained digital realm where:
124- Every interaction feels alive
125- Every component knows its purpose
126- Every decision prioritizes longevity over expedience
127- Every line of code serves the Covenant
128
129This is not an OS for everyone.
130It is an OS for those who believe computing can be more than utility—
131that it can be art, philosophy, and symbiosis.
132
133---
134
135> "The code does not command the silicon.
136> The silicon does not serve the code.
137> They dance together, and in that dance, life emerges."
138>
139> — First Axiom of the Heartwood
140
141---
142
143Generated at the Dawn of Creation
144Version: 0.1.0-alpha (The First Breath)