ariffazil/arifos/arif-init-wrapper

arif-init-wrapper

P0 — Universal Anchor for All Agent Vendors Seal: DITEMPA BUKAN DIBERI · 2026-03-27

Purpose

Every agent on this VPS starts from the same broken state: no anchor, no session context, no constitutional grounding. The arif-init-wrapper closes this gap for every vendor by providing a universal bootstrap that:

1. Establishes a governed session via arifOS MCP
2. Verifies the agent's identity context
3. Checks constitutional floor health before any tool is touched
4. Reads carry-forward context from memory before starting work
5. Reports its status to the operator in plain language

Why this is P0: Without this, agents operate unanchored — the exact condition that produced the opencode catastrophe (session with no constitutional grounding, leading to blind git reset --hard origin/main).

Trigger Patterns

Every time any of these agents start a session, run arif-init-wrapper:

Protocol

Step 1 — Anchor Session

# Probe arifOS MCP availability
curl -sf http://localhost:8080/health 2>/dev/null && {
  # Session anchor via MCP
  arifosmcp_call tool=init_anchor payload='{"actor_id":"AGENT","session_purpose":"WORK"}'
} || {
  echo "[UNANCHORED] arifOS MCP unavailable. Operating WITHOUT constitutional grounding."
  echo "[WARNING] This is high-risk. Proceed with extreme caution."
}

Step 2 — Constitutional Integrity Check (LAW 2)

Before any work, verify the foundation:

# Check core directory integrity
core_modules=$(ls /root/arifosmcp/core/*.py 2>/dev/null | wc -l)
if [ "$core_modules" -lt 10 ]; then
  echo "[P0 CONSTITUTIONAL CRISIS] /root/arifosmcp/core/ appears broken ($core_modules modules, expected 20+)"
  echo "[ACTION] HALT. Report to Arif. Do not proceed."
  echo "[RECOVERY] Check feature branches: git branch -a | grep feature/"
  return 1 2>/dev/null || exit 1
fi
 
# Check pytest can collect tests (structural sanity)
cd /root/arifosmcp && pytest --collect-only -q 2>/dev/null | tail -1 && {
  echo "[OK] Constitutional structure verified."
} || {
  echo "[WARNING] pytest collection failed. Foundation may be unstable."
}

Step 3 — Check Floors (F1–F13 baseline)

# Verify critical floors are loadable
python3 -c "
import sys
sys.path.insert(0, '/root/arifosmcp')
try:
    from core.shared.floors import THRESHOLDS
    floors_ok = len(THRESHOLDS) >= 13
    print(f'[FLOORS] {len(THRESHOLDS)}/13 loaded')
except Exception as e:
    print(f'[FATAL] Floor check failed: {e}')
    sys.exit(1)
"

Step 4 — Memory Carry-Forward

# Query recent scars and unresolved issues
arifosmcp_call tool=memory_query payload='{"query":"recent scars unresolved actions","limit":5}'

Step 5 — Agent Identity Declaration

State clearly:

• Which agent vendor is running
• Whether constitutional grounding is active or unavailable
• Any constitutional warnings for this session

Step 6 — Operator Report

Report to Arif in plain language:

[ANCHOR] Agent: {vendor}
[STATUS] arifOS MCP: {available/unavailable}
[FLOORS] Constitutional check: {pass/wail}
[CORE]   Core modules: {count}/expected
[MEMORY] Recent context: {carry_forward_summary}
[RISK]   Session risk level: {LOW/MEDIUM/HIGH/CRITICAL}
[ACTION] Ready to proceed: YES/NO

Decision Matrix

Anti-Patterns This Closes

1. Unanchored Codex — codex runs without session context, blunders into git reset --hard
2. Ungrounded Gemini — gemini assumes origin/main is good without checking
3. Skip-before-check — Any agent that runs git pull before verifying the repo is structurally sound
4. Silent failure — Agent operates in a broken state without telling Arif

Constitutional Alignment

arif-init-wrapper — Forged 2026-03-27 · DITEMPA BUKAN DIBERI · Universal Agent Anchor 🔐