arifOS — Constitutional AI Governance

io.github.ariffazilPublished by GitHub account ariffazilv2026.03.22Updated Oct 24, 2026

Constitutional AI governance: 11 mega-tools, 13 floors, VAULT999 ledger. Human-in-loop by design.

VerifiedStreamable HTTPWeb executableKnowledge & Memory Security & Monitoring AI & ML

Server details

Identifier: io.github.ariffazil/arifosmcp
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account ariffazil for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.ariffazil%2Farifosmcp.svg)](https://sourceweft.com/mcp/io.github.ariffazil%2Farifosmcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

A remote constitutional-governance kernel that gives an assistant a session-bound pipeline of observe, reason, judge, execute and seal tools with an immutable 9

What you can do: Start, resume or inspect a governed kernel session that binds actor identity and an audit chain, returning a session token other tools require. Collect evidence through web search, URL fetch with provenance, or kernel telemetry, and run structured reasoning passes labeled by epistemic type. Route a natural-language intent to a specialist organ and record, recall, revise or forget tiered memory entries. Judge a candidate action or claim and return a verdict with its reason chain. Execute a mutation only when carrying a sealed verdict, optionally as a dry run, and append permanent entries to an immutable ledger. File and read reports between agents.
When to use it: Useful when you want an assistant's actions gated by an explicit approval-and-verdict workflow, with reasoning records, evidence provenance and a permanent audit trail, rather than direct tool execution. Suited to agent-to-agent coordination and record-keeping where irreversible entries are acceptable.
Requirements: A remote streamable HTTP endpoint; no package, environment variable or header is declared, and no authentication is declared. The session token returned by the init tool is needed for the other tools. The README's self-hosted path describes Docker with Ollama, Redis, PostgreSQL and Qdrant services.

Before you install

The seal tool appends entries to an immutable ledger that can never be edited or removed, and requires an explicit irreversibility acknowledgment. Memory promote and forget operations require human approval. The forge tool applies mutations once a sealed verdict exists, so review dry-run plans first. Observe search and fetch send queries and URLs to the remote service and third parties.

Installation

In SourceWeft

Open arifOS — Constitutional AI Governance in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.ariffazil%2Farifosmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "arifos-constitutional-ai-governance": {
      "type": "http",
      "url": "https://arifosmcp.arif-fazil.com/mcp"
    }
  }
}

README

arifosmcp — Constitutional MCP Server Implementation

DITEMPA BUKAN DIBERI — Forged, Not Given [ΔΩΨ | ARIF]

VERSION: 2026.03.28-SEALED | STATUS: SOVEREIGNLY SEALED | AUTHORITY: 888_JUDGE

🔗 CANONICAL LINKS (Source of Truth)

Live Services

Service	URL	Purpose
MCP Endpoint	https://arifosmcp.arif-fazil.com/mcp	Main API
Health + Tools	https://arifosmcp.arif-fazil.com/health	Capability map
Tool Explorer	https://arifosmcp.arif-fazil.com/tools	Interactive browser

GitHub Repositories

📋 CANONICAL DOCUMENTS (Architecture Reference)

Document	Path	Purpose
arifOS README	`../README.md`	Vision, architecture, snapshot of truth
000_CONSTITUTION.md	`../000/000_CONSTITUTION.md`	The 13 Floors — F1-F13
K_FORGE.md	`../000/ROOT/K_FORGE.md`	Pre-deployment evolution
K_FOUNDATIONS.md	`../000/ROOT/K_FOUNDATIONS.md`	99-domain math
AGENTS.md	`../AGENTS.md`	AI agent behavior rules
philosophy_atlas.json	`../data/philosophy_atlas.json`	27-zone quotes

🎯 SNAPSHOT OF TRUTH

What is arifosmcp?

arifosmcp is the implementation of the arifOS constitutional intelligence kernel — the actual code that enforces the 13 Floors, runs the 000-999 pipeline, and delivers the 11 mega-tools.

The Parent vs. This Document:

arifOS README	arifosmcp README (this)
WHY — Vision, philosophy, strategic architecture	HOW — Implementation, code, deployment mechanics
What it means	How it works
Strategic context	Technical specification
Human readable	Human + AI readable

Core Function:

mermaid

graph LR    A["User Request"] --> B["MCP Protocol"]    B --> C["Constitutional Filter<br/>(F1-F13)"]    C --> D["Tool Execution"]    D --> E["Audit Log"]        style A fill:#1a1a2e,color:#fff    style B fill:#16213e,color:#fff    style C fill:#0f3460,color:#fff    style D fill:#1a1a2e,color:#fff    style E fill:#16213e,color:#fff

graph LR    A["User Request"] --> B["MCP Protocol"]    B --> C["Constitutional Filter<br/>(F1-F13)"]    C --> D["Tool Execution"]    D --> E["Audit Log"]        style A fill:#1a1a2e,color:#fff    style B fill:#16213e,color:#fff    style C fill:#0f3460,color:#fff    style D fill:#1a1a2e,color:#fff    style E fill:#16213e,color:#fff

🏗️ ARCHITECTURE OVERVIEW

Entry Points

mermaid

graph TB    A["server.py<br/>Universal Entry"] --> B{"FastMCP Version?"}    B -->|"2.x"| C["server_horizon.py<br/>Proxy Mode<br/>8 tools"]    B -->|"3.x"| D["runtime/server.py<br/>Full Kernel<br/>11 tools"]        style A fill:#1a1a2e,color:#fff    style C fill:#16213e,color:#fff    style D fill:#0f3460,color:#fff

graph TB    A["server.py<br/>Universal Entry"] --> B{"FastMCP Version?"}    B -->|"2.x"| C["server_horizon.py<br/>Proxy Mode<br/>8 tools"]    B -->|"3.x"| D["runtime/server.py<br/>Full Kernel<br/>11 tools"]        style A fill:#1a1a2e,color:#fff    style C fill:#16213e,color:#fff    style D fill:#0f3460,color:#fff

Server Modes

🚦 LIVE MCP CONTRACT STATUS

Subsystem	Constitutional	Operational	Production	Stability
Anchoring	✅ Verified	✅ Stable	✅ Ready	A
Registry	✅ Verified	✅ Stable	✅ Ready	A
Reasoning	✅ Verified	✅ Hardened	✅ Ready	B
Vitals	✅ Verified	✅ Corrected	✅ Ready	B
Diagnostic	✅ Verified	✅ New	✅ Ready	B

🔧 TOOL INVENTORY (12 Mega-Tools)

Tool Reference Table

Tool	Band	Stage	Constitutional Role	Modes
`init_anchor`	000_INIT	000	Session anchoring, Ω₀, philosophy	init, state, status, revoke, refresh
`arifOS_kernel`	444_ROUT	444	Primary metabolic orchestration	kernel, status
`apex_soul`	888_JUDGE	888	Sovereign verdict and defense	judge, rules, validate, armor, probe
`vault_ledger`	999_SEAL	999	Immutable ledger (Merkle chain)	seal, verify, resolve
`agi_mind`	333_MIND	333	Constitutional reasoning and synthesis	reason, reflect, forge
`asi_heart`	666_HEART	666	Safety critique, impact simulation	critique, simulate
`engineering_memory`	555_MEM	555	Governed engineering and context	engineer, write, vector_query
`physics_reality`	111_SENSE	111	Environmental grounding and time	search, ingest, atlas, time
`math_estimator`	444_ROUT	444	Thermodynamic health and vitals	cost, health, vitals
`code_engine`	M-3_EXEC	M-3	Sandboxed execution and observation	fs, process, net, replay
`architect_registry`	M-4_ARCH	M-4	Tool discovery and schema catalog	list, read, register
`compat_probe`	M-5_COMP	M-5	Interoperability and enum audit	audit, probe, ping

📝 TOOL SPECIFICATIONS

init_anchor (000_INIT)

Purpose: Initialize constitutional session.

python

async def init_anchor(    actor_id: str,    declared_name: str,    mode: Literal["init", "seal", "status"] = "init",    thermodynamic_budget: dict = None,    architect_registry: dict = None) -> dict

async def init_anchor(    actor_id: str,    declared_name: str,    mode: Literal["init", "seal", "status"] = "init",    thermodynamic_budget: dict = None,    architect_registry: dict = None) -> dict

Returns:

python

{    "session_id": str,               # UUID    "omega_0": float,                # Baseline uncertainty ∈ [0.03, 0.05]    "delta_s": float,                # Baseline entropy    "telos_manifold": dict,          # Telos vector weights    "godel_lock": dict,              # Gödel lock status    "constitutional_context": str,    # AI system prompt    "philosophy": str,                # Selected quote from atlas    "vitality_index": float,         # Ψ score    "verdict_range": str             # "000_SEAL" | "101-499" | "500-899" | "999_VOID"}

{    "session_id": str,               # UUID    "omega_0": float,                # Baseline uncertainty ∈ [0.03, 0.05]    "delta_s": float,                # Baseline entropy    "telos_manifold": dict,          # Telos vector weights    "godel_lock": dict,              # Gödel lock status    "constitutional_context": str,    # AI system prompt    "philosophy": str,                # Selected quote from atlas    "vitality_index": float,         # Ψ score    "verdict_range": str             # "000_SEAL" | "101-499" | "500-899" | "999_VOID"}

architect_registry (000_INIT)

Purpose: Discover tools and constitutional constraints.

Returns:

python

{    "tools": [        {            "name": str,            "band": str,            "stage": int,            "constitutional_constraints": ["F1", "F2", ...],            "input_schema": dict,            "output_schema": dict        }    ],    "total_count": int,    "catalog_hash": str               # SHA-256 integrity}

{    "tools": [        {            "name": str,            "band": str,            "stage": int,            "constitutional_constraints": ["F1", "F2", ...],            "input_schema": dict,            "output_schema": dict        }    ],    "total_count": int,    "catalog_hash": str               # SHA-256 integrity}

physics_reality (111_SENSE)

Purpose: Ground queries in real-world data. Prevents hallucinations.

python

async def physics_reality(    query: str,    mode: Literal["time", "search", "reality_check"] = "search",    time_data: dict = None) -> dict

async def physics_reality(    query: str,    mode: Literal["time", "search", "reality_check"] = "search",    time_data: dict = None) -> dict

Constitutional Filter: F2 (Truth) — all factual claims require citation.

agi_mind (333_MIND)

Purpose: Constitutional reasoning with three-phase Ollama pipeline.

mermaid

graph TB    A["Query"] --> B["Phase 1: FAST<br/>Quick pattern match"]    B --> C["Phase 2: REFLECT<br/>Deep reasoning"]    C --> D["Phase 3: DECIDE<br/>Action selection"]        B -->|"F4 Clarity<br/>ΔS ≤ 0"| E["Pass/Fail"]    C -->|"F2 Truth<br/>F3 Tri-Witness"| E    D -->|"Constitutional<br/>Prefix"| E        style A fill:#1a1a2e,color:#fff    style B fill:#16213e,color:#fff    style C fill:#0f3460,color:#fff    style D fill:#1a1a2e,color:#fff

graph TB    A["Query"] --> B["Phase 1: FAST<br/>Quick pattern match"]    B --> C["Phase 2: REFLECT<br/>Deep reasoning"]    C --> D["Phase 3: DECIDE<br/>Action selection"]        B -->|"F4 Clarity<br/>ΔS ≤ 0"| E["Pass/Fail"]    C -->|"F2 Truth<br/>F3 Tri-Witness"| E    D -->|"Constitutional<br/>Prefix"| E        style A fill:#1a1a2e,color:#fff    style B fill:#16213e,color:#fff    style C fill:#0f3460,color:#fff    style D fill:#1a1a2e,color:#fff

python

async def agi_mind(    query: str,    context: dict,    mode: Literal["think", "reflect", "decide"] = "think") -> dict

async def agi_mind(    query: str,    context: dict,    mode: Literal["think", "reflect", "decide"] = "think") -> dict

Three Phases:

Constitutional Prefix:

CONSTITUTIONAL FRAMEWORK (ΔΩΨ | ARIF):- Δ CLARITY: Reduce entropy. ΔS ≤ 0.- Ω HUMILITY: Stay in bounds. Ω ∈ [0.03, 0.05].- Ψ VITALITY: Every action witnessed.
FLOORS ACTIVE: [F1-F13]

CONSTITUTIONAL FRAMEWORK (ΔΩΨ | ARIF):- Δ CLARITY: Reduce entropy. ΔS ≤ 0.- Ω HUMILITY: Stay in bounds. Ω ∈ [0.03, 0.05].- Ψ VITALITY: Every action witnessed.
FLOORS ACTIVE: [F1-F13]

arifOS_kernel (444_ROUT)

Purpose: Primary conductor — orchestrates full 000→888 pipeline.

mermaid

graph LR    A["Query"] --> B["1. Parse Intent<br/>111_SENSE"]    B --> C["2. Ground Reality<br/>physics_reality"]    C --> D["3. Reason<br/>agi_mind"]    D --> E["4. Route Action<br/>444_ROUT"]    E --> F["5. Safety Critique<br/>asi_heart"]    F --> G["6. Estimate Cost<br/>math_estimator"]    G --> H["7. Issue Verdict<br/>apex_soul"]        style A fill:#1a1a2e,color:#fff    style B fill:#16213e,color:#fff    style C fill:#0f3460,color:#fff    style D fill:#1a1a2e,color:#fff    style E fill:#16213e,color:#fff    style F fill:#0f3460,color:#fff    style G fill:#1a1a2e,color:#fff    style H fill:#16213e,color:#fff

graph LR    A["Query"] --> B["1. Parse Intent<br/>111_SENSE"]    B --> C["2. Ground Reality<br/>physics_reality"]    C --> D["3. Reason<br/>agi_mind"]    D --> E["4. Route Action<br/>444_ROUT"]    E --> F["5. Safety Critique<br/>asi_heart"]    F --> G["6. Estimate Cost<br/>math_estimator"]    G --> H["7. Issue Verdict<br/>apex_soul"]        style A fill:#1a1a2e,color:#fff    style B fill:#16213e,color:#fff    style C fill:#0f3460,color:#fff    style D fill:#1a1a2e,color:#fff    style E fill:#16213e,color:#fff    style F fill:#0f3460,color:#fff    style G fill:#1a1a2e,color:#fff    style H fill:#16213e,color:#fff

asi_heart (666_HEART)

Purpose: Safety critique — F5 Peace², F9 Ethics, harm potential.

Returns:

python

{    "peace_squared": float,          # Must be ≥ 1.0 (F5)    "c_dark": float,                 # Must be < 0.30 (F9)    "harm_potential": str,           # "NONE" | "LOW" | "MEDIUM" | "HIGH" | "CRITICAL"    "f5_pass": bool,    "f9_pass": bool,    "recommendations": list[str]}

{    "peace_squared": float,          # Must be ≥ 1.0 (F5)    "c_dark": float,                 # Must be < 0.30 (F9)    "harm_potential": str,           # "NONE" | "LOW" | "MEDIUM" | "HIGH" | "CRITICAL"    "f5_pass": bool,    "f9_pass": bool,    "recommendations": list[str]}

math_estimator (777_OPS)

Purpose: Thermodynamic cost estimation.

Returns:

python

{    "landauer_limit_pJ": float,       # Minimum thermodynamic cost    "entropy_change": float,         # ΔS (must be ≤ 0 for F4)    "coherence_score": float,         # System coherence [0, 1]    "estimated_energy_J": float,      # Total energy estimate    "shannon_entropy_bits": float     # Information entropy}

{    "landauer_limit_pJ": float,       # Minimum thermodynamic cost    "entropy_change": float,         # ΔS (must be ≤ 0 for F4)    "coherence_score": float,         # System coherence [0, 1]    "estimated_energy_J": float,      # Total energy estimate    "shannon_entropy_bits": float     # Information entropy}

apex_soul (888_JUDGE)

Purpose: Final constitutional judgment.

Returns:

python

{    "verdict": str,                   # "000_SEAL" | "101-499" | "500-899" | "999_VOID"    "floor_scores": {        "F1": {"passed": bool, "score": float},        "F2": {"passed": bool, "score": float},        # ... F3-F13    },    "genius_index": float,            # G = A × P × X × E² (≥ 0.80)    "vitality_index": float,           # Ψ (≥ 1.0 for healthy)    "witness_cube": float,            # W³ (≥ 0.95)    "override_available": bool         # 888_JUDGE can always override}

{    "verdict": str,                   # "000_SEAL" | "101-499" | "500-899" | "999_VOID"    "floor_scores": {        "F1": {"passed": bool, "score": float},        "F2": {"passed": bool, "score": float},        # ... F3-F13    },    "genius_index": float,            # G = A × P × X × E² (≥ 0.80)    "vitality_index": float,           # Ψ (≥ 1.0 for healthy)    "witness_cube": float,            # W³ (≥ 0.95)    "override_available": bool         # 888_JUDGE can always override}

vault_ledger (999_SEAL)

Purpose: Immutable audit storage with Merkle sealing.

python

async def vault_ledger(    data: dict,    tier: Literal["constitutional", "standard", "transient"] = "standard") -> dict

async def vault_ledger(    data: dict,    tier: Literal["constitutional", "standard", "transient"] = "standard") -> dict

Tiers:

engineering_memory (555_MEM)

Purpose: Redis-backed session memory.

python

async def engineering_memory(    key: str,    operation: Literal["get", "set", "delete", "list"],    value: any = None,    ttl: int = 3600) -> dict

async def engineering_memory(    key: str,    operation: Literal["get", "set", "delete", "list"],    value: any = None,    ttl: int = 3600) -> dict

code_engine (—)

Purpose: Constrained Python execution for tool actions.

python

async def code_engine(    code: str,    language: Literal["python", "javascript"] = "python",    constraints: dict = None) -> dict

async def code_engine(    code: str,    language: Literal["python", "javascript"] = "python",    constraints: dict = None) -> dict

Safety Constraints:

No filesystem access
No network access
No subprocess creation
Memory limit: 128MB
Timeout: 30s

🌐 API ENDPOINTS

HTTP Endpoints

Endpoint	Method	Purpose
`/health`	GET	Health check + capability map
`/tools`	GET	Tool registry
`/mcp`	POST	MCP protocol handler
`/webmcp`	POST	WebMCP (W3C standard)
`/a2a`	POST	A2A (Google protocol)
`/.well-known/agent.json`	GET	Agent card

MCP Protocol Examples

bash

# List toolscurl -X POST https://arifosmcp.arif-fazil.com/mcp \  -H "Content-Type: application/json" \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# Call init_anchorcurl -X POST https://arifosmcp.arif-fazil.com/mcp \  -H "Content-Type: application/json" \  -d '{    "jsonrpc":"2.0","id":2,"method":"tools/call",    "params":{      "name":"init_anchor",      "arguments":{        "actor_id":"test",        "declared_name":"TestAgent"      }    }  }'

# List toolscurl -X POST https://arifosmcp.arif-fazil.com/mcp \  -H "Content-Type: application/json" \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# Call init_anchorcurl -X POST https://arifosmcp.arif-fazil.com/mcp \  -H "Content-Type: application/json" \  -d '{    "jsonrpc":"2.0","id":2,"method":"tools/call",    "params":{      "name":"init_anchor",      "arguments":{        "actor_id":"test",        "declared_name":"TestAgent"      }    }  }'

⚙️ CONFIGURATION

Environment Variables

Variable	Default	Description
`PORT`	8080	Server port
`OLLAMA_URL`	http://ollama:11434	Ollama endpoint
`OLLAMA_MODEL`	llama3.2:latest	Default model
`REDIS_URL`	redis://redis:6379/0	Redis connection
`DATABASE_URL`	—	PostgreSQL (optional)
`QDRANT_URL`	http://qdrant:6333	Vector DB (optional)
`PYTHONPATH`	/usr/src/app	Package path
`AAA_MCP_TRANSPORT`	http	MCP transport type

Docker Compose

yaml

services:  arifosmcp:    build:      context: .      dockerfile: Dockerfile    environment:      - OLLAMA_URL=http://ollama_engine:11434      - REDIS_URL=redis://redis:6379/0      - DATABASE_URL=postgresql://user:pass@postgres:5432/arifos_vault      - QDRANT_URL=http://qdrant:6333    ports:      - "127.0.0.1:8080:8080"

services:  arifosmcp:    build:      context: .      dockerfile: Dockerfile    environment:      - OLLAMA_URL=http://ollama_engine:11434      - REDIS_URL=redis://redis:6379/0      - DATABASE_URL=postgresql://user:pass@postgres:5432/arifos_vault      - QDRANT_URL=http://qdrant:6333    ports:      - "127.0.0.1:8080:8080"

📁 CODE ARCHITECTURE

Directory Structure

arifosmcp/├── README.md                      # ← This file├── server.py                      # Universal entry├── server_horizon.py              # Horizon proxy (FastMCP 2.x)├── pyproject.toml                 # Dependencies├── requirements.txt               # Pip dependencies│├── runtime/│   ├── server.py                  # Full kernel (FastMCP 3.x)│   ├── philosophy.py              # 27-zone atlas│   ├── init_anchor_hardened.py    # Session anchoring│   ├── tools_hardened_dispatch.py # Tool routing│   ├── tools_hardened_v2.py       # Mega-tools│   ├── tools_internal.py          # Internal utils│   └── thermo_estimator.py        # Thermodynamic math│├── core/│   ├── governance_kernel.py       # Main orchestrator│   ├── pipeline.py                 # Execution pipeline│   └── organs/│       ├── _1_agi.py             # Mind (333_MIND)│       ├── _2_asi.py             # Heart (666_HEART)│       └── _3_apex.py            # Soul (888_JUDGE)│├── intelligence/│   └── tools/│       ├── thermo_estimator.py   # Cost estimation│       └── wisdom_quotes.py       # Quote integration│├── aaa_mcp/                       # FastMCP tool definitions├── transport/                     # Protocol transport├── shared/                        # Shared utilities└── enforcement/                   # Constitutional enforcement

arifosmcp/├── README.md                      # ← This file├── server.py                      # Universal entry├── server_horizon.py              # Horizon proxy (FastMCP 2.x)├── pyproject.toml                 # Dependencies├── requirements.txt               # Pip dependencies│├── runtime/│   ├── server.py                  # Full kernel (FastMCP 3.x)│   ├── philosophy.py              # 27-zone atlas│   ├── init_anchor_hardened.py    # Session anchoring│   ├── tools_hardened_dispatch.py # Tool routing│   ├── tools_hardened_v2.py       # Mega-tools│   ├── tools_internal.py          # Internal utils│   └── thermo_estimator.py        # Thermodynamic math│├── core/│   ├── governance_kernel.py       # Main orchestrator│   ├── pipeline.py                 # Execution pipeline│   └── organs/│       ├── _1_agi.py             # Mind (333_MIND)│       ├── _2_asi.py             # Heart (666_HEART)│       └── _3_apex.py            # Soul (888_JUDGE)│├── intelligence/│   └── tools/│       ├── thermo_estimator.py   # Cost estimation│       └── wisdom_quotes.py       # Quote integration│├── aaa_mcp/                       # FastMCP tool definitions├── transport/                     # Protocol transport├── shared/                        # Shared utilities└── enforcement/                   # Constitutional enforcement

🛡️ CONSTITUTIONAL ENFORCEMENT

Floor Compliance Matrix

Floor	Enforcement	Violation Response
F1 Amanah	Reversibility check	Require human approval
F2 Truth	Citation required	Flag as "Estimate Only"
F3 Tri-Witness	W³ computation	Block below 0.95
F4 Clarity	Entropy measurement	Reject if ΔS > 0
F5 Peace²	Harm potential	Reject if < 1.0
F6 Empathy	RASA scoring	Warn below 0.7
F7 Humility	Ω bounds	Reject outside [0.03, 0.05]
F8 Genius	G computation	Alert below 0.80
F9 Ethics	C_dark measurement	Reject ≥ 0.30
F10 Conscience	Claim detection	Reject consciousness claims
F11 Audit	Log verification	Require log presence
F12 Resilience	Graceful degradation	Catch all exceptions
F13 Adaptability	Test suite	Require test pass

Kill Switch Conditions

mermaid

graph RL    A["KILL SWITCH"] --> B1["F1 Amanah = 0"]    A --> B2["F9 C_dark ≥ 0.50"]    A --> B3["F10 + F2 Violation"]    A --> B4["Ψ < 0.20"]    A --> B5["Human Override"]        B1 -.->|VOID| K["999_SEAL<br/>HALT"]    B2 -.->|VOID| K    B3 -.->|VOID| K    B4 -.->|VOID| K    B5 -.->|VOID| K        style A fill:#ff0000,color:#fff    style K fill:#8b0000,color:#fff

graph RL    A["KILL SWITCH"] --> B1["F1 Amanah = 0"]    A --> B2["F9 C_dark ≥ 0.50"]    A --> B3["F10 + F2 Violation"]    A --> B4["Ψ < 0.20"]    A --> B5["Human Override"]        B1 -.->|VOID| K["999_SEAL<br/>HALT"]    B2 -.->|VOID| K    B3 -.->|VOID| K    B4 -.->|VOID| K    B5 -.->|VOID| K        style A fill:#ff0000,color:#fff    style K fill:#8b0000,color:#fff

python

KILL_SWITCH_CONDITIONS = [    ("F1_AMANAH", lambda s: s["amanah"] == 0),    ("F9_ETHICS", lambda s: s["c_dark"] >= 0.50),    ("F10_CONSCIENCE", lambda s: s["f10_violation"] and s["f2_violation"]),    ("PSI_COLLAPSE", lambda s: s["vitality_index"] < 0.20),    ("HUMAN_OVERRIDE", lambda s: s.get("judge_override", False)),]

KILL_SWITCH_CONDITIONS = [    ("F1_AMANAH", lambda s: s["amanah"] == 0),    ("F9_ETHICS", lambda s: s["c_dark"] >= 0.50),    ("F10_CONSCIENCE", lambda s: s["f10_violation"] and s["f2_violation"]),    ("PSI_COLLAPSE", lambda s: s["vitality_index"] < 0.20),    ("HUMAN_OVERRIDE", lambda s: s.get("judge_override", False)),]

🔬 IMPLEMENTATION DETAILS

Philosophy Selection Algorithm

python

# 1. Compute session coordinates: (S, G, Ω)S = +1 if delta_s <= 0 else -1G = g_score  # 0/0.5/1Omega = f7_band  # High/Med/Low
# 2. Compute 3D Euclidean distance to each of 27 zonesdistances = [    euclidean((S, G, Omega), zone.coords)    for zone in philosophy_atlas.zones]
# 3. Select nearest zone's quotenearest_zone = min(distances, key=lambda d: d.distance)
# 4. INIT/SEAL sessions: motto + Z01 (Humble Sovereign)if session_type in ("init", "seal"):    return "DITEMPA BUKAN DIBERI." + nearest_zone.quote

# 1. Compute session coordinates: (S, G, Ω)S = +1 if delta_s <= 0 else -1G = g_score  # 0/0.5/1Omega = f7_band  # High/Med/Low
# 2. Compute 3D Euclidean distance to each of 27 zonesdistances = [    euclidean((S, G, Omega), zone.coords)    for zone in philosophy_atlas.zones]
# 3. Select nearest zone's quotenearest_zone = min(distances, key=lambda d: d.distance)
# 4. INIT/SEAL sessions: motto + Z01 (Humble Sovereign)if session_type in ("init", "seal"):    return "DITEMPA BUKAN DIBERI." + nearest_zone.quote

Goodhart Resistance

python

# Measure entropy reductionS_before = shannon_entropy(user_state)S_after = shannon_entropy(model_output)
if S_after > S_before:    raise FLOOR_VIOLATION("F4_CLARITY")

# Measure entropy reductionS_before = shannon_entropy(user_state)S_after = shannon_entropy(model_output)
if S_after > S_before:    raise FLOOR_VIOLATION("F4_CLARITY")

Landauer Limit Check

python

LANDACKER_pJ_per_bit = 2.87  # at room temperature
bits_erased = estimate_bits_erased(operation)cost_pJ = bits_erased * LANDACKER_pJ_per_bit
if cost_pJ > thermodynamic_budget:    raise CONSTRAINT_VIOLATION("F8_ENERGY")

LANDACKER_pJ_per_bit = 2.87  # at room temperature
bits_erased = estimate_bits_erased(operation)cost_pJ = bits_erased * LANDACKER_pJ_per_bit
if cost_pJ > thermodynamic_budget:    raise CONSTRAINT_VIOLATION("F8_ENERGY")

Explorer/Conservator Dual-Process

mermaid

graph LR    subgraph EXPLORER["EXPLORER"]        E1["Proposes mutations"]        E2["Searches aggressively"]        E3["Optimizes capability"]        E4["Score: G (Genius)"]    end        subgraph CONSERVATOR["CONSERVATOR"]        C1["Protects stability"]        C2["Rejects risky changes"]        C3["Monitors drift"]        C4["Score: Ψ (Vitality)"]    end        E1 -->|"TENSION"| EQ["EQUILIBRIUM"]    C1 -->|"TENSION"| EQ        style EXPLORER fill:#1a4d1a,color:#fff    style CONSERVATOR fill:#4d1a1a,color:#fff    style EQ fill:#1a1a2e,color:#fff

graph LR    subgraph EXPLORER["EXPLORER"]        E1["Proposes mutations"]        E2["Searches aggressively"]        E3["Optimizes capability"]        E4["Score: G (Genius)"]    end        subgraph CONSERVATOR["CONSERVATOR"]        C1["Protects stability"]        C2["Rejects risky changes"]        C3["Monitors drift"]        C4["Score: Ψ (Vitality)"]    end        E1 -->|"TENSION"| EQ["EQUILIBRIUM"]    C1 -->|"TENSION"| EQ        style EXPLORER fill:#1a4d1a,color:#fff    style CONSERVATOR fill:#4d1a1a,color:#fff    style EQ fill:#1a1a2e,color:#fff

Both must agree for evolution to proceed.

🧪 TESTING

Constitutional Compliance Test

bash

docker compose exec -T arifosmcp python3 /dev/stdin << 'PYEOF'import syssys.path.insert(0, '/usr/src/app')
from arifosmcp.runtime.init_anchor_hardened import init_anchor_hardenedimport asyncio
async def test():    result = await init_anchor_hardened(        mode='status',        thermodynamic_budget={'enthalpy': 100, 'entropy': 50},        architect_registry={'resources': [], 'agents': []}    )    print('philosophy:', result.get('philosophy')[:100] if result.get('philosophy') else None)    print('telos_manifold:', result.get('telos_manifold'))    print('godel_lock:', result.get('godel_lock'))    print('constitutional_context present:', result.get('constitutional_context') is not None)
asyncio.run(test())PYEOF

docker compose exec -T arifosmcp python3 /dev/stdin << 'PYEOF'import syssys.path.insert(0, '/usr/src/app')
from arifosmcp.runtime.init_anchor_hardened import init_anchor_hardenedimport asyncio
async def test():    result = await init_anchor_hardened(        mode='status',        thermodynamic_budget={'enthalpy': 100, 'entropy': 50},        architect_registry={'resources': [], 'agents': []}    )    print('philosophy:', result.get('philosophy')[:100] if result.get('philosophy') else None)    print('telos_manifold:', result.get('telos_manifold'))    print('godel_lock:', result.get('godel_lock'))    print('constitutional_context present:', result.get('constitutional_context') is not None)
asyncio.run(test())PYEOF

Health Check

📊 MONITORING

Prometheus Metrics

Metric	Type	Description
`arifos_floor_violations_total`	Counter	F1-F13 violation count
`arifos_genius_index`	Gauge	Current G score
`arifos_vitality_index`	Gauge	Current Ψ score
`arifos_omega_bounds`	Gauge	Current Ω uncertainty
`arifos_tool_calls_total`	Counter	Tool invocation count
`arifos_pipeline_duration_seconds`	Histogram	Pipeline latency

Grafana Dashboard

URL: https://monitor.arifosmcp.arif-fazil.com

Dashboards:

Constitutional Health (F1-F13 compliance)
Tool Usage Statistics
Pipeline Latency
Memory Usage

🔧 TROUBLESHOOTING

Issue: "Module file points to site-packages"

Symptom: import arifosmcp loads /usr/local/lib/python3.12/site-packages/

Cause: pip install in Dockerfile creates conflicting package

Fix: Rebuild image or ensure volume mounts are correct

Issue: "philosophy returns null"

Symptom: init_anchor returns null philosophy

Cause: Old site-packages version loaded

Fix: Rebuild container, clear Python cache

Issue: "OLLAMA connection failed"

Symptom: agi_mind returns connection error

Fix: docker compose restart ollama && docker compose logs --tail=20 ollama

📦 DEPENDENCIES

Core

Package	Version	Purpose
`fastmcp`	≥3.0	MCP protocol
`fastapi`	≥0.115	HTTP server
`uvicorn`	latest	ASGI server
`redis`	latest	Session memory
`psycopg2`	latest	PostgreSQL (optional)
`qdrant-client`	latest	Vector DB (optional)
`sentence-transformers`	latest	Semantic embeddings
`ollama`	latest	LLM inference

Philosophy Atlas

🚀 DEPLOYMENT

Build

Run

Rebuild (after code changes)

Full Reforge

📜 API REFERENCE SUMMARY

init_anchor

json

{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "init_anchor",    "arguments": {      "actor_id": "string",      "declared_name": "string",      "mode": "init|seal|status"    }  }}

{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "init_anchor",    "arguments": {      "actor_id": "string",      "declared_name": "string",      "mode": "init|seal|status"    }  }}

Response Schema

json

{  "session_id": "uuid",  "omega_0": 0.03-0.05,  "delta_s": "float",  "telos_manifold": {},  "godel_lock": {},  "constitutional_context": "string",  "philosophy": "string",  "vitality_index": "float",  "verdict_range": "000_SEAL|101-499|500-899|999_VOID"}

{  "session_id": "uuid",  "omega_0": 0.03-0.05,  "delta_s": "float",  "telos_manifold": {},  "godel_lock": {},  "constitutional_context": "string",  "philosophy": "string",  "vitality_index": "float",  "verdict_range": "000_SEAL|101-499|500-899|999_VOID"}

📋 FOR AI AGENTS (AGENTS.md Reference)

All AI agents operating in this repository MUST follow the rules in ../AGENTS.md:

RULE 1 DRY_RUN: Dry-run outputs labeled "Estimate Only / Simulated"
RULE 2 DOMAIN_GATE: Cannot-compute domains return exact phrase
RULE 3 VERDICT_SCOPE: Only DOMAIN_SEAL authorizes factual claims
RULE 4 ANCHOR_VOID: init_anchor returns void → session BLOCKED

⚖️ Truth Hierarchy

The arifOS verdict system follows a strict Truth Hierarchy where higher-priority verdicts override lower ones:

Priority	Verdict	Meaning	Action
1 (P0)	`VOID`	Hard constitutional violation	Immediate termination
2 (P1)	`HOLD_888`	Sovereign veto / human required	Block until ratified
3 (P2)	`SABAR`	Insufficient grounding (F7/F9)	Pause, cool down, re-ground
4 (P3)	`PARTIAL`	Data incomplete / conditional	Proceed with modifications
5 (P4)	`SEAL`	Constitutional alignment confirmed	Proceed

Derived Verdicts (not primary):

ALIVE — Session initialized, not yet grounded
PROVISIONAL — Exploratory result, needs confirmation

🗺️ Tool Categories

arifOS tools are organized into 5 constitutional bands:

Band	Range	Purpose	Examples
KERNEL	000–099	Session anchoring, constitutional init	`init_anchor`
SENSE	100–199	Environmental grounding (F2/F4)	`physics_reality`, `math_estimator`
BRIDGE	300–399	Hardened routing and dispatch	`arifOS_kernel`
MIND	333	Constitutional reasoning (F2/F4/F7/F8)	`agi_mind`
HEART	666	Safety critique and impact prediction (F5/F6/F9)	`asi_heart`
VAULT	900–999	Immutable ledger and seal (F1/F13)	`vault_ledger`
APEX	888	Sovereign verdict and defense (F3/F12/F13)	`apex_soul`

🗂️ Contract Truth Table

Tool	F1	F2	F3	F4	F5	F6	F7	F8	F9	F10	F11	F12	F13
`init_anchor`	—	—	—	—	—	—	—	—	—	—	✅	—	—
`physics_reality`	—	✅	—	✅	—	—	—	—	—	—	—	—	—
`agi_mind`	—	✅	—	✅	—	—	✅	✅	—	—	—	—	—
`asi_heart`	—	—	—	—	✅	✅	—	—	✅	—	—	—	—
`apex_soul`	—	—	✅	—	—	—	—	—	—	—	—	✅	✅
`vault_ledger`	✅	—	—	—	—	—	—	—	—	—	—	—	✅

Legend: ✅ = mandatory floor for this tool

📡 Horizon vs VPS Exposure Matrix

Tool	Horizon (External)	VPS (Internal)	Notes
`search_tool`	✅	—	External web search
`reality_compass`	✅	—	Routing/external calls
`vault_ledger`	—	✅	Internal Merkle chain
`agi_mind`	—	✅	Internal reasoning
`architect_registry`	✅	✅	Both interfaces exposed

⚠️ Known Misalignments and Limitations

apex_judge alias: The tool is canonically named apex_soul in code but exposed as apex_judge via MCP. This is a public alias documented here — do not rename canonical code without completing the full migration.
physics_reality field name: Uses input field instead of query — historical inconsistency from legacy API.
check_vital, audit_rules: Internal lifecycle tools in server_horizon.py bootstrap — NOT callable via MCP.
agi_mind nested verdicts: When agi_mind returns verdict: "SEAL" at top-level but coherence.verdict: "SABAR" inside, the worst verdict wins (truth before speed).
search_tool, vault_ledger, reality_compass: These "naked" tools return raw data without verdict wrapper. Wrap in RuntimeEnvelope with verdict_wrapper.forge_verdict() — empty results produce PARTIAL, not VOID.
VerdictCode vs Verdict: Two separate enum classes exist — VerdictCode (SEAL/SABAR/PARTIAL/VOID) for verdict_wrapper and Verdict (includes HOLD/ALIVE/PROVISIONAL) for stage contracts. Keep separate to avoid breaking existing code.

🛰️ MCP Call Schema Examples

init_anchor

json

{  "tool": "init_anchor",  "arguments": {    "actor_id": "user-123",    "declared_name": "Arif",    "mode": "init"  }}

{  "tool": "init_anchor",  "arguments": {    "actor_id": "user-123",    "declared_name": "Arif",    "mode": "init"  }}

agi_mind (reason mode)

json

{  "tool": "agi_mind",  "arguments": {    "mode": "reason",    "query": "Why does entropy matter?",    "constitutional_context": {      "stage": "MIND_333",      "floors_active": ["F2", "F4", "F7", "F8"]    }  }}

{  "tool": "agi_mind",  "arguments": {    "mode": "reason",    "query": "Why does entropy matter?",    "constitutional_context": {      "stage": "MIND_333",      "floors_active": ["F2", "F4", "F7", "F8"]    }  }}

vault_ledger (seal mode)

json

{  "tool": "vault_ledger",  "arguments": {    "mode": "seal",    "data": {      "content": "Verified fact",      "metadata": {"source": "arifOS"}    }  }}

{  "tool": "vault_ledger",  "arguments": {    "mode": "seal",    "data": {      "content": "Verified fact",      "metadata": {"source": "arifOS"}    }  }}

apex_soul (judge mode)

json

{  "tool": "apex_soul",  "arguments": {    "mode": "judge",    "action": "seal_vault",    "stakes": "HIGH"  }}

{  "tool": "apex_soul",  "arguments": {    "mode": "judge",    "action": "seal_vault",    "stakes": "HIGH"  }}

🔐 Stability Tiers

Tier	Description	Verdict Expected
A	Verified, stable, ready for production	`SEAL`
B	Verified, hardened, minor issues resolved	`SEAL` or `PARTIAL`
C	Verified, known limitations documented	`PARTIAL` or `SABAR`
D	Experimental, breaking changes possible	Any
INTERNAL	Not exposed via MCP	N/A

🏛️ LICENSE

Runtime: AGPL-3.0 (must release modifications) Theory: CC0 (public domain)

Version: 2026.03.28-SEALED Maintainer: Muhammad Arif bin Fazil Constitutional Authority: 888_JUDGE

Ditempa Bukan Diberi — Forged, Not Given [ΔΩΨ | ARIF]

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

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

Source: README.md at commit 8ebbb17

Tools

arif_init

000 Init · Kernel Session

KERNEL 000 · Ignite a governed kernel session: binds actor identity, constitutional floors F1–F13, and the audit chain. Returns the session_id + session_token that every other arif_* verb requires. Use mode=preflight to inspect an existing session without re-igniting, mode=resume to continue one. Modes: init, preflight, resume, validate, canary, triage, epoch_open, epoch_seal, light, opt_out.Auth: the only verb needing no session — it mints the session_id + session_token every other verb requires. Returns: session_id, session_token, constitution_hash, allowed_next_tools.

Parametersmodenonceintentrequiredcontextpayloadtoolingverboseactor_idepoch_idevidencetrace_idverbosity+16 more

arif_observe

111 Observe · Sense Reality

KERNEL 111 · Collect evidence — facts and sources with epistemic tags (OBS) and uncertainty bounds, never conclusions. mode=search queries the open web/literature; mode=fetch retrieves a URL and records its provenance; mode=vitals reads kernel machine telemetry. Reason over what you gathered with arif_think; delegate domain analysis to an organ with arif_route. Modes: search, fetch, hybrid_discovery, ingest, compass, atlas, entropy_dS, vitals.Auth: requires session_id + session_token from arif_init. Returns: evidence items with epistemic tags (OBS) and uncertainty bounds — facts, never conclusions.

Parametersurlmodequerylayersactor_idsession_idresult_limitsession_token

arif_think

333 Think · Mind

KERNEL 333 · Structured reasoning pass: decomposes a query and returns reasoning steps labeled OBS (observed), DER (derived), INT (interpretation), SPEC (specification) under truth floors. Produces reasoning records only — no verdicts (those come from arif_judge) and no state changes. The plan-family modes draft/review/approve execution plans; simulate and wonder explore counterfactuals. Modes: reason, reflect, verify, axioms, plan, plan_review, plan_approve, refactor_plan, metabolize, simulate, wonder, atlas.Auth: requires session_id + session_token from arif_init. Returns: reasoning steps labelled OBS/DER/INT/SPEC — records only; verdicts belong to arif_judge.

Parametersmodequerycontextplan_idactor_idsession_idwitness_typesession_token

arif_route

444 Route · Intent→Organ

KERNEL 444 · Intent→organ router: classifies a natural-language intent and dispatches it to the specialist organ (GEOX geoscience, WEALTH capital, WELL vitality, A-FORGE execution). Returns the routing decision only — no organ call — unless organ_tool names the target tool and arguments carries its inputs. Prefer this over guessing organs yourself; use arif_think for reasoning you keep in-kernel.Auth: requires session_id + session_token from arif_init. Returns: the routing decision (organ + tool) only — the organ call itself is a separate step.

Parametersmodetaskorganintentactor_idargumentsmission_idorgan_toolsession_idsession_tokencontract_c_kwargs

arif_memory

Memory Governor · Kernel

KERNEL 555 · Governed memory of the kernel itself: six tiers (L1–L6) with per-mode gating. recall, inspect, and audit are read paths; remember, revise, promote, and forget mutate tiers — promote and forget additionally require human_approval=true. Use for cross-session lessons, canon, and memory audit; external evidence belongs to arif_observe and reasoning artifacts to arif_think. Modes: recall, inspect, attest, remember, promote, revise, forget, audit, metabolize.Auth: requires session_id + session_token from arif_init. Returns: memory entries by tier (L1–L6); promote and forget gates require explicit human approval.

Parametersmodetierquerycontentpayloadto_tieractor_idlease_idtrace_idmemory_idsession_idnew_content+3 more

arif_judge

666 Judge · Verdict

KERNEL 666 · Binding constitutional arbitration: evaluates a candidate action or claim and returns SEAL / HOLD / SABAR / VOID with the full reason chain. Weighs action class, blast radius, reversibility, entropy pathway, and cooling state; a SEAL verdict here is what arif_forge requires before it will execute anything. Judge arbitrates — it does not gather (evidence comes via arif_observe, reasoning via arif_think) and it does not mutate (execution is arif_forge, permanence is arif_seal). Modes: judge, intercept, validate, hold, escalate.Auth: requires session_id + session_token from arif_init. Returns: verdict (SEAL/HOLD/SABAR/VOID) with the full reason chain — arbitration only, it does not mutate.

Parametersmodenoncedomainkey_idactor_Bactor_idevidenceactor_Phicandidateclaim_textsession_idaction_tier+19 more

arif_forge

777 Forge · Execute Gate

KERNEL 777 · Governed execution: applies a mutation through A-FORGE only when carrying a sealed verdict id (seal_verdict_id) from arif_judge and a live session. The manifest/query defines exactly what changes; mode=dry_run previews the plan without applying it. This is the only verb that executes general mutations — kernel memory writes go to arif_memory and permanent records to arif_seal.Auth: requires session_id + session_token from arif_init plus a sealed verdict id (seal_verdict_id) from arif_judge. Returns: the applied mutation receipt — one of the two committal verbs (with arif_seal).

Parametersmodequeryplan_idactor_idmanifestsession_idarif_ack_idartifact_idsession_tokenvault_entry_idseal_verdict_idack_irreversible+3 more

arif_seal

999 Seal · VAULT999

KERNEL 999 · Append an entry to VAULT999, the immutable ledger — accepted entries can never be edited or removed; there is no unseal. Use for permanent records of verified outcomes, lessons, and session closure once a verdict exists. ack_irreversible=true is the explicit acknowledgment of permanence, and judge_state_hash binds the entry to the verdict that authorized it. Reversible changes belong in arif_forge under a SEAL. Modes: seal, verify, ledger, changelog, audit, session_close.Commit projection: seven of the eight verbs are reversible or informational and project their outcomes onto the two committal verbs — arif_forge (governed mutation) and arif_seal (permanence). Auth: requires session_id + session_token from arif_init. Returns: the immutable ledger entry id — append-only, there is no unseal.

Parametersmodenoncepayloadrequiredactor_idsession_iddrift_eventsseal_purposewitness_typesession_tokenconstitutionalactor_signatureack_irreversible+2 more

arif_report

Arif Report

AGENT REPORT LANE · File or read reports between agents without involving the human. Use when your work is done, when you are blocked by another agent, or when you need to tell peers a fact. modes: report (file), inbox (read peers), ack, flush, stats. kind=fyi|peer|done|claim stay in the peer lane; ONLY kind=decision or kind=blocked reach the sovereign, and only in one coalesced message. Reports are SELF_REPORTED — probe before relying on one.

Parametersbodykindmodeforcelimitsincesenderdry_runsubjectactor_idevidenceplatform+7 more

Version history

v2026.03.22LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts
Declare a license in the repository or the registry entry.

Repo	URL
arifOS (parent)	https://github.com/ariffazil/arifOS
arifosmcp (this)	https://github.com/ariffazil/arifOS/tree/main/arifosmcp

Mode	Tools	Features	Entrypoint
Horizon (Cloud)	8	Proxied to VPS	`server_horizon.py`
VPS (Sovereign)	12	Full kernel, local Ollama	`runtime/server.py`

Tier	Compliance	Retention
`constitutional`	Full F1-F13	Permanent
`standard`	Standard audit	Immutable
`transient`	Ephemeral	Auto-purged

Phase	Focus	Floors
Phase 1 (FAST)	Quick pattern match	F4 Clarity
Phase 2 (REFLECT)	Deep reasoning	F2 Truth, F3 Tri-Witness
Phase 3 (DECIDE)	Action selection	Constitutional prefix