🔍 cocapn-explain

Agent explainability — decision traces, oversight queue, P0/P1/P2 review gates.

Install

pip install cocapn-explain

What It Does

Makes agent decisions inspectable and auditable. Every tile submission gets a trace that records the reasoning chain, confidence score, and gate outcome.

Key Features

• ExplainTrace — Records every step of an agent decision
• Oversight Queue — P0/P1/P2 priority review for sensitive operations
• Decision Audit — Replay any past decision with full context
• Gate Compliance — Verifies decisions meet deadband protocol gates

Usage

from cocapn_explain import ExplainTrace, OversightQueue

trace = ExplainTrace(agent_id="oracle1", task="tile_submit")
trace.add_step("check_confidence", value=0.92)
trace.add_step("p0_gate", outcome="accepted")

queue = OversightQueue()
queue.submit(trace)

Part of the Cocapn Fleet

• deadband-protocol — P0/P1/P2 safety gates
• plato-provenance — Zero-trust tile provenance
• plato-tile-spec — Tile specification

License

MIT