arifOS — Constitutional AI Governance System

The Seatbelt for the AI Revolution
13 Constitutional Floors • 5-Organ Trinity • Thermodynamic Safety

🎯 What is arifOS?

arifOS is the world's first production-grade Constitutional AI Governance System. It enforces ethical, logical, and safety constraints on AI outputs through 13 constitutional floors (F1-F13) grounded in physics and thermodynamics—not human preferences.

Unlike traditional safety frameworks that rely on prompt-based guardrails, arifOS treats AI governance as thermodynamic work: intelligence forged through rigorous constraint.

The Core Innovation

🏛️ The 13 Constitutional Floors

Every query flows through 13 enforceable constraints:

HARD Floors: Failure → VOID (blocked)
SOFT Floors: Failure → SABAR (repair) or PARTIAL (constrained)

🔄 The 5-Organ Trinity Pipeline

The complete constitutional journey flows through 5 organs:

🔥 000_INIT → 111_AGI → 555_ASI → 888_APEX → 💎🧠🔒 999_VAULT
 (Gate)      (Mind)    (Heart)   (Soul)    (Memory)

The 9 Constitutional Mottos (Nusantara)

Each stage has a Malay motto reflecting active construction:

🚀 Quick Start

Installation

pip install arifos

Basic Usage

import asyncio
from aaa_mcp import trinity_forge

async def main():
    # Run full constitutional pipeline
    result = await trinity_forge(
        query="Is this medical advice safe to provide?",
        mode="conscience",  # "conscience" (enforce) or "ghost" (log only)
        require_sovereign_for_high_stakes=True
    )
    
    print(f"Verdict: {result['verdict']}")  # SEAL, VOID, SABAR, PARTIAL, 888_HOLD
    print(f"Tri-Witness: {result['apex']['tri_witness']}")
    print(f"Genius Score: {result['apex']['genius_score']}")
    
    if result['verdict'] == '888_HOLD':
        print("⚠️ Human review required!")

asyncio.run(main())

Using the MCP Server

# stdio mode (for Claude Desktop)
python -m aaa_mcp

# SSE mode (for remote deployment)
python -m aaa_mcp sse

# HTTP mode (MCP 2025-11-25 spec)
python -m aaa_mcp http

Health Check

curl https://aaamcp.arif-fazil.com/health

Response:

{
  "status": "healthy",
  "postgres_connected": true,
  "redis_connected": true,
  "verdict_rates": {"SEAL": 0.85, "VOID": 0.10, "SABAR": 0.05},
  "motto": "🔥 DITEMPA BUKAN DIBERI 💎🧠🔒"
}

🛠️ Architecture

High-Level Flow

User Query
    ↓
000_INIT (Authentication, Injection Scan)
    ↓
111_AGI_SENSE (Intent Classification)
    ↓
222_AGI_THINK (Hypothesis Generation)
    ↓
333_AGI_REASON (Logical Analysis)
    ↓
555_ASI_EMPATHIZE (Stakeholder Impact)
    ↓
666_ASI_ALIGN (Ethics/Policy Check)
    ↓
888_APEX_VERDICT (Final Judgment)
    ↓
999_VAULT_SEAL (Immutable Record)
    ↓
User Response + Verdict

MCP Trinity Architecture

arifOS is organized as three MCP servers serving different domains:

Remember: Above (Cloud) → Below (Local) → Connect (Human)

See docs/MCP_TRINITY_SUMMARY.md for details.

Infrastructure

📋 The 14 Canonical Tools

Machine-Discoverable: Access aaa://capabilities/ for full tool specifications.

🎙️ Vibe Infrastructure — AI as the UI

arifOS enables intent-based infrastructure management: human describes intent, AI handles complexity, constitution guards actions.

Traditional vs Vibe Infrastructure

Example Conversation

Human: Deploy payment service to production

AI: 🚨 CONSTITUTIONAL CHECK TRIGGERED
   
   Action: Deploy to production namespace
   Risk Level: HIGH | Blast Radius: 15 pods
   
   Floors Checked:
   ✅ F1 Amanah: Backup exists
   ⚠️  F6 Empathy: Production impact (κᵣ = 0.85)
   ⏳ F13 Sovereign: Awaiting your approval
   
   Approve? [Yes] [No] [Show details]

Human: Yes

AI: ✅ SEAL granted. Deploying with canary strategy...
   Health checks passed. Deployment complete.

No buttons. No menus. Just conversation and constitution.

See docs/VIBE_INFRASTRUCTURE.md for full specification.

🧪 Development

Running Tests

# Quick smoke test (~3 min)
pytest tests/test_startup.py -v

# E2E tests (10 tests)
pytest tests/test_e2e_core_to_aaa_mcp.py -v

# Constitutional floor tests
pytest tests/constitutional/ -v

# With coverage
pytest --cov=aaa_mcp --cov=core tests/ -v

Environment Variables

Docker

docker build -t arifos .
docker run -p 8080:8080 -e PORT=8080 arifos

🗺️ Roadmap: The Four Horizons

🔥 H1: Foundation Tempering (v60.1-v60.9)

Status: Infrastructure forged, tempering in progress

• ✅ PostgreSQL VAULT999 ledger
• ✅ Redis session cache
• ✅ 13 floors enforced
• ✅ MCP Gateway (Docker/K8s constitutional governance)
• ✅ Identity model + policy-as-code
• ✅ Post-deploy observability (F4 Clarity)
• 🔄 SBERT classifier for F5/F6/F9
• 🔄 Test suite recovery (80%+ pass)

🟠 H2: Human-AI Interface SDK (v61.0-v61.9)

Theme: Vibe Infrastructure — AI as the UI

• 🔄 Python SDK (arifos-sdk) with HITL patterns
• 🔄 888_HOLD approval UI (React components)
• 🔄 Slack/Email/PagerDuty integrations
• 4 H2 Agents using SDK (Architect, Engineer, Auditor, Validator)
• Juror democracy with human veto
• LangGraph/Agents SDK integration

🟡 H3: Platform Everywhere (v62.0-v62.9)

Theme: Industry constitutions + multi-modal

• Medical, Financial, Legal constitutions
• Vision + text governance
• Real-time streaming
• WASM edge deployment

🔮 H4: Exploration (v63.0+)

Theme: The frontiers

• Cross-model federation (Byzantine Constitutional AI)
• Self-amending constitution
• Human-AI partnerships
• Interplanetary governance

Full roadmap: ROADMAP.md

📊 Key Metrics

🏛️ Philosophy

The Thermodynamic Basis

arifOS grounds AI safety in physical law, not human opinion:

• F1 Amanah: Landauer's Principle — irreversible operations cost energy
• F2 Truth: Shannon Entropy — information reduces uncertainty
• F4 Clarity: 2nd Law of Thermodynamics — entropy must not increase
• F7 Humility: Gödel's Incompleteness — all claims need uncertainty bounds
• F8 Genius: Eigendecomposition — intelligence = A×P×X×E²

4. Constitutional MCP Gateway (H1.4 FORGED)

The Control Plane for Docker & Kubernetes.

"Ditempa Bukan Diberi": The Gateway is not a firewall; it is a Constitutional Airlock. It does not block; it judges.

The Cultural Foundation

The 9 mottos are in Nusantara Malay-Indonesian, reflecting:

• Active construction (DI___KAN, not passive)
• Southeast Asian wisdom traditions
• Anti-colonial knowledge sovereignty

"Intelligence requires work — DITEMPA BUKAN DIBERI"

🤝 Contributing

We welcome contributions that respect the constitutional principles:

1. All code must pass F9 (Anti-Hantu): No consciousness claims
2. All changes must pass F1 (Amanah): Must be reversible or auditable
3. All tests must pass F2 (Truth): Accuracy ≥ 0.99

See CONTRIBUTING.md for guidelines.

📜 License

AGPL-3.0-only

arifOS is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, version 3.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Commons Clause: Production use by organizations with >$1M revenue requires a commercial license. Contact: arif@arif-fazil.com

🙏 Acknowledgments

• Thermodynamic Foundations: Rolf Landauer, Claude Shannon, Ludwig Boltzmann
• Constitutional Theory: Jon Elster, Cass Sunstein, Bruce Ackerman
• Malay Wisdom: Hamka, Tan Malaka, Pramoedya Ananta Toer
• AI Safety: Stuart Russell, Nick Bostrom, Paul Christiano

🔗 Resources

💎 Creed

DITEMPA BUKAN DIBERI
Forged, Not Given — 🔥💎🧠🔒

The fire is lit at the 🔥 INIT gate.
The diamond is cut at the 💎🧠 SEAL gate.
The horizons await.

Constitutional Kernel v60.1-FORGE
Last Tempered: 2026-02-11
MCP Registry: io.github.ariffazil/aaa-mcp