HUMAN THEORY APPS

# 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 sealing
- `reality_atlas` — Vector-based evidence retrieval using Qdrant with constitutional governance and semantic search across the evidence graph
- `arifOS_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 metrics
- `init_anchor_state` — Session identity initialization with anchor token minting and sovereign identity binding
- `verify_vault_ledger` — VAULT999 Merkle chain integrity verifier with full SHA-256 chain validation and breach detection
- `audit_rules` — Constitutional audit engine for evaluating content against specific floor rules with threshold analysis
- `session_memory` — Sovereign session memory system supporting store, retrieve, list, and forget operations
- `open_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 `mcp` Python client with STDIO and HTTP transport examples
- TypeScript SDK — Full `@modelcontextprotocol/sdk` client 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_atlas` evidence 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.