| # | Document | Description |
|---|---|---|
| 01 | Autonomy Taxonomy | 5 standardized levels of agent autonomy (A1-A5) with governance requirements |
| 02 | Decision Classification | 4 decision types x 4 risk levels x 3 reversibility classes |
| 03 | Trace Format | Hash-chained immutable event schema for decision logging |
| 04 | Authorization Matrix | Rules determining when human approval is required |
| 05 | Policy Schema | Pre-built governance rule templates mapped to regulations |
| 06 | Regulatory Mapping | Mappings to EU AI Act, Loi 25, NIST, ISO 42001, Singapore MGF, IEEE 7001 |
| 07 | Agent Registry | Structured inventory schema for AI agents in an organization |
Machine-readable validation schemas for all core specifications:
| Schema | Validates | Spec |
|---|---|---|
| common.schema.json | Shared definitions — 17 enums, 4 regex patterns | All |
| trace-format.schema.json | Decision trace events | 03 |
| policy-schema.schema.json | Governance policies | 05 |
| agent-registry.schema.json | Agent registry entries | 07 |
| authorization-matrix.schema.json | Matrix configuration | 04 |
The src/ directory contains a complete TypeScript SDK:
| Module | Description |
|---|---|
src/types/ |
TypeScript interfaces matching all JSON schemas |
src/core/ |
Core logic: classify(), authorize(), evaluatePolicy(), generateTraceId(), hashTrace(), verifyChain() |
src/validators/ |
AJV-based schema validators for all document types |
src/builders/ |
Fluent API builders: TraceEventBuilder, PolicyBuilder, AgentRegistryBuilder |
src/__tests__/ |
60 tests covering all matrix cells, overrides, and edge cases |
import {
classify, authorize, evaluatePolicy,
TraceEventBuilder, PolicyBuilder, AgentRegistryBuilder,
validateTrace, validatePolicy,
} from '@adp/core';See the examples/ directory for schema-validated integration examples.
The founding document is available at gouvernance.ai/whitepaper.