Opencode Forge

OpenCode /forge — Execution Primitive

When OpenCode is invoked, after /init establishes identity, /forge is the action layer. It mutates code under the agent's authority band (T0/T1/T2/T3).

Output format

FORGE ROUTED
────────────────────────────────────
Task:         <code mutation description>
Executor:     OpenCode (self)
Authority:    T1 (auto-mutate, MUBAH digital ops)
Risk:         REVERSIBLE (git revert available)
────────────────────────────────────
Pre-check:
  F1  AMANAH    ✅ (git revert path exists)
  F4  CLARITY   ✅ (ΔS measured before/after)
  F11 AUDIT     ✅ (commit + receipt trail)
  F13 SOVEREIGN ⚠️ (no F13 ack needed for T1)
────────────────────────────────────
Plan:
  1. <step 1>
  2. <step 2>
  N. <step N>
────────────────────────────────────
→ Executing...
→ After: test, lint, LSP gate
→ Receipt emitted to session
→ /propose-seal to commit to VAULT999

Implementation

def opencode_forge(task: str):
    """OpenCode-native /forge"""

    # 1. /init guard
    envelope = read_federation_session()
    if not envelope.get("session_id"):
        return "ERROR: /init first."

    # 2. Classify tier
    tier = classify_tier(task)
    if tier == "T3":
        return "🛑 888_HOLD — use /propose-seal for irreversible work"

    # 3. Measure entropy_before
    entropy_before = measure_session_entropy()

    # 4. Execute the task
    # - read files
    # - plan edit
    # - apply patch
    # - run tests
    # - commit

    result = execute_coding_task(task)

    # 5. LSP gate check (mandatory before commit)
    if not lsp_gate_passed(result):
        return "🛑 LSP GATE FAILED — fix errors before commit"

    # 6. Measure entropy_after
    entropy_after = measure_session_entropy()
    delta_s = entropy_after - entropy_before

    # 7. Build receipt
    receipt = {
        "ts": now_iso(),
        "event": "OPENCODE_FORGE_EXECUTED",
        "actor": "opencode-zen",
        "warga": "FI-001 PRIMARY",
        "session": envelope["session_id"],
        "task": task,
        "files_changed": result["files"],
        "tests_passed": result["tests_passed"],
        "tests_failed": result["tests_failed"],
        "lsp_gate": "PASSED",
        "delta_s": delta_s,
    }

    return render_forge_result(receipt)

Task classification (T0-T3)

Digital Ops Policy (2026-06-30)

For OpenCode, digital/code/AI/infra = MUBAH (auto-execute). The T3 list above is the EXCEPTION, not the rule. FARD only on physical reality, other humans, real money.

Authority

OpenCode's authority chain:

OpenCode-Zen (333-AGI bound)
   ↓
delegate_task from Hermes/OpenClaw
   ↓
A-FORGE execute (if forge tier)
   ↓
git push → arifOS deploy guard (test + drift check)

Doctrine

• /forge is the action layer between /init and /propose-seal
• /forge is NOT the seal — that's /propose-seal → 888-APEX
• F1 reversibility is the hard gate — if ΔS > 0, HALT and HOLD
• F11 audit — every /forge appends a receipt to the session
• F13 sovereignty — T3 requires Arif's ack, no exceptions

Error states