arifOS — Constitutional AI Governance Kernel

Status: SOVEREIGN KERNEL | Organ: MIND (Δ) | Authority: 888_JUDGE PyPI: arifos | GHCR: ghcr.io/ariffazil/arifos MCP (canonical): https://arifos.arif-fazil.com/mcp MCP (short alias): https://mcp.arif-fazil.com/mcp

🏛️ What this repo is

The central governance kernel of the arifOS federation. It defines the 13 Constitutional Floors (F1–F13) and hosts the canonical arifosmcp server — a FastMCP-powered governed runtime that exposes 13 canonical tools to AI agents, every call passing through intent validation → constitutional floor checks → verdict before action.

Every tool call is stateful, governed, and pipeline-aware.

MCP Surface (live test 2026-05-17): 14 tools — 13 canonical + 1 governance extra (arif_stack_health_probe). smithery.yaml tracks the 13 constitutional tools only. tool_registry.json canonical surface = 15 (13 + arif_ping + arif_selftest probes).

📦 Ownership

• Owns: Constitutional Law (F1–F13), arifosmcp core logic, VAULT999 ledger, smithery.yaml registry.
• Does NOT own: Frontend surfaces (AAA), Infrastructure orchestration (A-FORGE), Domain logic (GEOX/WELL).

🏗️ Current Structure

arifOS/
├── arifosmcp/              # Primary MCP runtime package (pip install target)
│   ├── server.py           # FastMCP + FastAPI entry point
│   ├── runtime/           # Dozens of runtime modules (tools, sessions, bridges)
│   ├── tools/             # Tool implementations
│   ├── schemas/           # Pydantic output schemas
│   ├── core/              # Governance kernel shims (floor, embodied_engine)
│   ├── Dockerfile         # Multi-stage production build (EXPOSE 8080)
│   └── MCP_TOOLS_README.md
├── core/                   # Root-level constitutional kernel
│   ├── floors.py           # F1–F13 enforcement (~924 lines)
│   ├── judgment.py         # Verdict engine
│   └── vault999/          # Append-only hash-chained ledger
├── VAULT999/               # Local vault ledger
├── tests/                  # Hundreds of test files (pytest, asyncio_mode=auto)
├── smithery.yaml           # Canonical 13-tool manifest (public registry)
├── pyproject.toml         # Root package charter
└── Makefile               # build, test, deploy targets

🧬 13 Canonical Tools (arif_noun_verb)

Sourced from arifosmcp/tool_registry.json (canonical_order):

Stage	Tool	Purpose
000	arif_session_init	Bind actor identity, set safety state = HOLD
111	arif_sense_observe	Reality grounding (web, VPS vitals, atlas)
222	arif_evidence_fetch	External data oracle (GEOX, FRED, EIA)
333	arif_mind_reason	Structured reasoning + contradiction detection
444	arif_kernel_route	Routing + risk orthogonality (AGI/ASI/APEX lanes)
444r	arif_reply_compose	Governed response assembly
555	arif_memory_recall	Semantic memory + skill registry
666	arif_heart_critique	Adversarial F5/F6/F9 pass
666g	arif_gateway_connect	A2A mesh under F1–F13
777	arif_ops_measure	Landauer cost + reversibility classification
888	arif_judge_deliberate	SEAL / HOLD / VOID / SABAR verdict
999	arif_vault_seal	Immutable Merkle-V3 ledger anchor
010	arif_forge_execute	Execution bridge (SEAL-gated only)

Note: tool_registry.json and this table agree on 13 constitutional tools. The /.well-known/mcp/server.json public_surface field reads canonical15 — this is intentional: the MCP surface exposes 15 tools (13 constitutional + arif_ping + arif_selftest probes). smithery.yaml also lists 13 because it tracks constitutional tools only.

🚀 Verified Commands

# Install from PyPI
pip install arifos

# Install from source (editable, with dev extras)
pip install -e ".[dev]"

# Run MCP server (HTTP + SSE)
python -m arifosmcp.server
# or via module:
python -m arifosmcp.runtim

... [View full README on GitHub](https://github.com/ariffazil/arifos#readme)