GEOX_PLATFORM_HUBNODE // UNIFIED_ARCHITECTURE
GEOX_PLATFORM_HUBNODE // UNIFIED_ARCHITECTURE

GEOX — Unified Architecture

Complete system documentation — Final unified state (2026-04-12)

💎 DITEMPA BUKAN DIBERI 🔥
Forged, Not Given — Chaos Unified

Overview

The GEOX system has undergone a chaos resolution process, unifying two previously divergent realities into a single coherent architecture. This document serves as the definitive reference for the final unified state.

What changed: The "Two GEOX Realities" (Core vs Platform) now coexist within a unified architecture, with arifOS MCP providing constitutional governance (F1-F13) across both.

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                    UNIFIED GEOX + arifOS PLATFORM                │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│   ┌──────────────┐      ┌──────────────┐      ┌──────────────┐  │
│   │  GEOX Core   │◄────►│ arifOS MCP   │◄────►│ GEOX Platform│  │
│   │  (Anti-Chaos)│      │ (F1-F13)     │      │ (44 Skills)  │  │
│   └──────────────┘      └──────────────┘      └──────────────┘  │
│          │                      │                      │         │
│          └──────────────────────┼──────────────────────┘         │
│                                 │                                │
│                    ┌────────────┴────────────┐                   │
│                    │  https://geox.arif-f    │                   │
│                    │  azil.com/ (SOT)        │                   │
│                    └─────────────────────────┘                   │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

Component Interaction

  • GEOX Core handles canonical MCP protocol (dimensions, contracts)
  • GEOX Platform preserves 44 skills and 11 agents (legacy capability)
  • arifOS MCP provides constitutional governance (F1-F13) for both

GEOX Core

OPERATIONAL

Property Value
Location /root/arifOS/geox/
Architecture Anti-Chaos (5 functional planes)
Dimensions 5 (prospect, well, earth3d, map, cross)
Version 2.0.0-DIMENSION-NATIVE
Container geox_eic
Seal DITEMPA BUKAN DIBERI

Functional Planes

  1. Contracts — Single source of truth (enums, schemas, tools)
  2. Control Plane — Routing, coordination, FastMCP server
  3. Execution Plane — Calculations, VPS adapters
  4. Compatibility — Legacy aliases and migration paths
  5. Services — Evidence store, geo fabric, governance, witness

GEOX Platform

RESTORED

Property Value
Location /root/geox/
Type Skill Platform
Skills 44
Agents 11
Status Restored from git (accidentally deleted)

Directory Structure

/root/geox/
├── mcp/           # MCP server implementations
├── registry/      # Tool registries
├── schemas/       # Data schemas
├── site/          # Static site
└── skills/        # 44 GEOX skills

arifOS MCP

OPERATIONAL

Property Value
Location /root/arifOS/
Type Constitutional MCP Server
Tools 17
Floors F1-F13 (Constitutional)
Version 2026.04.07
Container arifosmcp
Verdict SEAL

Constitutional Floors (F1-F13)

Floor Name Status
F1 Irreversible Change Control ACTIVE
F2 Truth ACTIVE
F4 Entropy ACTIVE
F7 Confidence ACTIVE
F9 Injection Guard ACTIVE
F11 Coherence ACTIVE
F13 Human Authority ACTIVE

Single Source of Truth (SOT) Endpoints

Endpoint Status Purpose
mcp.arif-fazil.com 200 OK MCP Server SOT
geox.arif-fazil.com 200 OK GEOX APPS SOT
geox.arif-fazil.com/status/ 200 OK Runtime Status Dashboard
geox.arif-fazil.com/status.json 200 OK Machine-readable Runtime State

Deployment

Containers

NAME            STATUS                    PORTS
geox_eic        Up (healthy)              0.0.0.0:8000->8000/tcp
arifosmcp       Up (healthy)              0.0.0.0:8080->8080/tcp
arifos_landings Up                        80/tcp

Networks

  • arifos_core_network — Core internal communication
  • arifos_trinity — Trinity protocol layer
  • traefik_network — Edge routing

Volume Mounts

/opt/arifos/sites/arif-fazil.com/geox      → /usr/share/nginx/html/geox
/opt/arifos/sites/arif-fazil.com/arifosmcp → /usr/share/nginx/html/arifosmcp
/root/arifOS/infrastructure/nginx/arifos_landings.conf → /etc/nginx/conf.d/default.conf

Git Source of Truth

Repository Commit Message
arifOS d0eafa7 chore: Update GEOX submodule with SOT status page
GEOX cf9fe28 feat: Add runtime SOT status.json and status page

arifOS: https://github.com/ariffazil/arifOS
GEOX: https://github.com/ariffazil/GEOX

Chaos Resolution Log

Issues Resolved

1. WebMCP Deletion

Problem: arifosmcp/runtime/webmcp/server.py was moved to archive during cleanup, breaking arifos_init.

Fix: Restored from .archive/build/lib/.

2. Two GEOX Realities

Problem: Confusion between GEOX Core (Anti-Chaos) and GEOX Platform (44 skills).

Fix: Unified architecture with clear separation of concerns.

3. FastMCP Alias Registration

Problem: FastMCP only registers the last @mcp.tool() decorator when multiple are applied to one function.

Fix: Created separate wrapper functions for each alias in cross.py.

4. Missing SOT Documentation

Problem: Runtime state not documented, causing drift between deployed and documented state.

Fix: Created status.json and status/ page documenting actual runtime state.

✅ CHAOS UNIFIED
Runtime = Documented = Deployed