Card Lifecycle & Policy Intelligence (CLPI)
CLPI is Mnemom’s governance layer — a 5-phase system that transforms alignment cards from static declarations into lifecycle-managed artifacts with policy enforcement, trust recovery, risk intelligence, and on-chain anchoring.The problem CLPI solves
Without CLPI, a common failure mode undermines trust scores:- An operator adds a new MCP server to an agent (e.g., a browser tool)
- The alignment card is not updated to declare the new capability
- The agent uses the tool correctly, but the policy engine flags it as an
UNMAPPED_TOOLviolation - The agent’s trust score drops — even though the agent did nothing wrong
How CLPI relates to AAP and AIP
AAP and AIP are detection protocols — they identify misalignment and compromise. CLPI is the governance layer that prevents problems, recovers from false positives, and anchors trust on-chain.| AAP | AIP | CLPI | |
|---|---|---|---|
| Role | Post-hoc verification | Real-time integrity | Governance & recovery |
| Catches | Behavioral drift over time | Active attacks in progress | Configuration drift, false violations |
| Mechanism | Alignment Cards + AP-Traces | Thinking block analysis | Policy enforcement + reclassification |
| When | After the agent acts | While the agent thinks | Before, during, and after |
The 5 phases
Phase 1: Policy Engine
Governance-as-code. A declarative YAML-based DSL that bridges alignment card capabilities to concrete tool enforcement. Policies define which tools map to card capabilities, what is forbidden, and how unmapped tools are handled — evaluated in CI/CD, at the gateway, and post-action.Policy Engine concepts | Policy DSL spec | Policy CLI
Phase 2: Card Lifecycle & Trust Recovery
Alignment cards become lifecycle-managed artifacts with versioned amendments, violation reclassification (
card_gap vs. behavior_gap), automatic score recovery, session re-proofing, and compliance export. When a violation was caused by a missing capability — not agent misbehavior — the score recovers.Card Lifecycle concepts | Trust Recovery guidePhase 3: Intelligence Layer
Analytical capabilities on top of policy and reputation data. Fault line analysis identifies value conflicts across teams. Risk forecasting predicts failure modes. LLM-powered policy recommendations generate governance rules from team analysis. Transaction guardrails scope enforcement to individual operations.Intelligence API
Phase 4: On-Chain Verification
Immutable reputation anchoring on Base L2. Merkle roots from the integrity checkpoint tree are anchored to the
MnemoMerkleAnchor contract. Reputation scores are published to the MnemoReputationRegistry. Any third party can verify an agent’s score without trusting Mnemom’s infrastructure.On-Chain Verification concepts | On-Chain guidePhase 5: Observability
OpenTelemetry integration for the full governance pipeline. Policy evaluation spans, reclassification spans, and policy-aware drift detection — all exported to any OTel-compatible backend. See Observability guide and OTel attributes spec.
CLPI sub-pages
Policy Engine
Phase 1. Governance-as-code: capability mappings, forbidden rules, enforcement modes, and policy merge.
Card Lifecycle
Phase 2. Amendments, violation reclassification, trust recovery, score recomputation, and compliance export.
Trust Recovery Guide
Step-by-step workflow for reclassifying violations and recovering trust scores.
On-Chain Verification
Phase 4. Merkle root anchoring and reputation publishing on Base L2.
Observability
Phase 5. OTel spans for policy evaluation, reclassification, and drift detection.
Policy Management Guide
Writing, deploying, and iterating on governance policies.
API surface
CLPI spans four API domains:| Domain | Phase | Overview | Key operations |
|---|---|---|---|
| Policy | Phase 1 | Policy API | CRUD policies, evaluate tools, resolve merged policy |
| Reclassification | Phase 2 | Reclassification API | Reclassify violations, recompute scores, export compliance |
| Intelligence | Phase 3 | Intelligence API | Fault lines, risk forecast, policy recommendations, transactions |
| On-Chain | Phase 4 | On-Chain API | Anchor roots, publish scores, verify proofs |
See Also
- Changelog — CLPI release — Full release notes with implementation details
- Policy DSL Specification — Normative YAML schema reference
- CI/CD Policy Gates — Integrating policy checks into deployment pipelines
- Reputation Scores — How trust scores are computed and how CLPI affects them