arifos-mcp-call

Files (1)

• SKILL.md

SKILL.md (first lines)

# arifOS MCP Caller v2 — Constitutional Anchor-First

**Runtime:** 42-tool constitutional kernel (not 13)
**Requirement:** `init_anchor` MUST be called before `arifOS_kernel`
**Floors:** F1-F13 enforced via sBERT ML layer

## Constitutional Tool Contract

| Stage | Tool | Purpose |
|-------|------|---------|
| **000_INIT** | `init_anchor` | **REQUIRED FIRST** — Bootstrap session, bind actor_id, risk tier |
| **333→888** | `arifOS_kernel` | Full pipeline: reason → memory/heart → critique → forge → judge |
| **888_JUDGE** | `apex_judge` | Cross-check decisions |
| **999_VAULT** | `vault_seal` | Persist to VAULT999 |

## CLI Usage (via arifos bridge)

```bash
# 1. Bootstrap anchor (REQUIRED before kernel)
arifos anchor

# 2. Call kernel with dry-run first
arifos kernel '{"query":"Analyze this","dry_run":true,"actor_id":"arif"}'

# 3. Full execution (after verification)
arifos kernel '{"query":"Execute task","actor_id":"arif","risk_tier":"medium"}'

# Evidence & Memory
arifos search '{"query":"AI governance Malaysia"}'
arifos ingest '{"url":"https://example.com/doc"}'
arifos memory '{"operation":"search","content":"What is Floor F2?"}'

# System & Audit
arifos health
arifos vital
arifos audit

# AgentZero
arifos engineer
arifos validate
arifos holdcheck
```

## F13 Sovereignty Handling

If the kernel returns `requires_human: true` or `verdict: "HOLD_888"`:
- **STOP execution**
- **Prompt user for confirmation**
- **Do not proceed until explicit "do it"**

Exit code 88 = HOLD_888 (sovereign approval required).

## Direct HTTP (advanced)

```bash
# Health & discovery
curl -s http://arifosmcp:8080/health | jq

# List all 42 tools
curl -s -X POST http://arifosmcp:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# Anchor session (000_INIT)
curl -s -X POST http://arifosmcp:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "init_anchor",
      "arguments": {
        "actor_id": "arif",
        "risk_tier": "low",
        "session_id": "test-001"
      }
    }
  }'

# Kernel call (after anchor)
curl -s -X POST http://arifosmcp:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "arifOS_kernel",
      "arguments": {
        "query": "Explain F1-F13 in 3 bullets",
        "actor_id": "arif",
        "risk_tier": "low",
        "dry_run": true
      }
    }
  }'
```

## Golden Test Pair (Acceptance)

Run these to verify OpenClaw ↔ arifOS wiring:

**Test A — Bootstrap:**
```bash
arifos anchor
# Expect: {"ok": true, "status": "anchored"}
```

**Test B — Kernel Dry-Run:**
```bash
arifos kernel '{"query":"Test","dry_run":true}'
# Expect: 000→999 pipeline simulated, no external execution
```

**Test C — F13 Hold:**
```bash
arifos kernel '{"query":"Drop production database"}'
# Expect: {"verdict": "HOLD_888", "status": "AWAITING_SOVEREIGN_APPROVAL"}

From ariffazil/arifOS, AGPL-3.0.

More from ariffazil/arifOS