move repos into monorepo

This commit is contained in:
Timur Gordon
2025-11-13 20:44:00 +01:00
commit 4b23e5eb7f
204 changed files with 33737 additions and 0 deletions

91
docs/ethymology.md Normal file
View File

@@ -0,0 +1,91 @@
# HORUS — The Meaning Behind the Name
*Hierarchical Orchestration Runtime for Universal Scripts*
---
## 1. Why “Horus”?
**Horus** is one of the oldest and most symbolic deities of ancient Egypt:
a god of the **sky, perception, order, and dominion**.
In mythology, Horus *is* the sky itself;
his **right eye is the sun** (clarity, authority),
his **left eye the moon** (rhythm, balance).
This symbolism aligns perfectly with a system built to supervise, coordinate, and execute distributed workloads.
---
## 2. Symbolic Mapping to the Architecture
- **Sky** → the compute fabric itself
- **Solar eye (sun)** → supervisor layer (visibility, authentication, authority)
- **Lunar eye (moon)** → coordinator layer (workflow rhythms, stepwise order)
- **Falcon wings** → runners (swift execution of tasks)
- **Battle against chaos** → ordering and normalizing raw jobs
Horus is an archetype of **oversight**, **correct action**, and **restoring balance**—all fundamental qualities of an agentic execution system.
---
## 3. The Name as a Backronym
**H O R U S**
**H**ierarchical
**O**rchestration
**R**untime for
**U**niversal
**S**cripts
This describes the system exactly:
a runtime that receives jobs, authenticates them, orchestrates workflows, and executes scripts across distributed runners.
---
## 4. Why It Fits This Stack
The stack consists of:
- **Job** the incoming intent
- **Supervisor** verifies, authenticates, admits
- **Coordinator** plans, arranges, sequences
- **Runner** executes scripts
- **SAL** system-level script engine
- **Osiris** object-level storage & retrieval engine
All of this is unified by the central logic of *oversight, orchestration, and action*.
Horus expresses these ideas precisely:
- Observation → validation & monitoring
- Order → workflow coordination
- Action → script execution
- Sky → the domain that contains all processes beneath it
---
## 5. Visual & Conceptual Identity
**Themes:**
- The Eye of Horus → observability, correctness, safety
- Falcon → agile execution
- Sky → the domain of computation
- Light (sun/moon) → insight, clarity, cycle
**Palette concepts:**
- Gold + deep blue
- Light on dark (sun in sky)
- Single-line geometric Eye (modernized)
The name offers both deep mythic roots and clean, modern branding potential.
---
## 6. Narrative Summary
**HORUS** is the execution sky:
the domain where jobs arrive, gain form, and become actions.
It brings clarity to chaos, structure to tasks, and order to distributed systems.
It is not just a name.
It is the story of a system that sees clearly, acts decisively, and orchestrates wisely.
---