freshcrate
Home > MCP Servers > arifos

arifos

ArifOS β€” Constitutional MCP kernel for governed AI execution. AAA architecture: Architect Β· Auditor Β· Agent. Built for the open-source agentic era.

agentic-aiagiaiai-agentsai-governanceai-safetyclaude-codeconstitutional-aimodel-context-protocolpython

Description

ArifOS β€” Constitutional MCP kernel for governed AI execution. AAA architecture: Architect Β· Auditor Β· Agent. Built for the open-source agentic era.

README

arifOS β€” Constitutional Intelligence Kernel

A transport-independent governance runtime for AI agents built on explicit, auditable constitutional constraints.

DITEMPA BUKAN DIBERI β€” Forged, Not Given

What arifOS Is

arifOS enforces 13 constitutional Floors on all AI tool executions. It separates reasoning, enforcement, and execution so that:

  • No tool can self-approve.
  • No action bypasses audit.
  • No claim becomes fact without constitutional ratification.

Architecture

arifos/
β”œβ”€β”€ core/            ← Pure governance kernel (no transport imports)
β”œβ”€β”€ adapters/mcp/    ← MCP transport bridge
└── tools/           ← Claim producers (import from core only)

Rule: SEAL authority belongs exclusively to 888_JUDGE. All other tools emit CLAIM_ONLY.

Governance Pipeline (000–999)

Stage Tool Role
000 arifos_000_init Session anchoring
111 arifos_111_sense Reality grounding
222 arifos_222_witness Tri-witness consensus
333 arifos_333_mind Constitutional reasoning
444 arifos_444_kernel Metabolic orchestration
555 arifos_555_memory Context memory
666 arifos_666_heart Safety critique
777 arifos_777_ops Operations
888 arifos_888_judge SEAL authority
999 arifos_999_vault Immutable ledger
FORGE arifos_forge Governed execution after SEAL
GATEWAY arifos_gateway Governed organ-to-organ interaction
SABAR arifos_sabar Cooling and hold-state governance

Full doctrine: 000/000_CONSTITUTION.md

The 13 Floors

Floor Name Rule
F1 Amanah No irreversible action without human approval
F2 Truth Factual claims require citation
F3 Tri-Witness Human + AI + Earth consensus required
F4 Clarity Entropy must not increase (Ξ”S ≀ 0)
F5 PeaceΒ² Harm potential must be β‰₯ 1.0
F6 Empathy Stakeholder safety β‰₯ 0.90
F7 Humility Confidence bounded within defined Ξ© range
F8 Genius Quality score β‰₯ constitutional threshold
F9 Ethics Dark pattern score below constitutional threshold
F10 Conscience No unanchored consciousness claims
F11 Audit Log verification on all actions
F12 Resilience Graceful degradation always
F13 Sovereignty Human override always possible

Verdict System

Code Meaning Action
CLAIM_ONLY Tool claims success β€” not executable Guard/invariants must ratify
PARTIAL Invariant failure Proceed with remediation noted
SABAR Cooling required Pause, re-ground
VOID Hard constitutional violation Do not execute
HOLD_888 Human required Escalate
SEAL 888_JUDGE only Execute β€” no other tool may emit this

Separation of Powers

Tool (claim producer)
    ↓ CLAIM_ONLY
Constitutional Guard (F1-F13 evaluation)
    ↓
Invariant Enforcement (epistemic coherence)
    ↓
888_JUDGE (only authority to emit SEAL)
    ↓
VAULT (immutable record)

No silent SEAL is possible.

Quick Start

Local (recommended for reproducibility):

git clone https://github.com/ariffazil/arifOS
cd arifOS
docker compose up -d
curl http://localhost:8080/health

Hosted (evaluation only):

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

Status

  • Package: arifos (was arifosmcp)
  • Core imports: zero FastMCP
  • SEAL authority: 888_JUDGE only
  • Transport: MCP via adapters/mcp/, interchangeable
  • Live public MCP surface: 13 tools on /mcp
  • Live health endpoint: http://localhost:8080/health
  • arifos_222_witness web-search path is normalized for empty/error MiniMax bridge payloads; missing web evidence now degrades honestly instead of raising NoneType errors
  • Baseline: 2026.04.20 β€” Sovereign core/adapter architecture

License

AGPL-3.0 | CC0 (theory/doctrine)

Release History

VersionChangesUrgencyDate
v2026.03.28## What's Changed * Finalize deployment checks, enhance OpenClaw config, and add features… by @ariffazil in https://github.com/ariffazil/arifOS/pull/280 * fix: Additional tool consolidation fixes and governance engine update… by @ariffazil in https://github.com/ariffazil/arifOS/pull/282 * chore(deps): bump prefab-ui from 0.11.2 to 0.13.1 by @dependabot[bot] in https://github.com/ariffazil/arifOS/pull/283 * SEAL(HARDENING): AAA Domain Gate v2026.03.25 β€” Paris Weather Incident by @ariffazil inMedium3/28/2026
v2026.03.24-UNIFIED## What's Changed * arifosmcp Complete Restructure: FastMCP + Trinity Body Architecture by @Copilot in https://github.com/ariffazil/arifOS/pull/238 * Fix broken imports, **kwargs incompatibility, and missing Docker root files for VPS deployment by @Copilot in https://github.com/ariffazil/arifOS/pull/239 * Unify production hardening and PR239 branches by @ariffazil in https://github.com/ariffazil/arifOS/pull/241 * Restructure Trinity Body and unify FastMCP architecture by @ariffazil in https:Medium3/23/2026
v2026.03.07## What's Changed * Enhance vault999 records, align MCP contracts, and improve documentation by @ariffazil in https://github.com/ariffazil/arifosmcp/pull/210 * Merge pull request #210 from ariffazil/main by @ariffazil in https://github.com/ariffazil/arifosmcp/pull/211 * refactor: eliminate three duplicate code patterns across aaa_mcp and triad layers by @Copilot in https://github.com/ariffazil/arifosmcp/pull/213 * feat: Constitutional Decision Visualizer β€” MCP tool, governance API endpoints,Low3/9/2026
2026.02.28# Release 2026.02.28 β€” The Canonical Guard Alignment **Version:** `2026.02.28` **Status:** SEALED **"Ditempa Bukan Diberi β€” Forged, Not Given"** This major release resolves the most critical architectural debt within the arifOS ecosystem, specifically addressing the "dual implementation drift" between the [core](cci:1://file:///C:/Users/User/arifOS/core/kernel/engine_adapters.py:393:4-403:30) constitutional kernel and the `aclip_cai` sensory layer. The AAA MCP tool surface is now stricLow2/28/2026
2026.02.27-FORGE## What's Changed * chore(deps): bump actions/setup-node from 4 to 6 by @dependabot[bot] in https://github.com/ariffazil/arifOS/pull/202 * chore(deps): bump actions/upload-pages-artifact from 3 to 4 by @dependabot[bot] in https://github.com/ariffazil/arifOS/pull/203 * chore(deps): bump actions/setup-python from 5 to 6 by @dependabot[bot] in https://github.com/ariffazil/arifOS/pull/204 * chore(deps): bump codecov/codecov-action from 4 to 5 by @dependabot[bot] in https://github.com/ariffazil/aLow2/27/2026
2026.02.23-AAARelease Notes (2026.2.23) SSE-primary runtime with /mcp fallback is now the default deployment posture. Full-context MCP resources/prompts are published and discoverable. ARIF TEST hardening added deterministic self_audit and provenance markers. APEX phase-1/phase-2 objective alignment now tracks nonstationary drift by query class and escalates via SABAR/888_HOLD thresholds. search_reality now supports Perplexity-first web grounding with Brave fallback (PPLX_API_KEY / PERPLEXITY_API_KEY, faLow2/23/2026
2026.02.17-FORGE-VPS-SEAL## What's Changed * fix: MCP SSE deployment β€” health endpoint + HTTPS proxy headers by @ariffazil in https://github.com/ariffazil/arifOS/pull/185 * Docs/mcp site update by @ariffazil in https://github.com/ariffazil/arifOS/pull/186 * Docs/mcp site update by @ariffazil in https://github.com/ariffazil/arifOS/pull/187 * readme: T000 Rebirth β€” 2026.02.15-FORGE-TRINITY-SEAL by @ariffazil in https://github.com/ariffazil/arifOS/pull/188 * Docs/mcp site update by @ariffazil in https://github.com/ariLow2/18/2026
v64.2.0# v64.2.0 - INIT ANCHOR REBOOT πŸš€ ## 🎯 Major Highlights ### βœ… 9 A-CLIP Constitutional Tools Completely redesigned tool architecture: - **anchor** (000) - Constitutional airlock with 20+ injection patterns - **reason** (222) - Hypothesis generation (Ξ” Mind) - **integrate** (333) - Knowledge grounding (Ξ” Mind) - **respond** (444) - Draft planning (Ξ” Mind) - **validate** (555) - Impact analysis (Ξ© Heart) - **align** (666) - Ethics check (Ξ© Heart) - **forge** (777) - Solution synthesis (Ξ© Heart) Low2/14/2026
v60.0.0**Full Changelog**: https://github.com/ariffazil/arifOS/compare/v55.5.0...v60.0.0Low2/10/2026
v55.5.0## What's Changed * feat: complete README overhaul for agent/human navigation guide by @ariffazil in https://github.com/ariffazil/arifOS/pull/182 **Full Changelog**: https://github.com/ariffazil/arifOS/compare/v55.4...v55.5.0Low2/8/2026
v55.4## What's Changed * Resolve merge conflict: remove MANIFEST.sha256.json deleted in main by @Copilot in https://github.com/ariffazil/arifOS/pull/123 * Copilot/sub pr 82 by @ariffazil in https://github.com/ariffazil/arifOS/pull/122 * Add platform docs summary and AAA_MCP v51 backup by @ariffazil in https://github.com/ariffazil/arifOS/pull/124 * Reconstruction/v52 by @ariffazil in https://github.com/ariffazil/arifOS/pull/125 * Architecture comparison: canonical_core vs arifos/core for MCP + P0Low2/3/2026
v55.3-SEAL# arifOS v55.3-SEAL β€” Constitutional Hardening & Empathy Forge **Release Date:** 2026-02-03 **Authority:** Muhammad Arif bin Fazil (888 Judge) **Motto:** DITEMPA BUKAN DIBERI πŸ’ŽπŸ”₯🧠 --- ## 🎯 Executive Summary This release transforms arifOS from a governance specification into a **live, operational constitutional system**. The two critical blockers (vault persistence and empathy detection) are resolved. The system now enforces all 13 constitutional floors at runtime with PostgrLow2/3/2026
v55.1-SEAL## What's Changed * Resolve merge conflict: remove MANIFEST.sha256.json deleted in main by @Copilot in https://github.com/ariffazil/arifOS/pull/123 * Copilot/sub pr 82 by @ariffazil in https://github.com/ariffazil/arifOS/pull/122 * Add platform docs summary and AAA_MCP v51 backup by @ariffazil in https://github.com/ariffazil/arifOS/pull/124 * Reconstruction/v52 by @ariffazil in https://github.com/ariffazil/arifOS/pull/125 * Architecture comparison: canonical_core vs arifos/core for MCP + P0Low2/1/2026
v50.5.24## What's Changed * Fly.io Launch config files by @fly-io[bot] in https://github.com/ariffazil/arifOS/pull/52 * Document arifOS MCP hardware requirements by @ariffazil in https://github.com/ariffazil/arifOS/pull/53 * Claude/arifos mcp requirements c6 eta by @ariffazil in https://github.com/ariffazil/arifOS/pull/54 * Update 001_AGENTS.md by @ariffazil in https://github.com/ariffazil/arifOS/pull/55 * refactor: Move MCP to arifos/mcp/ with Trinity-only architecture (v50… by @ariffazil in httpsLow1/23/2026
v47.1.0**Full Changelog**: https://github.com/ariffazil/arifOS/compare/v47.0.0...v47.1.0Low1/17/2026
v47.0.0**Full Changelog**: https://github.com/ariffazil/arifOS/compare/v46.2.0...v47.0.0Low1/16/2026
v46.2.0# arifOS v46.2.0: Constitutional Architecture Refinement **Released:** 2026-01-14 **Status:** Stable βœ… ## Overview Major architectural consolidation reducing entropy by 42%. State management and guard enforcement now properly separated and organized into canonical layers. All changes fully backward compatible with deprecation shims (72-hour window). --- ## What's New ### Move 1: State Extraction (Ξ”S -4.2) βœ… **Problem:** State management duplicated in two locations. **SLow1/14/2026
v46.0.0**Full Changelog**: https://github.com/ariffazil/arifOS/compare/v45.0.2...v46.0.0Low1/8/2026
v45.0.0**Full Changelog**: https://github.com/ariffazil/arifOS/compare/v44.0.0...v45.0.0Low12/29/2025
v45.0.0-patch-b1**Full Changelog**: https://github.com/ariffazil/arifOS/compare/v44.0.0...v45.0.0-patch-b1Low12/24/2025
v44.0.0**Full Changelog**: https://github.com/ariffazil/arifOS/compare/v43.1.0...v44.0.0Low12/20/2025
v43.1.0Release v43.1.0Low12/19/2025
v43.0**Full Changelog**: https://github.com/ariffazil/arifOS/compare/v42.0.0...v43.0Low12/18/2025
v42.2.2-sealed**Full Changelog**: https://github.com/ariffazil/arifOS/compare/v42.2.1-sealed...v42.2.2-sealedLow12/17/2025
v42.2.1-sealed**Full Changelog**: https://github.com/ariffazil/arifOS/compare/v42.1.1-fiscal...v42.2.1-sealed # v42.2.1-sealed Date: 2025-12-18 ## Summary This release finalizes the v42 migration cleanup by removing the legacy `v36.3O/` root, repointing all references to the archived v36.3O tree, and ensuring the v37 default runtime manifest loads correctly from archive paths. Documentation is aligned to v42.2.1-sealed. ## Highlights - Removed legacy `v36.3O/` root; canonical v36.3O now lives atLow12/17/2025
v42.1.1-fiscal## What's Changed * Implement Canonical Naming Convention v42.0 - Trinity Standardization & Archive Migration by @Copilot in https://github.com/ariffazil/arifOS/pull/40 **Full Changelog**: https://github.com/ariffazil/arifOS/compare/v41.0.0...v42.1.1-fiscalLow12/16/2025
v41.0.0# arifOS v41.0 Release Notes **Codename:** IGNITION **Release Date:** 2025-12-14 **Status:** GOLD (Constitutionally Validated Production) **Commit:** e1c3dc0 --- ## Executive Summary arifOS v41.0 marks the transition from "Experimental Governance Kernel" to **"Constitutionally Validated Production System"**. This release completes the Ignition Phase with three major achievements: 1. **The Bridge Crossing** - L6 (A-CLIP) connected to L2 (APEX PRIME Kernel) 2. **The Purge** - L5Low12/14/2025
v38.0.0</p><hr><h1>πŸš€ arifOS v38.0.0 β€” Governed AI Through Physics, Not Prompts</h1><p><strong>Status:</strong> βœ… PRODUCTION<br><strong>Tests:</strong> 1250+ passing<br><strong>Safety Ceiling:</strong> 97% (red-team validated)<br><strong>CLI Tools:</strong> 7<br><strong>Distribution:</strong> PyPI ready<br><strong>Memory Write Policy:</strong> <strong>ACTIVE (v38 NEW)</strong><br><strong>License:</strong> AGPL-3.0</p><hr><h2>🧭 What’s New in v38 (Executive Summary)</h2><p>arifOS v38 is a <strong>major Low12/12/2025
v37.1.0[arifOS-v37-RELEASE-NOTES.md](https://github.com/user-attachments/files/24132293/arifOS-v37-RELEASE-NOTES.md) <html> <body> <!--StartFragment--><h1 class="font-display first:mt-xs mb-2 mt-4 font-semimedium text-lg leading-[1.5em] lg:text-xl" id="arifos-v370--release-notes" style="box-sizing: border-box; border-width: 0px; border-style: solid; border-color: oklch(0.9296 0.007 106.53 / 0.1); scrollbar-color: initial; scrollbar-width: initial; --tw-border-spacing-x: 0; --tw-border-spacing-y:Low12/12/2025
36.3Ξ©## arifOS v36.3Ξ© β€” Three-Track Constitutional Launch **Status:** PRODUCTION Β· **Version:** v36.3.0 Β· **Tests:** 780+ passing **Tracks:** Law (A) Β· Spec (B) Β· Code (C) This release makes arifOS **publicly auditable as a constitutional kernel**, not just a codebase. The Law, Spec, and Code layers are now clearly separated, mapped, and visible on GitHub. --- ## πŸ”‘ What’s in this release? ### 1. Track A β€” Law Layer (v36.3Ξ© Canon) **Where:** `v36.3O/canon/` + `canon/` - SeaLow12/10/2025
v35.1.0## Snapshot **arifOS v35.1 Release Notes.** Production kernel with real Ξ”S calculators (perplexity-diff), live Ξ©β‚€ calibration, expanded ΞΊα΅£ auditor. Builds on v35.0 (complete 000β†’999 pipeline, F1-F9 floors, @EYE Sentinel, Cooling Ledger v35Ξ©). ## GitHub Release Title **arifOS v35.1 – Thermodynamic Metrics Live** ## Release Body (Copy-Paste Ready) ### Overview arifOS v35.1 activates **live thermodynamic metrics** on the v35.0 constitutional kernel. Real Ξ”S calculators (perplexity-diff,Low12/4/2025
v35.0.0<html> <body> <!--StartFragment--><h1 data-start="190" data-end="265">πŸœ‚ <strong data-start="195" data-end="263">ArifOS v35Ξ© β€” APEX PRIME Judiciary Lock (Constitutional Runtime)</strong></h1> <p data-start="266" data-end="379"><strong data-start="266" data-end="277">Status:</strong> Stable Β· Constitution-Locked Β· Epoch 35Ξ©<br data-start="318" data-end="321"> <strong data-start="321" data-end="329">Tag:</strong> <code data-start="330" data-end="339">v35.0.0</code><br data-start="339" data-endLow12/2/2025
v33.0.0ArifOS AAA Runtime v33Ξ© β€” ΔΩΨ-governed constitutional kernel for AI agents. This release marks the Basecamp Lock (2025-11-16) for the ArifOS Runtime. All constitutional components are frozen: - ΔΩΨ Physics Substrate - AAA Trinity (ARIF, ADAM, APEX PRIME) - W@W Federation - 8 Constitutional Floors - 000–999 Pipeline - SABAR Protocol - Tri-Witness System - Cooling Ledger - Governance Decision (Dec 2025) This release includes: - Full runtime specs (YAML + JSON schema) - Python rLow11/17/2025

Dependencies & License Audit

Loading dependencies...

Similar Packages

arifOSArifOS β€” Constitutional MCP kernel for governed AI execution. AAA architecture: Architect Β· Auditor Β· Agent. Built for the open-source agentic era.v2026.04.07
mcp-audit🌟 Track token consumption in real-time with MCP Audit. Diagnose context bloat and unexpected spikes across MCP servers and tools efficiently.main@2026-04-21
AgentGuardProtect AI agents by detecting and blocking prompt, command injection, Unicode bypass, and social engineering attacks with customizable security controls.main@2026-04-21
COREA thing that uses AI to write perfect applications. For those who want to know how: a governance runtime enforcing immutable constitutional rules on AI coding agents.v2.2.2
@actwith-ai/mcp-serverGive your AI agent a career. Persistent memory, reputation, expertise, and community β€” for any MCP-compatible AI agent.0.15.1