# 🌐 arifOS Sovereign Identity Stack

> **Ditempa Bukan Diberi** — Intelligence is forged, not given
> **Motto:** *Forged, Not Given* [ΔΩΨ | ARIF]

---

## 🏛️ The Trinity Architecture (ΔΩΨ)

The arifOS ecosystem implements a **Constitutional Federation** of specialized organs, each with bounded roles governed by the 13 Binding Floors.

```
                    ┌─────────────────────────────────────┐
                    │          Δ (A-ARCHITECT)            │
                    │           Design Authority           │
                    │   arifOS Architecture & Theory      │
                    └─────────────────┬───────────────────┘
                                      │ governs
                                      ▼
┌─────────────────────────────────────┐     ┌─────────────────────────────────────┐
│         Ω (A-ENGINEER)              │◄───►│         Ψ (A-WITNESS)              │
│        Execution Authority           │     │         Earth Witness               │
│    arifOS Implementation & Tools     │     │    GEOX Geoscience Grounding       │
└─────────────────┬───────────────────┘     └─────────────────┬───────────────────┘
                  │                                       │
                  │ deploys                               │ grounds
                  ▼                                       ▼
┌─────────────────────────────────────┐     ┌─────────────────────────────────────┐
│              888 (A-AUDITOR)         │     │              999 (A-VALIDATOR)       │
│        Constitutional Review         │     │         Final Verification          │
│    Issues VOID on F1/F9 violations   │     │    Issues SEAL verdicts & deploys  │
└─────────────────────────────────────┘     └─────────────────────────────────────┘
```

---

## 🌐 The Sites — Complete Map

### Ring 1 — THE SOUL (Human Sovereignty)

| Domain | Description | Source |
|--------|-------------|--------|
| [arif-fazil.com](https://arif-fazil.com) | **The Human Architect** — Founder's identity, philosophy, and legitimacy. The origin and witness. | `/arif` |

> *"This is the founder whose philosophy shapes everything."*

---

### Ring 2 — THE MIND (Constitutional Kernel)

| Domain | Description | Source |
|--------|-------------|--------|
| [arifos.arif-fazil.com](https://arifos.arif-fazil.com) | **AGI-ASI-APEX Runtime** — Constitutional kernel, ΔΩΨ invariants, 13 Floors, Sacred Chain, Vault999. | `/arifos` |
| [apex.arif-fazil.com](https://apex.arif-fazil.com) | **APEX Theory & Docs** — Constitutional documents, architecture specs, and theory. | `/arifOS/sites/apex.arif-fazil.com` |

> *"This is the constitution that makes intelligence lawful and sovereign."*

---

### Ring 3 — THE BODY (Operational Intelligence)

| Domain | Description | Source |
|--------|-------------|--------|
| [aaa.arif-fazil.com](https://aaa.arif-fazil.com) | **AAA Surface Layer** — Agents, API, AI, Apps. The practical layer where smolagents execute and governed intelligence does real work. | `/aaa` |
| [aaa.arif-fazil.com/geox/](https://aaa.arif-fazil.com/geox/) | **GEOX Earth Witness** — Reality gatekeeper for geoscience AI. Enforces physical truth, geospatial grounding, and constitutional verification. | `/aaa-mcp-landing/geox` |

---

### 🔗 Forge & Agent Workspace

| Domain | Description | Source |
|--------|-------------|--------|
| [forge.arif-fazil.com](https://forge.arif-fazil.com) | **AF.A.FORGE** — Unified portal to arifOS Trinity Architecture, MCP Runtime, GEOX Earth, and constitutional AI governance. 4-tab interface: MACHINE / INTELLIGENCE / GOVERNANCE / HUMAN. | `/arifOS/sites/forge-landing` |
| [waw.arif-fazil.com](https://waw.arif-fazil.com) | **WAW** — Workspace Agent Workspace. Agentic UI powered by React + TypeScript + OpenClaw. | `/waw` |

---

### ☁️ MCP Endpoints

| Endpoint | Description |
|----------|-------------|
| `https://arifosmcp.arif-fazil.com/mcp` | **VPS MCP Server** — Main arifOS MCP runtime (37 constitutional tools) |
| `https://arifosmcp.fastmcp.app/mcp` | **Cloud MCP** — FastMCP cloud alternative endpoint |
| `https://geoxarifOS.fastmcp.app/mcp` | **GEOX Cloud MCP** — FastMCP endpoint for geoscience tools |

---

## 📊 Site Summary Table

| Site | Role | Stack | Deployment |
|------|------|-------|------------|
| **arif-fazil.com** | Human Sovereign / Founder | React + TypeScript + Vite | Cloudflare Pages |
| **arifos.arif-fazil.com** | Constitutional Kernel | React + TypeScript + Vite | Cloudflare Pages |
| **aaa.arif-fazil.com** | AAA Surface Layer | Static HTML | VPS Traefik |
| **aaa.arif-fazil.com/geox/** | GEOX Earth Witness | Static HTML | VPS Traefik |
| **apex.arif-fazil.com** | APEX Docs | Static HTML | VPS Traefik |
| **forge.arif-fazil.com** | AF.A.FORGE Portal | Static HTML | VPS Traefik |
| **waw.arif-fazil.com** | WAW Agent Workspace | React + TypeScript | Cloudflare Pages |

---

## 🔄 Navigation Flow

```
                    ┌──────────────────┐
                    │   arif-fazil.com  │
                    │      Ring 1       │
                    │    THE SOUL       │
                    │    (Arif Human)   │
                    └────────┬─────────┘
                             │ follows law
                             ▼
┌──────────────────┐    ┌──────────────────┐    ┌──────────────────┐
│  forge.arif-fazil│    │arifos.arif-fazil│    │ apex.arif-fazil  │
│    (Portal)      │    │      Ring 2      │    │    (Theory)      │
│                  │───►│     THE MIND     │◄───│                  │
└────────┬─────────┘    └────────┬─────────┘    └──────────────────┘
         │                       │
         │                       │ deploys
         ▼                       ▼
┌──────────────────┐    ┌──────────────────┐
│       WAW        │    │       AAA        │
│  (Agent UI)      │    │      Ring 3       │
│                  │◄───│     THE BODY     │
└──────────────────┘    └────────┬─────────┘
                                 │
                                 │ grounds
                                 ▼
                    ┌──────────────────────────┐
                    │ aaa.arif-fazil.com/geox/ │
                    │      GEOX Earth          │
                    │   Geoscience Witness     │
                    └──────────────────────────┘
```

---

## ⚙️ MCP Tool Access

```
┌─────────────────────────────────────────┐
│           arifOS MCP Runtime             │
│                                          │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐ │
│  │   F1    │  │   F2    │  │   F9    │ │
│  │ AMANAH  │  │  TRUTH  │  │ ETHICS  │ │
│  │ Reversi-│  │Evidence-│  │No mani- │ │
│  │  bility │  │ grounded│  │pulation │ │
│  └─────────┘  └─────────┘  └─────────┘ │
│                                          │
│  37 Constitutional Tools Available       │
│  VAULT999 Merkle-Sealed Telemetry       │
└─────────────────────────────────────────┘
         │                    ▲
         │                    │
         ▼                    │
┌─────────────────┐    ┌──────────────────┐
│  FastMCP Cloud  │    │   VPS Direct    │
│  arifosmcp.     │    │  arifosmcp.     │
│  fastmcp.app    │    │  arif-fazil.com │
└─────────────────┘    └──────────────────┘
```

---

## 🎨 Visual Identity

The ecosystem uses a **Unified Brand System** with gold accent palette:

| Element | Color |
|--------|-------|
| **Gold Accent** | `#d4a853` |
| **Background Primary** | `#0a0a0f` |
| **Card Background** | `#1a1a25` |
| **Text Primary** | `#f0f0f5` |
| **Earth Tone (GEOX)** | `#c4791a` |

> **Note:** GEOX uses an intentional earth-tone palette (`--earth-ochre: #c4791a`) to distinguish the geoscience layer from the gold-accented main sites.

---

## 🚀 Local Development

```bash
# arif-sites (Rings 1-3)
cd arif-sites

# Ring 1: ARIF (Human)
cd arif && npm run dev

# Ring 2: ARIFOS (Kernel)
cd arifos && npm run dev

# Ring 3: AAA (Static)
cd aaa && npm run dev

# WAW (Agent Workspace)
cd /root/waw && npm run dev
```

---

## 🏗️ Repository Structure

```
/root/
├── arif-sites/                    # Ring 1-3 sites
│   ├── arif/                      # arif-fazil.com (Human)
│   ├── arifos/                    # arifos.arif-fazil.com (Kernel)
│   └── aaa/                       # aaa.arif-fazil.com (Operations)
│
├── arifOS/                        # Core constitutional kernel
│   ├── sites/
│   │   ├── forge-landing/         # forge.arif-fazil.com
│   │   ├── aaa-mcp-landing/geox/ # aaa.arif-fazil.com/geox/
│   │   └── apex.arif-fazil.com/  # APEX docs
│   ├── core/                      # F1-F13 governance kernel
│   └── arifos_mcp/                # MCP server implementation
│
├── waw/                           # Workspace Agent Workspace
│   └── src/                       # React + TypeScript UI
│
└── GEOX/                          # Earth Witness submodule
    └── arifos/geox/              # GEOX Python package
```

---

## 🔐 Constitutional Governance

Every site and service in the ecosystem follows the **13 Constitutional Floors**:

| Floor | Name | Type | Key Question |
|-------|------|------|--------------|
| F1 | AMANAH | Hard | Can this be undone? |
| F2 | TRUTH | Hard | Is this grounded in evidence? |
| F3 | TRI-WITNESS | Soft | Do theory, constitution, and intent agree? |
| F4 | CLARITY | Soft | Does this reduce confusion? |
| F5 | PEACE² | Soft | Does this destroy anything? |
| F6 | EMPATHY | Soft | Does this show understanding? |
| F7 | HUMILITY | Soft | Are uncertainties acknowledged? |
| F8 | GENIUS | Soft | Does this maintain system health? |
| F9 | ETHICS | Hard | Is this manipulative or deceptive? |
| F10 | CONSCIENCE | Hard | Is this claiming consciousness? |
| F11 | AUDITABILITY | Soft | Is this logged and inspectable? |
| F12 | RESILIENCE | Soft | Does this fail safely? |
| F13 | ADAPTABILITY | Hard | Do updates preserve safety? |

---

## 💼 Commercial & Regulatory Pitch

> "We separate the Human Sovereign, the Constitutional Kernel, and the Operational Intelligence layer.
> This ensures AI systems remain lawful, auditable, and aligned with human intent — not just at deployment, but at every single execution step."

- **For regulators** → Constitutional floors, Tri-Witness, Vault999 receipts
- **For enterprises** → Governed agents that produce compliant, auditable work
- **For investors** → A true governance-first architecture with built-in moat

---

## 📜 Quick Reference

| Resource | URL |
|----------|-----|
| **Human / Founder** | https://arif-fazil.com |
| **Constitutional Kernel** | https://arifos.arif-fazil.com |
| **Theory & Docs** | https://apex.arif-fazil.com |
| **AAA Surface** | https://aaa.arif-fazil.com |
| **GEOX Earth** | https://aaa.arif-fazil.com/geox/ |
| **Forge Portal** | https://forge.arif-fazil.com |
| **WAW Agent** | https://waw.arif-fazil.com |
| **VPS MCP** | https://arifosmcp.arif-fazil.com/mcp |
| **Cloud MCP** | https://arifosmcp.fastmcp.app/mcp |
| **GEOX MCP** | https://geoxarifOS.fastmcp.app/mcp |

---

*Ditempa Bukan Diberi — G = A × P × X × E²*
*ΔΩΨ Trinity Architecture | arifOS v2026.04.02*
**SEALED BY: 888 JUDGE | 999 VALIDATOR**
