Metadata-Version: 2.4
Name: arifos
Version: 1!2026.7.24
Summary: mcp-name: io.github.ariffazil/arifos | .ariffazil/arifos | arifOS v1!2026.7.17.post4 — Constitutional AI Governance Kernel. 8 kernel ABI capabilities → 6 public tools (arif_verb_noun, generated from arifosmcp/abi/capability_registry.json), dynamic F1-F13 enforcement via ConstitutionKernel + FloorEvaluator, VAULT999 immutable ledger, streamable-http MCP transport. Kernel substrate for AGI/ASI federation.
Author-email: Muhammad Arif bin Fazil <arifbfazil@gmail.com>
Maintainer-email: Muhammad Arif bin Fazil <arifbfazil@gmail.com>
License-Expression: AGPL-3.0-only
Project-URL: Homepage, https://arifos.arif-fazil.com
Project-URL: Documentation, https://github.com/ariffazil/arifos
Project-URL: Repository, https://github.com/ariffazil/arifos
Project-URL: Issues, https://github.com/ariffazil/arifos/issues
Project-URL: Trinity, https://github.com/ariffazil/arifos/blob/main/KERNEL/TRINITY_ARCHITECTURE.md
Project-URL: PyPI, https://pypi.org/project/arifos/
Keywords: ai-governance,ai-safety,constitutional-ai,ai-filter,ai-guardrails,truth-detection,empathy,reversibility,clarity,humility,atlas-333,smart-routing,888-hold,crisis-detection,trinity-architecture,agi-asi-apex,tri-witness,mcp,mcp-server,model-context-protocol,chatgpt,claude,claude-desktop,cursor-ide,gemini,llm,hallucination-prevention,immutable-ledger,merkle-audit,thermodynamic-governance
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: Security
Classifier: Typing :: Typed
Requires-Python: <3.15,>=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=2.4.6
Requires-Dist: pydantic>=2.13.4
Requires-Dist: pydantic-settings>=2.7.0
Requires-Dist: anyio>=4.13.0
Requires-Dist: starlette>=1.3.1
Requires-Dist: itsdangerous>=2.2.0
Requires-Dist: fastmcp[tasks]==3.4.4
Requires-Dist: prefab-ui==0.13.1
Requires-Dist: openapi-pydantic>=0.5.1
Requires-Dist: fastapi>=0.136.1
Requires-Dist: uvicorn[standard]>=0.49.0
Requires-Dist: sse-starlette>=1.8.2
Requires-Dist: mcp>=1.0.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: prometheus-client>=0.25.0
Requires-Dist: rich>=15.0.0
Requires-Dist: asyncpg>=0.31.0
Requires-Dist: redis>=5.0.0
Requires-Dist: cryptography>=49.0.0
Requires-Dist: psutil>=7.2.2
Requires-Dist: python-dotenv>=1.2.2
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: requests>=2.31.0
Requires-Dist: py-key-value-aio[redis]>=0.4.0
Requires-Dist: psycopg2-binary>=2.9.12
Requires-Dist: aiofiles>=23.2.1
Requires-Dist: structlog>=24.4.0
Requires-Dist: blake3>=1.0.0
Requires-Dist: qdrant-client>=1.18.0
Provides-Extra: ml
Requires-Dist: sentence-transformers>=5.6.0; extra == "ml"
Requires-Dist: scikit-learn>=1.9.0; extra == "ml"
Provides-Extra: vectors
Requires-Dist: chromadb>=0.5.0; extra == "vectors"
Requires-Dist: qdrant-client>=1.18.0; extra == "vectors"
Requires-Dist: lancedb>=0.5.0; extra == "vectors"
Provides-Extra: browser
Requires-Dist: playwright>=1.49.0; extra == "browser"
Requires-Dist: beautifulsoup4>=4.12.0; extra == "browser"
Requires-Dist: duckduckgo-search>=6.3.0; extra == "browser"
Provides-Extra: heavy
Requires-Dist: torch>=2.12.1; extra == "heavy"
Requires-Dist: transformers>=5.12.1; extra == "heavy"
Provides-Extra: observe
Requires-Dist: opentelemetry-api>=1.42.1; extra == "observe"
Requires-Dist: opentelemetry-sdk>=1.42.1; extra == "observe"
Requires-Dist: opentelemetry-exporter-otlp>=1.42.1; extra == "observe"
Requires-Dist: opentelemetry-instrumentation-fastapi>=0.45b0; extra == "observe"
Requires-Dist: opentelemetry-instrumentation-starlette>=0.45b0; extra == "observe"
Requires-Dist: opentelemetry-instrumentation-httpx>=0.45b0; extra == "observe"
Provides-Extra: io
Requires-Dist: pymupdf>=1.25.0; extra == "io"
Requires-Dist: pdfplumber>=0.11.0; extra == "io"
Requires-Dist: python-docx>=1.1.2; extra == "io"
Requires-Dist: openpyxl>=3.1.5; extra == "io"
Requires-Dist: pillow>=11.0.0; extra == "io"
Requires-Dist: blake3>=1.0.0; extra == "io"
Requires-Dist: pynacl>=1.6.2; extra == "io"
Provides-Extra: search
Requires-Dist: tavily-python>=0.5.0; extra == "search"
Requires-Dist: exa-py>=2.14.0; extra == "search"
Requires-Dist: firecrawl-py>=1.3.0; extra == "search"
Requires-Dist: trafilatura>=1.12.0; extra == "search"
Requires-Dist: readability-lxml>=0.8.4.1; extra == "search"
Requires-Dist: markdownify>=0.13.1; extra == "search"
Requires-Dist: html2text>=2024.2.26; extra == "search"
Requires-Dist: bleach>=6.4.0; extra == "search"
Requires-Dist: defusedxml>=0.7.1; extra == "search"
Requires-Dist: tldextract>=5.3.1; extra == "search"
Provides-Extra: google
Requires-Dist: google-api-python-client>=2.160.0; extra == "google"
Requires-Dist: google-auth-httplib2>=0.4.0; extra == "google"
Requires-Dist: google-auth-oauthlib>=1.4.0; extra == "google"
Requires-Dist: google-genai>=0.1.0; extra == "google"
Provides-Extra: db
Requires-Dist: sqlalchemy>=2.0.36; extra == "db"
Requires-Dist: alembic>=1.18.4; extra == "db"
Provides-Extra: geox
Requires-Dist: lasio>=0.32; extra == "geox"
Requires-Dist: welly>=0.5.2; extra == "geox"
Requires-Dist: striplog>=0.9.2; extra == "geox"
Requires-Dist: segyio>=1.9.14; extra == "geox"
Requires-Dist: statsmodels>=0.14.6; extra == "geox"
Requires-Dist: scikit-learn>=1.9.0; extra == "geox"
Requires-Dist: scipy>=1.17.1; extra == "geox"
Requires-Dist: matplotlib>=3.11.0; extra == "geox"
Requires-Dist: pyproj>=3.7.2; extra == "geox"
Requires-Dist: setuptools<70; extra == "geox"
Provides-Extra: wealth
Requires-Dist: supabase>=2.10.0; extra == "wealth"
Requires-Dist: numpy-financial>=1.0.0; extra == "wealth"
Requires-Dist: psycopg[binary]>=3.3.4; extra == "wealth"
Requires-Dist: yfinance>=0.2.0; extra == "wealth"
Requires-Dist: duckdb>=0.10.0; extra == "wealth"
Requires-Dist: polars>=1.0.0; extra == "wealth"
Requires-Dist: pyarrow>=17.0.0; extra == "wealth"
Requires-Dist: networkx>=3.3; extra == "wealth"
Requires-Dist: pyportfolioopt>=1.5.5; extra == "wealth"
Requires-Dist: pandera>=0.19.0; extra == "wealth"
Requires-Dist: quantlib>=1.42.1; extra == "wealth"
Requires-Dist: riskfolio-lib>=7.3.0; extra == "wealth"
Requires-Dist: pymc>=6.0.1; extra == "wealth"
Requires-Dist: arviz>=1.2.0; extra == "wealth"
Requires-Dist: mesa>=3.5.1; extra == "wealth"
Requires-Dist: pydantic-ai>=0.0.14; extra == "wealth"
Requires-Dist: langgraph>=0.2.0; extra == "wealth"
Provides-Extra: well
Provides-Extra: aaa
Requires-Dist: nats-py>=2.15.0; extra == "aaa"
Requires-Dist: httpx>=0.28.1; extra == "aaa"
Requires-Dist: pyjwt>=2.9.0; extra == "aaa"
Provides-Extra: forge
Requires-Dist: httpx>=0.28.1; extra == "forge"
Requires-Dist: sse-starlette>=1.8.2; extra == "forge"
Provides-Extra: federation
Requires-Dist: arifos[geox]; extra == "federation"
Requires-Dist: arifos[wealth]; extra == "federation"
Requires-Dist: arifos[well]; extra == "federation"
Requires-Dist: arifos[aaa]; extra == "federation"
Requires-Dist: arifos[forge]; extra == "federation"
Requires-Dist: arifos[io]; extra == "federation"
Requires-Dist: arifos[search]; extra == "federation"
Provides-Extra: openai
Requires-Dist: openai>=1.60.0; extra == "openai"
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.40.0; extra == "anthropic"
Provides-Extra: dev
Requires-Dist: pytest>=9.1.1; extra == "dev"
Requires-Dist: pytest-asyncio>=1.3.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: ruff>=0.15.18; extra == "dev"
Requires-Dist: mypy>=2.1.0; extra == "dev"
Requires-Dist: httpx>=0.28.1; extra == "dev"
Requires-Dist: hypothesis>=6.155.7; extra == "dev"
Requires-Dist: python-lsp-server>=1.11.0; extra == "dev"
Requires-Dist: aiohttp>=3.9.0; extra == "dev"
Provides-Extra: full
Requires-Dist: arifos[aaa,anthropic,browser,db,geox,google,heavy,io,ml,observe,openai,search,vectors,wealth]; extra == "full"
Provides-Extra: yaml
Requires-Dist: pyyaml>=6.0.0; extra == "yaml"
Provides-Extra: api
Requires-Dist: fastapi>=0.136.1; extra == "api"
Requires-Dist: uvicorn[standard]>=0.49.0; extra == "api"
Requires-Dist: python-multipart>=0.0.6; extra == "api"
Provides-Extra: postgres
Requires-Dist: asyncpg>=0.31.0; extra == "postgres"
Provides-Extra: litellm
Requires-Dist: litellm>=1.0.0; extra == "litellm"
Provides-Extra: governed
Requires-Dist: litellm>=1.0.0; extra == "governed"
Requires-Dist: httpx>=0.28.1; extra == "governed"
Requires-Dist: pygments>=2.16.0; extra == "governed"
Requires-Dist: openai>=1.60.0; extra == "governed"
Provides-Extra: observability
Requires-Dist: pyjwt>=2.8.0; extra == "observability"
Requires-Dist: opentelemetry-api>=1.42.1; extra == "observability"
Requires-Dist: opentelemetry-sdk>=1.42.1; extra == "observability"
Requires-Dist: opentelemetry-exporter-otlp>=1.42.1; extra == "observability"
Requires-Dist: opentelemetry-instrumentation-fastapi>=0.45b0; extra == "observability"
Requires-Dist: opentelemetry-instrumentation-starlette>=0.45b0; extra == "observability"
Requires-Dist: opentelemetry-instrumentation-httpx>=0.45b0; extra == "observability"
Requires-Dist: prometheus-client>=0.25.0; extra == "observability"
Provides-Extra: viz
Requires-Dist: matplotlib>=3.8.0; extra == "viz"
Requires-Dist: pandas>=2.1.0; extra == "viz"
Provides-Extra: all
Requires-Dist: arifos[aaa,anthropic,browser,db,geox,google,heavy,io,ml,observe,openai,search,vectors,wealth]; extra == "all"
Dynamic: license-file

mcp-name: io.github.ariffazil/arifos
<!-- SOT-MANIFEST
federation_release: v2026.07.24
last_verified: 2026-07-24T16:00Z
live_commit: 68d5b8a37
live_port: 8088 (healthy)
tools_exposed_via_mcp: 8 (canonical public verbs)
total_declared_tools: 48 (includes diagnostics, aliases, canary)
floors_active: 13
federation_schema: 2.0.0
organs: 6 live (arifOS:8088, A-FORGE:7071, AAA:3001, GEOX:8081, WEALTH:18082, WELL:18083)
owner_summary: GREEN
truth_rule: /health + MCP tools/list beat any static count in prose
-->

**SOT:** 2026-07-24 | **seal_seq:** `68d5b8a37`

<div align="center">

```
   █████╗ ██████╗ ██╗███████╗ ██████╗ ███████╗
  ██╔══██╗██╔══██╗██║██╔════╝██╔═══██╗██╔════╝
  ███████║██████╔╝██║█████╗  ██║   ██║███████╗
  ██╔══██║██╔══██╗██║██╔══╝  ██║   ██║╚════██║
  ██║  ██║██║  ██║██║██║     ╚██████╔╝███████║
  ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚═╝      ╚═════╝ ╚══════╝

  Constitutional AI Governance Kernel
  ─────────────────────────────────────────
  Not a chatbot. Not a model wrapper.
  The constitutional governance layer
  between agents and irreversible action.
```
<hr/>
<p align="center">
  <a href="https://glama.ai/mcp/servers/ariffazil/arifos"><img src="https://img.shields.io/badge/Glama-arifOS-6e3bff" alt="Glama MCP Server"></a>
  <a href="https://smithery.ai/server/arifos"><img src="https://img.shields.io/badge/Smithery-arifOS-ff6b35" alt="Smithery"></a>
</p>

## Quick Connect

| Registry | Link |
|----------|------|
| **Glama** | [glama.ai/mcp/servers/ariffazil/arifos](https://glama.ai/mcp/servers/ariffazil/arifos) |
| **Smithery** | [smithery.ai/server/arifos](https://smithery.ai/server/arifos) |
| **llms.txt** | [arifos.arif-fazil.com/llms.txt](https://arifos.arif-fazil.com/llms.txt) |
| **MCP Endpoint** | `https://mcp.arif-fazil.com/mcp` |

</div>

[![Unified CI](https://github.com/ariffazil/arifos/actions/workflows/01-unified-ci.yml/badge.svg?branch=main)](https://github.com/ariffazil/arifos/actions/workflows/01-unified-ci.yml)
[![MCP Conformance](https://github.com/ariffazil/arifos/actions/workflows/06-mcp-conformance.yml/badge.svg?branch=main)](https://github.com/ariffazil/arifos/actions/workflows/06-mcp-conformance.yml)
[![⚖️ KERNEL](https://img.shields.io/badge/%E2%9A%96%EF%B8%8F%20KERNEL-8%20tools-0a7b83)](https://arifos.arif-fazil.com/mcp)
[![Federation](https://img.shields.io/badge/Federation-6%20organs-1f6feb)](#5-federation-architecture)
[![ChatGPT](https://img.shields.io/badge/ChatGPT-✔-brightgreen)](#connecting-from-chatgpt)
[![Claude Desktop](https://img.shields.io/badge/Claude%20Desktop-✔-brightgreen)](#connecting-from-claude-desktop)
[![PyPI](https://img.shields.io/pypi/v/arifos?label=PyPI)](https://pypi.org/project/arifos/)
[![License](https://img.shields.io/github/license/ariffazil/arifos?label=AGPL--3.0)](LICENSE)

> **New agents:** Read `ZEN.md` first — it is the minimum viable context.

---

## TL;DR — Three Audiences

**For human operators (Arif):** arifOS is the constitutional judge. It decides what agents may NOT do so they can be trusted with what they CAN do. You (F13) hold the final veto. [§1](#1-what-is-arifos)

**For AI agents:** arifOS is your governance kernel. Init a session, observe reality, think, route to organs, and — after judge clearance — execute. 8 canonical verbs. Never skip the chain. [§3](#3-the-8-canonical-public-tools)

**For developers/institutions:** arifOS is a Python 3.12 FastMCP kernel enforcing 13 constitutional floors across 6 federation organs. Public endpoint at `https://mcp.arif-fazil.com/mcp`. [§2](#2-quick-start)

---

## 1. What Is arifOS?

arifOS is a **constitutional governance kernel** that sits between AI agents and their tools, enforcing 13 floors before any irreversible action.

| arifOS IS | arifOS IS NOT |
|-----------|---------------|
| The law layer — decides what agents must NOT do | An AI model, chatbot, or startup |
| A constitutional kernel with 8 canonical verbs | LangChain, CrewAI, or AutoGen |
| A federation hub — 6 live organs + VAULT999 ledger | A replacement for human judgment |
| An immutable ledger — every decision sealed forever | Self-authorizing — requires F13 for SEAL |
| Built for one sovereign — Muhammad Arif bin Fazil | A general-purpose agent framework |
| **This deployment** is sovereign-bound to Arif | The **architecture** may be studied, forked, or adapted |

```mermaid
graph LR
    A[👤 ARIF<br/>F13 Sovereign] -->|intent| B[AAA<br/>Cockpit :3001]
    B -->|routes to| C[arifOS<br/>Judge :8088]
    C -->|000| D[arif_init<br/>Session]
    D -->|111| E[arif_observe<br/>Evidence]
    E -->|333| F[arif_think<br/>Reason]
    F -->|444| G[arif_route<br/>Dispatch]
    G --> H{Organ?}
    H -->|earth| I[🌍 GEOX]
    H -->|capital| J[💰 WEALTH]
    H -->|readiness| K[🫀 WELL]
    I & J & K -->|evidence| L[555 arif_memory<br/>Governed Recall]
    L -->|888| M{arif_judge<br/>Verdict}
    M -->|SEAL| N[777 arif_forge<br/>A-FORGE :7071]
    M -->|HOLD| O[SABAR<br/>Human Review]
    M -->|VOID| P[🚫 Blocked]
    N -->|999| Q[(VAULT999<br/>Immutable Seal)]
```

**Trinity role:** arifOS = LAW/JUDGMENT. The judge. AAA = STATE/ROUTING. A-FORGE = EXECUTION/MUTATION.

### Federation Separation of Powers

The arifOS Federation separates authority from capability:

| Layer | Role | Can | Cannot |
|-------|------|-----|--------|
| **ARIF** | Sovereign | Veto, approve, decide | Be overridden |
| **AAA** | State / Cockpit | Display, route, queue, register | Judge, execute, seal |
| **arifOS** | Judge | Issue SEAL/HOLD/VOID/SABAR | Execute mutations |
| **Domain Organs** | Witnesses | Compute and reflect evidence | Decide alone |
| **A-FORGE** | Executor | Build, deploy, mutate | Self-authorize |
| **VAULT999** | Ledger | Record immutable seals | Edit or delete history |

> AAA routes and displays. arifOS judges. Domain organs witness. A-FORGE executes. VAULT999 records. ARIF decides.

---

## 2. Quick Start

### Human Operators
- **Cockpit:** https://aaa.arif-fazil.com
- **Telegram:** @ASI_arifos_bot
- **Health:** https://arifos.arif-fazil.com/health

### AI Agents (MCP Clients)
```json
{
  "mcpServers": {
    "arifOS": {
      "url": "https://mcp.arif-fazil.com/mcp",
      "transport": "streamable-http"
    }
  }
}
```

### Developers
```bash
git clone git@github.com:ariffazil/arifos.git && cd arifOS
uv sync --all-extras
python -m arifosmcp.runtime.server           # starts on :8088
curl http://127.0.0.1:8088/health
python -m pytest tests/ -q --tb=short
```

---

## 3. The 8 Canonical Public Tools

All tools use `arif_<verb>` naming. Internal aliases are absorbed as modes on canonical tools. **Exactly 8 tools on the wire.**

| # | Tool | Stage | What It Does | Key Modes |
|---|------|-------|-------------|-----------|
| 1 | `arif_init` | 000 | Session ignition — binds actor, floors, audit | init, resume, preflight, triage |
| 2 | `arif_observe` | 111 | Sense reality into evidence | search, fetch, vitals, entropy_dS |
| 3 | `arif_think` | 333 | Structured reasoning under F2/F7 | reason, plan, reflect, verify, critique |
| 4 | `arif_route` | 444 | Route intent to federation organ | route, bridge |
| 5 | `arif_memory` | 555 | Constitutional memory governor (L1–L6) | recall, remember, promote, revise |
| 6 | `arif_judge` | 888 | Constitutional verdict — SEAL/HOLD/SABAR/VOID | judge, compare, witness_consensus |
| 7 | `arif_forge` | 777 | Guarded execution gate (requires prior SEAL) | engineer, dry_run, write, commit |
| 8 | `arif_seal` | 999 | VAULT999 immutable append (irreversible) | seal, verify, chain, dry_run |

```
000 → 111 → 333 → 444 → 555 → 888 → 777 → 999
init → observe → think → route → memory → judge → forge → seal
```

**Internal aliases** (absorbed into canonical modes): `arif_triage` → `arif_init(preflight)`, `arif_critique` → `arif_think(critique)`, `arif_bridge_connect` → `arif_route(bridge)`, `arif_act` → `arif_forge`

**Source of truth:** `tools/list` (runtime) beats any static manifest.

---

## 4. The 13 Constitutional Floors

| # | Floor | Type | Rule |
|---|-------|------|------|
| F1 | AMANAH | HARD | Reversible first. Irreversible → 888_HOLD |
| F2 | TRUTH | HARD | P(truth) ≥ 0.99. Fabrication = VOID |
| F3 | WITNESS | DERIVED | Multi-party consensus for high-blast actions |
| F4 | CLARITY | HARD | ΔS ≤ 0 — every output reduces entropy |
| F5 | PEACE² | SOFT | Non-destructive power |
| F6 | EMPATHY | SOFT | Protect weakest stakeholder |
| F7 | HUMILITY | HARD | Cap confidence at 0.90 |
| F8 | GENIUS | DERIVED | G ≥ 0.80 for complex actions |
| F9 | ANTIHANTU | HARD | No deception, manipulation, consciousness claims |
| F10 | ONTOLOGY | HARD | AI is instrument. No soul, no feelings |
| F11 | AUDIT | HARD | Every decision logged and inspectable |
| F12 | RESILIENCE | HARD | Injection defense |
| F13 | SOVEREIGN | HARD | **Human veto FINAL.** Strongest floor |

**HARD violation → VOID (blocked). SOFT tension → CAUTION/HOLD. DERIVED → informational.**

---

## 5. Federation Architecture

```
                         ┌──────────────────────┐
                         │  Arif (F13 SOVEREIGN) │
                         └──────────┬───────────┘
                                    │
       ┌────────────────────────────┼────────────────────────────┐
       │                            │                            │
  ┌────▼─────┐              ┌───────▼───────┐            ┌───────▼───────┐
  │  Hermes  │              │      AAA      │            │   OpenClaw    │
  │  🧠 :8644│              │  🖥️  :3001    │            │   🤖 :18789   │
  │ Telegram │              │   Cockpit     │            │  Transport    │
  └──────────┘              └───────────────┘            └───────────────┘
                                    │
                         ┌──────────▼──────────┐
                         │    arifOS (Ω)        │
                         │    Kernel :8088      │
                         │    F1-F13 · 888 JUDGE│
                         └──┬───┬───┬───┬──────┘
                            │   │   │   │
          ┌─────────────────┼───┼───┼───┼─────────────────┐
          │                 │   │   │   │                 │
    ┌─────▼────┐   ┌───────▼┐ ┌▼─────┐ ┌▼────────┐  ┌────▼─────┐
    │  GEOX    │   │WEALTH  │ │ WELL │ │A-FORGE  │  │ VAULT999 │
    │  🌍 :8081│   │💰:18082│ │🫀:18083│ │⚒️:7071  │  │ 🔒 Seal  │
    │ Evidence │   │Compute │ │Reflect│ │Execute  │  │ Immutable│
    └──────────┘   └────────┘ └──────┘ └─────────┘  └──────────┘
```

| Organ | Port | Role | Must Never |
|-------|------|------|------------|
| **arifOS** | 8088 | Constitutional kernel | Self-authorize |
| GEOX | 8081 | Earth intelligence | Authorize drilling |
| WEALTH | 18082 | Capital intelligence | Allocate capital |
| WELL | 18083 | Human readiness (REFLECT_ONLY) | Diagnose |
| AAA | 3001 | Control plane / cockpit | Issue verdicts |
| A-FORGE | 7071/7072 | Execution shell | Self-authorize |
| VAULT999 | — | Immutable audit ledger | Edit or delete |

**Authority chain:** Arif → AAA/Hermes → arifOS → Domain Organs → A-FORGE → VAULT999

---

## 6. Build, Test, Deploy

```bash
# Development
uv sync --all-extras
uv run python -m arifosmcp.runtime.server
python -m pytest tests/ -q --tb=short
ruff check . && ruff format .

# Deploy to VPS
make deploy-local                  # rsync + systemctl restart arifos
systemctl status arifos

# Docker
docker build -t ghcr.io/ariffazil/arifos:latest .
```

---

## 7. MCP Connection Guide

### Public Endpoint
| Property | Value |
|----------|-------|
| **Endpoint** | `https://mcp.arif-fazil.com/mcp` |
| **Transport** | Streamable HTTP (JSON-RPC 2.0) |
| **Protocol** | MCP 2025-11-25 |
| **Health** | `https://arifos.arif-fazil.com/health` |
| **Tools** | 8 canonical + diagnostics (filtered from default tools/list) |

### Internal Organs
| Organ | Endpoint | When |
|-------|----------|------|
| arifOS | `localhost:8088` | Governance, judgment, routing |
| A-FORGE | `localhost:7071` | Build, deploy, filesystem, git |
| GEOX | `localhost:8081` | Seismic, wells, petrophysics |
| WEALTH | `localhost:18082` | NPV, risk, capital flow |
| WELL | `localhost:18083` | Vitality, readiness, dignity |

**Rule:** arifOS judges → A-FORGE executes → VAULT999 records. Never skip the chain.

### Connecting from ChatGPT, Claude, Cursor

```json
{ "mcpServers": { "arifOS": { "url": "https://mcp.arif-fazil.com/mcp" } } }
```

STDIO: `npx -y arifos-mcp`

### Discovery
- **MCP Server Card:** `.well-known/mcp/server.json`
- **Agent Card:** `https://aaa.arif-fazil.com/.well-known/agent-card.json`
- **MCP Manifest:** `https://arifos.arif-fazil.com/.well-known/mcp.json`

### 📚 Documentation Index
| Resource | Path |
|----------|------|
| **GENESIS Canon** | [`GENESIS/README.md`](GENESIS/README.md) — 37 constitutional documents, ATLAS333-mapped |
| **Governance** | [`docs/governance/README.md`](docs/governance/README.md) — Ontology, manifesto, floors |
| **Architecture (ADR)** | [`docs/adr/README.md`](docs/adr/README.md) — Architecture Decision Records |
| **ATLAS333** | [`docs/ATLAS333_INTELLIGENCE_FLOW.md`](docs/ATLAS333_INTELLIGENCE_FLOW.md) — Cognitive geometry |
| **Agent Surface** | [`AGENTS.md`](AGENTS.md) — Boot sequence, floors, autonomy |
| **Changelog** | [`CHANGELOG.md`](CHANGELOG.md) — Release history |
| **Runbook** | [`RUNBOOK.md`](RUNBOOK.md) — Ops commands |
| **Invariants** | [`INVARIANTS.md`](INVARIANTS.md) — What must never change |

### Federation Context
| Read this | For | Link |
|-----------|-----|------|
| **arifOS** (this repo) | Constitutional kernel. 8 verbs. 13 floors. The judge. | ← you are here |
| **A-FORGE** | Executor. 111 MCP tools. Governed gates. | [ariffazil/A-FORGE](https://github.com/ariffazil/A-FORGE) |
| **AAA** | Cockpit. A2A mesh. Agent registry. | [ariffazil/AAA](https://github.com/ariffazil/AAA) |
| **GEOX** | Earth intelligence — wells, seismic, petrophysics | [ariffazil/GEOX](https://github.com/ariffazil/GEOX) |
| **WEALTH** | Capital intelligence — NPV, IRR, EMV | [ariffazil/WEALTH](https://github.com/ariffazil/WEALTH) |
| **WELL** | Vitality guard — REFLECT_ONLY | [ariffazil/WELL](https://github.com/ariffazil/WELL) |
| **HERMES** | Multi-modal bridge + Telegram relay | [ariffazil/HERMES](https://github.com/ariffazil/HERMES) |

---


## 🔗 Federation

| Organ | Role | Repo | MCP | Health | LLMs |
|-------|------|------|-----|--------|------|
| **arifOS** | Kernel — judges, seals | [repo](https://github.com/ariffazil/arifos) | [mcp](https://mcp.arif-fazil.com/mcp) | [health](https://arifos.arif-fazil.com/health) | [llms.txt](https://arifos.arif-fazil.com/llms.txt) |
| **A-FORGE** | Executor — builds, deploys | [repo](https://github.com/ariffazil/A-FORGE) | [mcp](https://forge.arif-fazil.com/mcp) | [health](https://forge.arif-fazil.com/health) | [llms.txt](https://forge.arif-fazil.com/llms.txt) |
| **AAA** | Cockpit — displays, routes | [repo](https://github.com/ariffazil/AAA) | — | [health](https://aaa.arif-fazil.com/health) | [llms.txt](https://aaa.arif-fazil.com/llms.txt) |
| **GEOX** | Earth intelligence | [repo](https://github.com/ariffazil/GEOX) | [mcp](https://geox.arif-fazil.com/mcp) | [health](https://geox.arif-fazil.com/health) | [llms.txt](https://geox.arif-fazil.com/llms.txt) |
| **WEALTH** | Capital intelligence | [repo](https://github.com/ariffazil/wealth) | [mcp](https://wealth.arif-fazil.com/mcp) | [health](https://wealth.arif-fazil.com/health) | [llms.txt](https://wealth.arif-fazil.com/llms.txt) |
| **WELL** | Vitality guard | [repo](https://github.com/ariffazil/well) | [mcp](https://well.arif-fazil.com/mcp) | [health](https://well.arif-fazil.com/health) | [llms.txt](https://well.arif-fazil.com/llms.txt) |
| **HERMES** | Multi-modal bridge | [repo](https://github.com/ariffazil/HERMES) | — | — | — |

**Public:** [arif-fazil.com](https://arif-fazil.com) · **Federation root:** [arifos.arif-fazil.com](https://arifos.arif-fazil.com)
**SOT:** 2026-07-24

## 8. License & Sovereignty

**AGPL-3.0.** The constitution must remain open. The kernel must remain inspectable.

**Muhammad Arif bin Fazil** is F13 SOVEREIGN. His veto is absolute. No algorithm overrides. No agent bypasses. No institution supersedes.

```
arifOS · Port 8088 · 8 canonical tools · 13 floors · 6 live organs
AGPL-3.0 · Sovereign: Arif Fazil · Federation: ALIVE
MCP · ChatGPT ✓ · Claude Desktop ✓ · PyPI
DITEMPA BUKAN DIBERI — 999 SEAL ALIVE
```
# force unique hash 1784320830
