Changelog
Release history for arifOS MCP. Every version is forged through constitutional verification — Ditempa Bukan Diberi.
March 13, 2026
v2026.03.14-FORGED
The inaugural forged release. Complete constitutional AI governance system with full MCP integration, 13-floor verification, Trinity ΔΩΨ engines, and VAULT999 immutable ledger.
New Tools
reality_compass— Constitutional web search powered by Brave Search API with full 13-floor governance and VAULT999 sealingreality_atlas— Vector-based evidence retrieval using Qdrant with constitutional governance and semantic search across the evidence grapharifOS_kernel— The core governance kernel. Routes any query through all 13 constitutional floors with full metabolic loop (000→999)check_vital— System health monitor exposing thermodynamic budget, floor pass rate, vault integrity, and 3E telemetry metricsinit_anchor_state— Session identity initialization with anchor token minting and sovereign identity bindingverify_vault_ledger— VAULT999 Merkle chain integrity verifier with full SHA-256 chain validation and breach detectionaudit_rules— Constitutional audit engine for evaluating content against specific floor rules with threshold analysissession_memory— Sovereign session memory system supporting store, retrieve, list, and forget operationsopen_apex_dashboard— APEX governance dashboard providing real-time session analytics, floor pass rates, and verdict distribution
Architecture
- MGI Envelope — Metabolic Governance Intelligence wrapper that encloses every AI response in a constitutional verification membrane
- Metabolic Loop — 10-stage pipeline (000_INIT → 999_VAULT) for full constitutional processing
- Trinity Engines — Three-engine architecture: Δ (Epistemic), Ω (Ethical), Ψ (Execution)
- VAULT999 — Immutable SHA-256 Merkle chain for recording every governance decision with tamper-proof audit trail
- Constitutional Floors — 13 floors (F1 Tauhid → F13 Khalifah) with configurable thresholds and VOID triggers
- 3E Telemetry — Real-time observability across Epistemic, Ethical, and Execution dimensions
Verdict System
- SEAL — Full verification. All 13 floors passed, response sealed into VAULT999
- PROVISIONAL — High confidence but one or more non-critical floors below threshold
- PARTIAL — Mixed results. Critical floors passed but evidence gaps remain
- SABAR — Patience state. Awaiting additional evidence or external data
- HOLD — Temporarily held. Mechanical issues (not constitutional violations)
- HOLD_888 — Judge-level hold. The 888_JUDGE stage requires additional review
- VOID — Constitutional violation detected. Reserved exclusively for floor breaches
Integrations
- Claude Desktop — Native STDIO integration via
claude_desktop_config.json - Cursor / VS Code — MCP server configuration for AI-assisted development environments
- ChatGPT — HTTP transport integration for OpenAI's ChatGPT with function calling
- Kimi — HTTP transport integration for Moonshot AI's Kimi assistant
- Python SDK — Full
mcpPython client with STDIO and HTTP transport examples - TypeScript SDK — Full
@modelcontextprotocol/sdkclient with STDIO and HTTP examples - HTTP / curl — RESTful JSON-RPC interface for direct API access
Transport
- STDIO — Default transport for local client integration (Claude Desktop, Cursor)
- Streamable HTTP — HTTP transport on configurable port for remote/cloud deployments
- Docker — Official container image at
ghcr.io/ariffazil/arifosmcp:latest
Infrastructure
- FastMCP 3.1.0 — Built on the FastMCP server framework with Python ≥ 3.12
- Qdrant — Optional vector database for
reality_atlasevidence storage - Brave Search — Web search provider for
reality_compass - Docker Compose — Production deployment with Nginx reverse proxy, Qdrant, and persistent VAULT999 storage
- VPS Architecture — Reference architecture for self-hosted deployments with TLS termination
Developer Documentation
- Complete API reference for all 9 active tools + 2 legacy tools
- Constitutional floors reference with thresholds, VOID triggers, and fault codes
- Integration guides for 7 platforms with full configuration examples
- Architecture overview with MGI Envelope, Metabolic Loop, and Trinity Engine documentation
- Getting started guide with installation, quick start, and environment variable reference
Versioning Convention
arifOS MCP uses date-based versioning in the format vYYYY.MM.DD-TAG. The FORGED tag indicates a release that has passed full constitutional verification — true to the principle Ditempa Bukan Diberi (Forged, Not Given).
Migration Notice
Legacy Tool Deprecation
The following tools from pre-release development have been deprecated in favor of their constitutional replacements:
| Legacy Tool | Replacement | Migration Notes |
|---|---|---|
search_reality |
reality_compass |
Replace query parameter with input. Results now include full governance envelope with verdict and telemetry. |
ingest_evidence |
reality_atlas |
Use action: "ingest" parameter. Automatic vector embedding replaces manual chunking. Constitutional governance now applied to all ingested content. |
Removal Timeline
Legacy tools will be removed in a future release. Migrate to the replacement tools as soon as possible. Both legacy tools currently forward to their replacements internally but do not return governance envelopes.