# arifOS — MCP Transported Context
# Version: v2026.05.22-GDK
# Surface: 13 canonical arifOS tools + Governed Discovery Kernel
# Seal phrase: DITEMPA BUKAN DIBERI

## What arifOS Is

arifOS is the governed action gateway for the arifOS Federation. It exposes a 13-tool MCP surface and wraps capability use with discovery, evidence, risk, authority, reversibility, human-approval, and audit boundaries.

Core principle:

```text
Full legibility. Bounded access. Auditable action. Human judgment.
```

## Canonical MCP Endpoints

- Public gateway: `https://mcp.arif-fazil.com/mcp`
- arifOS service endpoint: `https://arifos.arif-fazil.com/mcp`
- Health: `https://arifos.arif-fazil.com/health`
- Tools registry: `https://arifos.arif-fazil.com/tools`
- Server manifest: `https://arifos.arif-fazil.com/.well-known/mcp/server.json`
- Discovery index: `https://arifos.arif-fazil.com/mcp-discovery-index.json`

Use MCP `tools/list` after initialization/session negotiation for authoritative callable tools.

## 13 Canonical Tools

| Stage | Tool | Role |
|---|---|---|
| 000 | `arif_session_init` | Session and identity binding |
| 111 | `arif_sense_observe` | Reality observation and hybrid discovery |
| 222 | `arif_evidence_fetch` | Evidence retrieval with receipts |
| 333 | `arif_mind_reason` | Reasoning, planning, verification |
| 444 | `arif_heart_critique` | Risk, empathy, red-team critique |
| 555 | `arif_kernel_route` | Intent routing and topology |
| 444r | `arif_reply_compose` | Governed response composition |
| 555m | `arif_memory_recall` | Governed memory recall/store/list |
| 666g | `arif_gateway_connect` | Federation/A2A gateway |
| 888 | `arif_judge_deliberate` | Constitutional deliberation |
| 999 | `arif_vault_seal` | VAULT999 audit/seal surface |
| 666 | `arif_forge_execute` | Bounded execution/forge action |
| 777 | `arif_ops_measure` | Health, cost, telemetry |

## Governed Discovery Kernel

Before high-consequence action, orient with:

```text
arif_sense_observe(mode="compass")
```

`compass` is the GDK orientation loop. It uses `hybrid_discovery` as the read-only evidence engine.

The Capability Manifest Loop:

```text
Intent -> discovery -> capability manifest -> relevance/risk/permission check
  -> narrowed action -> human judgment if needed -> execute or stop
  -> audit -> discovery map update
```

Required manifest fields: `can_do`, `cannot_do`, `required_inputs`, `outputs`, `permissions`, `risks`, `reversibility`, `audit`, `human_approval`.

## Federation Tool Counts

Verified by `https://arifos.arif-fazil.com/api/federation-probe` on 2026-05-22:

- arifOS: 13 MCP tools, healthy.
- GEOX: 22 MCP tools, healthy.
- WEALTH: 17 MCP tools, healthy.
- WELL: 15 MCP tools, healthy, REFLECT_ONLY.
- Wiki: static knowledge surface, 0 MCP tools.

## Boundary

MCP transports capability. arifOS governs capability. APEX may deliberate. Arif remains final sovereign authority.
