@chibakuma/aca-conformance

Test your implementation against the Agent Civilization Architecture (ACA) protocol — 34 protocol-level tests across 5 layers + governance plane.

npm: @chibakuma/aca-conformance · Protocol Spec: github.com/MakiDevelop/agent-civilization-architecture

Quick Start

npm install @chibakuma/aca-conformance

import { runLayer1, runLayer2, type AcaTestAdapter } from "@chibakuma/aca-conformance";

// Implement the adapter for your backend
const myAdapter: AcaTestAdapter = {
  async write(cell) { /* your implementation */ },
  async read(query) { /* your implementation */ },
  async supersede(newCell, targetId) { /* your implementation */ },
  async revoke(memoryId) { /* your implementation */ },
  async tierUpgrade(memoryId, newTier, trustProof) { /* your implementation */ },
  async transfer(memoryId, targetNamespace, targetAgentId) { /* your implementation */ },
  async expire(memoryId) { /* your implementation */ },
  async audit(memoryId) { /* your implementation */ },
  async cleanup() { /* reset test state */ },
};

// Run conformance tests
runLayer1(myAdapter);  // 8 tests — Memory operations + governance gates
runLayer2(myAdapter);  // 5 tests — Trust tiers + Anti-Ouroboros + provenance

Run with Node.js built-in test runner:

node --test --import tsx your-test-file.ts

Conformance Levels

| Level | Adapter | Tests | What it proves | |---|---|---|---| | Layer 1 | AcaTestAdapter | 8 | Memory CRUD + dedup + namespace isolation + lifecycle + audit | | Layer 1+2 | AcaTestAdapter | 13 | + Anti-Ouroboros + tier transitions + provenance chain | | Layer 1+2+3 | AcaIdentityAdapter | 18 | + Principal registry + auth + ACL + human enforcement | | Layer 4 | AcaAuthorityAdapter | 6 | Role manifest + capability check + escalation + independent review | | Layer 5 | AcaDecisionAdapter | 5 | Decision lifecycle + risk classification + separation of duties | | Governance | AcaGovernanceAdapter | 4 | Immutable rules + amendments + suspend + health check |

Individual Tests

You can also import individual test functions:

import {
  writeTests,
  antiOuroborosTests,
  principalTests,
} from "@chibakuma/aca-conformance";

writeTests(myAdapter);
antiOuroborosTests(myAdapter);
principalTests(myIdentityAdapter);

Adapter Interfaces

See the full adapter interface definition: adapter.ts source

Each layer has its own adapter interface:

• AcaTestAdapter — Layer 1-2 (Memory + Trust)
• AcaIdentityAdapter — Layer 3 (Identity)
• AcaAuthorityAdapter — Layer 4 (Authority)
• AcaDecisionAdapter — Layer 5 (Decision)
• AcaGovernanceAdapter — Governance Plane

ACA Ecosystem

| Package | Purpose | npm | |---|---|---| | ACA Spec | Protocol specification (5 layers + governance plane) | — | | Agent Memory Hall | Reference implementation of ACA Layers 1-3 | @chibakuma/agent-memory-hall | | aca-govern | MCP governance proxy | @chibakuma/aca-govern | | aca-types | TypeScript type definitions | @chibakuma/aca-types | | aca-conformance (this package) | Conformance test suite | @chibakuma/aca-conformance |

License

Apache 2.0