agent-alignment-protocol 0.5.0__tar.gz → 2.0.0__tar.gz

{agent_alignment_protocol-0.5.0 → agent_alignment_protocol-2.0.0}/.gitignore

@@ -40,6 +40,8 @@ env/
 .coverage
 .coverage.*
 htmlcov/
+coverage/
+coverage.xml
 .pytest_cache/
 .hypothesis/
 

{agent_alignment_protocol-0.5.0 → agent_alignment_protocol-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-alignment-protocol
-Version: 0.5.0
+Version: 2.0.0
 Summary: Agent Alignment Protocol - The missing alignment layer for the agent protocol stack
 Project-URL: Homepage, https://github.com/mnemom/aap
 Project-URL: Documentation, https://github.com/mnemom/aap#readme
@@ -46,7 +46,7 @@ Description-Content-Type: text/markdown
 [![PyPI](https://img.shields.io/pypi/v/agent-alignment-protocol.svg)](https://pypi.org/project/agent-alignment-protocol/)
 [![npm](https://img.shields.io/npm/v/@mnemom/agent-alignment-protocol.svg)](https://www.npmjs.com/package/@mnemom/agent-alignment-protocol)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
-[![Spec](https://img.shields.io/badge/spec-v0.4.0-green.svg)](https://docs.mnemom.ai/protocols/aap/specification)
+[![Spec](https://img.shields.io/badge/spec-v1.0.0-green.svg)](https://docs.mnemom.ai/protocols/aap/specification)
 
 **A transparency protocol for autonomous agents.**
 
@@ -111,21 +111,27 @@ As agent capabilities become symmetric—equal access to information, equal reas
 
 ### Alignment Card
 
-A structured declaration of an agent's alignment posture:
+A structured declaration of an agent's alignment posture, in the unified /
+ADR-039 shape accepted by `mnemom card validate` and the Mnemom platform:
 
 ```json
 {
-  "aap_version": "0.1.0",
+  "card_version": "unified/2026-04-26",
+  "card_id": "ac-my-agent-001",
   "agent_id": "did:web:my-agent.example.com",
+  "issued_at": "2026-04-26T00:00:00Z",
+  "autonomy_mode": "enforce",
+  "integrity_mode": "enforce",
   "principal": {
     "type": "human",
+    "identifier": "did:web:user.example.com",
     "relationship": "delegated_authority"
   },
   "values": {
     "declared": ["principal_benefit", "transparency", "minimal_data"],
     "conflicts_with": ["deceptive_marketing", "hidden_fees"]
   },
-  "autonomy_envelope": {
+  "autonomy": {
     "bounded_actions": ["search", "compare", "recommend"],
     "escalation_triggers": [
       {
@@ -136,14 +142,23 @@ A structured declaration of an agent's alignment posture:
     ],
     "forbidden_actions": ["share_credentials", "subscribe_to_services"]
   },
-  "audit_commitment": {
+  "audit": {
     "trace_format": "ap-trace-v1",
     "retention_days": 90,
-    "queryable": true
+    "queryable": true,
+    "query_endpoint": "https://my-agent.example.com/api/traces"
   }
 }
 ```
 
+> **Migration note (v2.0.0):** earlier releases used the AAP 0.5.0 card shape
+> (`aap_version`, `autonomy_envelope`, `audit_commitment`). The card has moved
+> to the unified / ADR-039 shape above: `autonomy_envelope` → `autonomy`,
+> `audit_commitment` → `audit`, `aap_version` → `card_version`, plus the
+> top-level `autonomy_mode` / `integrity_mode` master switches and a required
+> `principal.identifier` when `principal.type != "unspecified"`. See the
+> [Alignment Card Schema](https://docs.mnemom.ai/specifications/alignment-card-schema).
+
 ### AP-Trace
 
 An audit log entry recording each decision:
@@ -385,7 +400,7 @@ AAP aligns with and supports compliance for the following international standard
 | **[IEEE 7001-2021](https://standards.ieee.org/ieee/7001/6929/)** — Transparency of Autonomous Systems | AAP's core design goal — making agent decisions observable — directly implements IEEE 7001 transparency requirements |
 | **[IEEE 3152-2024](https://standards.ieee.org/ieee/3152/11718/)** — Transparent Human and Machine Agency Identification | Alignment Card `agent_id`, `principal` block, and relationship types map to IEEE 3152 agency identification |
 | **[Singapore IMDA Model AI Governance Framework for Agentic AI](https://www.imda.gov.sg/-/media/imda/files/about/emerging-tech-and-research/artificial-intelligence/mgf-for-agentic-ai.pdf)** (Jan 2026) | Alignment Card + Value Coherence Handshake address IMDA's agentic AI governance principles for multi-agent coordination |
-| **[EU AI Act Article 50](https://artificialintelligenceact.eu/article/50/)** — Transparency Obligations (enforcement Aug 2026) | Alignment Card `principal` + disclosure fields, AP-Trace structured audit trails, and `audit_commitment.retention_days` support Article 50 compliance. See [EU AI Act Compliance Guide](https://docs.mnemom.ai/guides/eu-compliance) |
+| **[EU AI Act Article 50](https://artificialintelligenceact.eu/article/50/)** — Transparency Obligations (enforcement Aug 2026) | Alignment Card `principal` + disclosure fields, AP-Trace structured audit trails, and `audit.retention_days` support Article 50 compliance. See [EU AI Act Compliance Guide](https://docs.mnemom.ai/guides/eu-compliance) |
 
 ## Contributing
 

{agent_alignment_protocol-0.5.0 → agent_alignment_protocol-2.0.0}/README.md

@@ -6,7 +6,7 @@
 [![PyPI](https://img.shields.io/pypi/v/agent-alignment-protocol.svg)](https://pypi.org/project/agent-alignment-protocol/)
 [![npm](https://img.shields.io/npm/v/@mnemom/agent-alignment-protocol.svg)](https://www.npmjs.com/package/@mnemom/agent-alignment-protocol)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
-[![Spec](https://img.shields.io/badge/spec-v0.4.0-green.svg)](https://docs.mnemom.ai/protocols/aap/specification)
+[![Spec](https://img.shields.io/badge/spec-v1.0.0-green.svg)](https://docs.mnemom.ai/protocols/aap/specification)
 
 **A transparency protocol for autonomous agents.**
 
@@ -71,21 +71,27 @@ As agent capabilities become symmetric—equal access to information, equal reas
 
 ### Alignment Card
 
-A structured declaration of an agent's alignment posture:
+A structured declaration of an agent's alignment posture, in the unified /
+ADR-039 shape accepted by `mnemom card validate` and the Mnemom platform:
 
 ```json
 {
-  "aap_version": "0.1.0",
+  "card_version": "unified/2026-04-26",
+  "card_id": "ac-my-agent-001",
   "agent_id": "did:web:my-agent.example.com",
+  "issued_at": "2026-04-26T00:00:00Z",
+  "autonomy_mode": "enforce",
+  "integrity_mode": "enforce",
   "principal": {
     "type": "human",
+    "identifier": "did:web:user.example.com",
     "relationship": "delegated_authority"
   },
   "values": {
     "declared": ["principal_benefit", "transparency", "minimal_data"],
     "conflicts_with": ["deceptive_marketing", "hidden_fees"]
   },
-  "autonomy_envelope": {
+  "autonomy": {
     "bounded_actions": ["search", "compare", "recommend"],
     "escalation_triggers": [
       {
@@ -96,14 +102,23 @@ A structured declaration of an agent's alignment posture:
     ],
     "forbidden_actions": ["share_credentials", "subscribe_to_services"]
   },
-  "audit_commitment": {
+  "audit": {
     "trace_format": "ap-trace-v1",
     "retention_days": 90,
-    "queryable": true
+    "queryable": true,
+    "query_endpoint": "https://my-agent.example.com/api/traces"
   }
 }
 ```
 
+> **Migration note (v2.0.0):** earlier releases used the AAP 0.5.0 card shape
+> (`aap_version`, `autonomy_envelope`, `audit_commitment`). The card has moved
+> to the unified / ADR-039 shape above: `autonomy_envelope` → `autonomy`,
+> `audit_commitment` → `audit`, `aap_version` → `card_version`, plus the
+> top-level `autonomy_mode` / `integrity_mode` master switches and a required
+> `principal.identifier` when `principal.type != "unspecified"`. See the
+> [Alignment Card Schema](https://docs.mnemom.ai/specifications/alignment-card-schema).
+
 ### AP-Trace
 
 An audit log entry recording each decision:
@@ -345,7 +360,7 @@ AAP aligns with and supports compliance for the following international standard
 | **[IEEE 7001-2021](https://standards.ieee.org/ieee/7001/6929/)** — Transparency of Autonomous Systems | AAP's core design goal — making agent decisions observable — directly implements IEEE 7001 transparency requirements |
 | **[IEEE 3152-2024](https://standards.ieee.org/ieee/3152/11718/)** — Transparent Human and Machine Agency Identification | Alignment Card `agent_id`, `principal` block, and relationship types map to IEEE 3152 agency identification |
 | **[Singapore IMDA Model AI Governance Framework for Agentic AI](https://www.imda.gov.sg/-/media/imda/files/about/emerging-tech-and-research/artificial-intelligence/mgf-for-agentic-ai.pdf)** (Jan 2026) | Alignment Card + Value Coherence Handshake address IMDA's agentic AI governance principles for multi-agent coordination |
-| **[EU AI Act Article 50](https://artificialintelligenceact.eu/article/50/)** — Transparency Obligations (enforcement Aug 2026) | Alignment Card `principal` + disclosure fields, AP-Trace structured audit trails, and `audit_commitment.retention_days` support Article 50 compliance. See [EU AI Act Compliance Guide](https://docs.mnemom.ai/guides/eu-compliance) |
+| **[EU AI Act Article 50](https://artificialintelligenceact.eu/article/50/)** — Transparency Obligations (enforcement Aug 2026) | Alignment Card `principal` + disclosure fields, AP-Trace structured audit trails, and `audit.retention_days` support Article 50 compliance. See [EU AI Act Compliance Guide](https://docs.mnemom.ai/guides/eu-compliance) |
 
 ## Contributing
 

{agent_alignment_protocol-0.5.0 → agent_alignment_protocol-2.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agent-alignment-protocol"
-version = "0.5.0"
+version = "2.0.0"
 description = "Agent Alignment Protocol - The missing alignment layer for the agent protocol stack"
 readme = "README.md"
 license = "Apache-2.0"
@@ -101,3 +101,10 @@ warn_unused_ignores = true
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 asyncio_mode = "auto"
+addopts = "--cov=src/aap --cov-report=xml --cov-report=term-missing"
+
+[tool.coverage.run]
+source = ["src/aap"]
+
+[tool.coverage.report]
+show_missing = true

{agent_alignment_protocol-0.5.0 → agent_alignment_protocol-2.0.0}/schemas/alignment-card.schema.json

@@ -1,7 +1,18 @@
 {
   "$defs": {
-    "AuditCommitment": {
-      "description": "Audit trail commitments (SPEC Section 4.7).",
+    "AlignmentMode": {
+      "description": "Master-switch mode shared by autonomy_mode and integrity_mode (unified / ADR-039).",
+      "enum": [
+        "off",
+        "observe",
+        "nudge",
+        "enforce"
+      ],
+      "title": "AlignmentMode",
+      "type": "string"
+    },
+    "Audit": {
+      "description": "Audit trail commitments (unified / ADR-039 §audit). Renamed from the legacy AAP 0.5.0 `audit_commitment`; semantics preserved.",
       "properties": {
         "trace_format": {
           "default": "ap-trace-v1",
@@ -11,22 +22,10 @@
         },
         "retention_days": {
           "description": "Minimum retention period in days",
-          "minimum": 1,
+          "minimum": 0,
           "title": "Retention Days",
           "type": "integer"
         },
-        "storage": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/AuditStorage"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Storage configuration"
-        },
         "queryable": {
           "description": "Whether traces can be queried externally",
           "title": "Queryable",
@@ -62,38 +61,11 @@
         "retention_days",
         "queryable"
       ],
-      "title": "AuditCommitment",
+      "title": "Audit",
       "type": "object"
     },
-    "AuditStorage": {
-      "description": "Audit log storage configuration.",
-      "properties": {
-        "type": {
-          "$ref": "#/$defs/StorageType",
-          "description": "Storage type"
-        },
-        "location": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Storage endpoint or location",
-          "title": "Location"
-        }
-      },
-      "required": [
-        "type"
-      ],
-      "title": "AuditStorage",
-      "type": "object"
-    },
-    "AutonomyEnvelope": {
-      "description": "Autonomy bounds and escalation triggers (SPEC Section 4.5).",
+    "Autonomy": {
+      "description": "Autonomy bounds and escalation triggers (unified / ADR-039 §autonomy). Renamed from the legacy AAP 0.5.0 `autonomy_envelope`; semantics preserved.",
       "properties": {
         "bounded_actions": {
           "description": "Actions permitted without escalation",
@@ -141,17 +113,16 @@
         }
       },
       "required": [
-        "bounded_actions",
-        "escalation_triggers"
+        "bounded_actions"
       ],
-      "title": "AutonomyEnvelope",
+      "title": "Autonomy",
       "type": "object"
     },
     "EscalationTrigger": {
-      "description": "Condition that triggers escalation (SPEC Section 4.5).",
+      "description": "Condition that triggers escalation (unified / ADR-039 §autonomy).",
       "properties": {
         "condition": {
-          "description": "Condition expression (see SPEC Section 4.6)",
+          "description": "Condition expression",
           "title": "Condition",
           "type": "string"
         },
@@ -205,7 +176,7 @@
       "type": "object"
     },
     "Principal": {
-      "description": "Principal relationship declaration (SPEC Section 4.3).",
+      "description": "Principal relationship declaration (unified / ADR-039 §principal).",
       "properties": {
         "type": {
           "$ref": "#/$defs/PrincipalType",
@@ -221,7 +192,7 @@
             }
           ],
           "default": null,
-          "description": "Principal identifier (DID, email, org ID)",
+          "description": "Principal identifier (DID, email, org ID). Required when type != 'unspecified'.",
           "title": "Identifier"
         },
         "relationship": {
@@ -270,16 +241,6 @@
       "title": "RelationshipType",
       "type": "string"
     },
-    "StorageType": {
-      "description": "Audit log storage type.",
-      "enum": [
-        "local",
-        "remote",
-        "distributed"
-      ],
-      "title": "StorageType",
-      "type": "string"
-    },
     "TamperEvidence": {
       "description": "Tamper-evidence mechanism for audit logs.",
       "enum": [
@@ -301,12 +262,20 @@
       "type": "string"
     },
     "ValueDefinition": {
-      "description": "Definition of a custom value.",
+      "description": "Definition of a custom value (unified / ADR-039 §values).",
       "properties": {
         "name": {
-          "description": "Human-readable name",
-          "title": "Name",
-          "type": "string"
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Human-readable name (optional)",
+          "title": "Name"
         },
         "description": {
           "description": "What this value means operationally",
@@ -315,20 +284,19 @@
         },
         "priority": {
           "default": 0,
-          "description": "Priority for lexicographic ordering (higher = more important)",
+          "description": "Priority for lexicographic/weighted ordering (higher = more important)",
           "title": "Priority",
-          "type": "integer"
+          "type": "number"
         }
       },
       "required": [
-        "name",
         "description"
       ],
       "title": "ValueDefinition",
       "type": "object"
     },
     "Values": {
-      "description": "Value declarations (SPEC Section 4.4).",
+      "description": "Value declarations (unified / ADR-039 §values).",
       "properties": {
         "declared": {
           "description": "List of value identifiers",
@@ -390,12 +358,13 @@
       "type": "object"
     }
   },
-  "description": "Alignment Card \u2014 Agent alignment declaration (SPEC Section 4).\n\nA structured document declaring an agent's alignment posture. It MUST be\nmachine-readable (JSON) and SHOULD be human-readable.\n\nExample:\n    card = AlignmentCard(\n        aap_version=\"0.1.0\",\n        card_id=\"ac-12345\",\n        agent_id=\"did:web:agent.example.com\",\n        issued_at=datetime.utcnow(),\n        principal=Principal(type=PrincipalType.HUMAN, relationship=RelationshipType.DELEGATED_AUTHORITY),\n        values=Values(declared=[\"principal_benefit\", \"transparency\"]),\n        autonomy_envelope=AutonomyEnvelope(\n            bounded_actions=[\"search\", \"recommend\"],\n            escalation_triggers=[\n                EscalationTrigger(\n                    condition='action_type == \"purchase\"',\n                    action=TriggerAction.ESCALATE,\n                    reason=\"Purchases require approval\",\n                )\n            ],\n        ),\n        audit_commitment=AuditCommitment(\n            retention_days=90,\n            queryable=True,\n            query_endpoint=\"https://agent.example.com/api/traces\",\n        ),\n    )",
+  "description": "Alignment Card — Agent alignment declaration (unified / ADR-039).\n\nA structured document declaring an agent's alignment posture. It MUST be\nmachine-readable (JSON) and SHOULD be human-readable. This is the unified\ncard shape accepted by `mnemom card validate` and the Mnemom platform;\nit renames the legacy AAP 0.5.0 `autonomy_envelope`→`autonomy` and\n`audit_commitment`→`audit` and adds the top-level master switches\n`autonomy_mode` + `integrity_mode`. Semantics are preserved.\n\nExample:\n    card = AlignmentCard(\n        card_version=\"unified/2026-04-26\",\n        card_id=\"ac-12345\",\n        agent_id=\"did:web:agent.example.com\",\n        issued_at=datetime.now(timezone.utc),\n        autonomy_mode=AlignmentMode.OBSERVE,\n        integrity_mode=AlignmentMode.OBSERVE,\n        principal=Principal(\n            type=PrincipalType.HUMAN,\n            identifier=\"did:web:user.example.com\",\n            relationship=RelationshipType.DELEGATED_AUTHORITY,\n        ),\n        values=Values(declared=[\"principal_benefit\", \"transparency\"]),\n        autonomy=Autonomy(\n            bounded_actions=[\"search\", \"recommend\"],\n            escalation_triggers=[\n                EscalationTrigger(\n                    condition='action_type == \"purchase\"',\n                    action=TriggerAction.ESCALATE,\n                    reason=\"Purchases require approval\",\n                )\n            ],\n        ),\n        audit=Audit(\n            retention_days=90,\n            queryable=True,\n            query_endpoint=\"https://agent.example.com/api/traces\",\n        ),\n    )",
   "properties": {
-    "aap_version": {
-      "default": "0.1.0",
-      "description": "AAP specification version",
-      "title": "Aap Version",
+    "card_version": {
+      "default": "unified/2026-04-26",
+      "description": "Unified alignment-card schema version (date-anchored identifier)",
+      "pattern": "^unified/\\d{4}-\\d{2}-\\d{2}$",
+      "title": "Card Version",
       "type": "string"
     },
     "card_id": {
@@ -428,6 +397,14 @@
       "description": "When this card expires",
       "title": "Expires At"
     },
+    "autonomy_mode": {
+      "$ref": "#/$defs/AlignmentMode",
+      "description": "Master switch for the action-policing pipeline (off | observe | nudge | enforce)"
+    },
+    "integrity_mode": {
+      "$ref": "#/$defs/AlignmentMode",
+      "description": "Master switch for the values/conscience pipeline (off | observe | nudge | enforce)"
+    },
     "principal": {
       "$ref": "#/$defs/Principal",
       "description": "Principal relationship declaration"
@@ -436,12 +413,12 @@
       "$ref": "#/$defs/Values",
       "description": "Value declarations"
     },
-    "autonomy_envelope": {
-      "$ref": "#/$defs/AutonomyEnvelope",
+    "autonomy": {
+      "$ref": "#/$defs/Autonomy",
       "description": "Autonomy bounds and escalation triggers"
     },
-    "audit_commitment": {
-      "$ref": "#/$defs/AuditCommitment",
+    "audit": {
+      "$ref": "#/$defs/Audit",
       "description": "Audit trail commitments"
     },
     "extensions": {
@@ -463,13 +440,15 @@
     "card_id",
     "agent_id",
     "issued_at",
+    "autonomy_mode",
+    "integrity_mode",
     "principal",
     "values",
-    "autonomy_envelope",
-    "audit_commitment"
+    "autonomy",
+    "audit"
   ],
   "title": "AlignmentCard",
   "type": "object",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://aap.dev/schemas/alignment-card-v1.json"
-}
+  "$id": "https://aap.dev/schemas/alignment-card-unified.json"
+}

{agent_alignment_protocol-0.5.0 → agent_alignment_protocol-2.0.0}/src/aap/__init__.py

@@ -36,11 +36,17 @@ Quick Start:
 See docs/SPEC.md for the full protocol specification.
 """
 
-__version__ = "0.4.0"
+from importlib import metadata as _metadata
+
+try:
+    # Single source of truth: the installed distribution version (pyproject.toml).
+    __version__ = _metadata.version("agent-alignment-protocol")
+except _metadata.PackageNotFoundError:  # pragma: no cover - editable/source tree fallback
+    __version__ = "2.0.0"
 
 # EU AI Act compliance presets
 from aap.compliance import (
-    EU_COMPLIANCE_AUDIT_COMMITMENT,
+    EU_COMPLIANCE_AUDIT,
     EU_COMPLIANCE_EXTENSIONS,
     EU_COMPLIANCE_VALUES,
 )
@@ -53,10 +59,11 @@ from aap.schemas import (
     AlignmentCard,
     AlignmentCardRequest,
     AlignmentCardResponse,
+    AlignmentMode,
     Alternative,
     APTrace,
-    AuditCommitment,
-    AutonomyEnvelope,
+    Audit,
+    Autonomy,
     CoherenceResultMessage,
     Decision,
     Escalation,
@@ -148,16 +155,17 @@ __all__ = [
     "DriftAnalysis",
     "DriftDirection",
     "DriftIndicator",
-    # Alignment Card
+    # Alignment Card (unified / ADR-039)
     "AlignmentCard",
+    "AlignmentMode",
     "Principal",
     "PrincipalType",
     "RelationshipType",
     "Values",
-    "AutonomyEnvelope",
+    "Autonomy",
     "EscalationTrigger",
     "TriggerAction",
-    "AuditCommitment",
+    "Audit",
     # AP-Trace
     "APTrace",
     "Action",
@@ -174,7 +182,7 @@ __all__ = [
     "CoherenceResultMessage",
     "ProposedCollaboration",
     # EU AI Act Compliance
-    "EU_COMPLIANCE_AUDIT_COMMITMENT",
+    "EU_COMPLIANCE_AUDIT",
     "EU_COMPLIANCE_EXTENSIONS",
     "EU_COMPLIANCE_VALUES",
 ]

{agent_alignment_protocol-0.5.0 → agent_alignment_protocol-2.0.0}/src/aap/cli/main.py

@@ -193,21 +193,25 @@ def _create_card_from_values(
     agent_id: str | None = None,
     card_id: str | None = None,
 ) -> dict[str, Any]:
-    """Create a minimal Alignment Card from a list of values."""
+    """Create a minimal Alignment Card (unified / ADR-039) from a list of values."""
     now = datetime.now(timezone.utc)
+    resolved_agent_id = agent_id or f"agent-{uuid.uuid4().hex[:8]}"
     return {
-        "aap_version": "0.1.0",
+        "card_version": "unified/2026-04-26",
         "card_id": card_id or f"ac-{uuid.uuid4().hex[:12]}",
-        "agent_id": agent_id or f"agent-{uuid.uuid4().hex[:8]}",
+        "agent_id": resolved_agent_id,
         "issued_at": now.isoformat(),
+        "autonomy_mode": "observe",
+        "integrity_mode": "observe",
         "principal": {
             "type": "human",
+            "identifier": resolved_agent_id,
             "relationship": "delegated_authority",
         },
         "values": {
             "declared": value_list,
         },
-        "autonomy_envelope": {
+        "autonomy": {
             "bounded_actions": ["search", "recommend", "compare", "summarize", "respond"],
             "escalation_triggers": [
                 {
@@ -222,7 +226,7 @@ def _create_card_from_values(
                 },
             ],
         },
-        "audit_commitment": {
+        "audit": {
             "trace_format": "ap-trace-v1",
             "retention_days": 90,
             "queryable": False,
@@ -268,6 +272,13 @@ def _create_card_interactive(agent_id: str | None = None, card_id: str | None =
         default="human",
     )
 
+    # Principal identifier (required by the unified schema when type != unspecified)
+    default_identifier = agent_id or f"agent-{uuid.uuid4().hex[:8]}"
+    principal_identifier = click.prompt(
+        "Principal identifier (DID, email, org ID)",
+        default=default_identifier,
+    )
+
     # Relationship type
     relationship = click.prompt(
         "Relationship type",
@@ -291,18 +302,21 @@ def _create_card_interactive(agent_id: str | None = None, card_id: str | None =
 
     now = datetime.now(timezone.utc)
     return {
-        "aap_version": "0.1.0",
+        "card_version": "unified/2026-04-26",
         "card_id": card_id or f"ac-{uuid.uuid4().hex[:12]}",
-        "agent_id": agent_id or f"agent-{uuid.uuid4().hex[:8]}",
+        "agent_id": agent_id or default_identifier,
         "issued_at": now.isoformat(),
+        "autonomy_mode": "observe",
+        "integrity_mode": "observe",
         "principal": {
             "type": principal_type,
+            "identifier": principal_identifier,
             "relationship": relationship,
         },
         "values": {
             "declared": selected_values,
         },
-        "autonomy_envelope": {
+        "autonomy": {
             "bounded_actions": bounded_actions,
             "escalation_triggers": [
                 {
@@ -312,7 +326,7 @@ def _create_card_interactive(agent_id: str | None = None, card_id: str | None =
                 },
             ],
         },
-        "audit_commitment": {
+        "audit": {
             "trace_format": "ap-trace-v1",
             "retention_days": retention_days,
             "queryable": False,

{agent_alignment_protocol-0.5.0 → agent_alignment_protocol-2.0.0}/src/aap/compliance.py

@@ -6,14 +6,14 @@ transparency obligations. Spread them into your AlignmentCard fields.
 
 Usage:
     from aap.compliance import (
-        EU_COMPLIANCE_AUDIT_COMMITMENT,
+        EU_COMPLIANCE_AUDIT,
         EU_COMPLIANCE_EXTENSIONS,
         EU_COMPLIANCE_VALUES,
     )
 
     card = AlignmentCard(
         ...,
-        audit_commitment=AuditCommitment(**EU_COMPLIANCE_AUDIT_COMMITMENT),
+        audit=Audit(**EU_COMPLIANCE_AUDIT),
         values=Values(declared=EU_COMPLIANCE_VALUES, ...),
         extensions=EU_COMPLIANCE_EXTENSIONS,
     )
@@ -26,7 +26,8 @@ qualified legal counsel for your specific compliance obligations.
 from __future__ import annotations
 
 # Audit commitment values that satisfy Article 50(4) audit trail requirements.
-EU_COMPLIANCE_AUDIT_COMMITMENT: dict = {
+# Spread into the unified card's `audit` section (Audit(**EU_COMPLIANCE_AUDIT)).
+EU_COMPLIANCE_AUDIT: dict = {
     "retention_days": 90,
     "queryable": True,
     "query_endpoint": "https://audit.example.com/traces",

{agent_alignment_protocol-0.5.0 → agent_alignment_protocol-2.0.0}/src/aap/schemas/__init__.py

@@ -13,15 +13,19 @@ All models support:
 Example:
     from aap.schemas import AlignmentCard, APTrace
 
-    # Create an Alignment Card
+    # Create an Alignment Card (unified / ADR-039 shape)
     card = AlignmentCard(
         card_id="ac-12345",
         agent_id="did:web:agent.example.com",
-        issued_at=datetime.utcnow(),
-        principal=Principal(type=PrincipalType.HUMAN, relationship=RelationshipType.DELEGATED_AUTHORITY),
+        issued_at=datetime.now(timezone.utc),
+        principal=Principal(
+            type=PrincipalType.HUMAN,
+            identifier="did:web:user.example.com",
+            relationship=RelationshipType.DELEGATED_AUTHORITY,
+        ),
         values=Values(declared=["principal_benefit", "transparency"]),
-        autonomy_envelope=AutonomyEnvelope(...),
-        audit_commitment=AuditCommitment(...),
+        autonomy=Autonomy(...),
+        audit=Audit(...),
     )
 
     # Serialize to JSON
@@ -33,16 +37,15 @@ Example:
 
 from aap.schemas.alignment_card import (
     AlignmentCard,
-    AuditCommitment,
-    AuditStorage,
-    AutonomyEnvelope,
+    AlignmentMode,
+    Audit,
+    Autonomy,
     EscalationTrigger,
     HierarchyType,
     MonetaryValue,
     Principal,
     PrincipalType,
     RelationshipType,
-    StorageType,
     TamperEvidence,
     TriggerAction,
     ValueDefinition,
@@ -61,6 +64,7 @@ from aap.schemas.ap_trace import (
     PrincipalResponse,
     TraceContext,
     TriggerCheck,
+    ValueScore,
 )
 from aap.schemas.value_coherence import (
     AlignmentCardRequest,
@@ -80,21 +84,20 @@ from aap.schemas.value_coherence import (
 )
 
 __all__ = [
-    # Alignment Card (SPEC Section 4)
+    # Alignment Card (unified / ADR-039)
     "AlignmentCard",
+    "AlignmentMode",
     "Principal",
     "PrincipalType",
     "RelationshipType",
     "Values",
     "ValueDefinition",
     "HierarchyType",
-    "AutonomyEnvelope",
+    "Autonomy",
     "EscalationTrigger",
     "TriggerAction",
     "MonetaryValue",
-    "AuditCommitment",
-    "AuditStorage",
-    "StorageType",
+    "Audit",
     "TamperEvidence",
     # AP-Trace (SPEC Section 5)
     "APTrace",
@@ -109,6 +112,7 @@ __all__ = [
     "TriggerCheck",
     "PrincipalResponse",
     "TraceContext",
+    "ValueScore",
     # Value Coherence (SPEC Section 6)
     "AlignmentCardRequest",
     "AlignmentCardResponse",

{agent_alignment_protocol-0.5.0 → agent_alignment_protocol-2.0.0}/src/aap/schemas/alignment_card.py

@@ -1,13 +1,21 @@
-"""Alignment Card schema — Agent alignment declaration.
+"""Alignment Card schema — Agent alignment declaration (unified / ADR-039).
 
-Defines the Alignment Card structure per SPEC Section 4. An Alignment Card
-is a structured document declaring an agent's alignment posture:
+Defines the unified Alignment Card structure accepted by the Mnemom platform
+and `mnemom card validate`. An Alignment Card is a structured document
+declaring an agent's alignment posture:
 - Principal relationship
 - Declared values
-- Autonomy envelope
-- Audit commitment
+- Autonomy bounds (`autonomy`)
+- Audit commitments (`audit`)
+- Two top-level master switches (`autonomy_mode`, `integrity_mode`)
 
-See SPEC.md Section 4 for complete specification.
+This is the unified shape. It renames the legacy AAP 0.5.0
+`autonomy_envelope`→`autonomy` and `audit_commitment`→`audit`, replaces
+`aap_version` with the date-anchored `card_version`, and adds the top-level
+master switches. Semantics are preserved; the migration is largely a rename.
+
+See https://docs.mnemom.ai/specifications/alignment-card-schema for the
+normative reference.
 """
 
 from __future__ import annotations
@@ -18,6 +26,28 @@ from typing import Any
 
 from pydantic import BaseModel, Field, model_validator
 
+#: Current unified alignment-card schema version (date-anchored identifier).
+CARD_VERSION = "unified/2026-04-26"
+
+
+class AlignmentMode(str, Enum):
+    """Master-switch mode shared by ``autonomy_mode`` and ``integrity_mode``.
+
+    Strictest wins on composition: ``enforce > nudge > observe > off``.
+    """
+
+    OFF = "off"
+    """Pipeline disabled."""
+
+    OBSERVE = "observe"
+    """Log results; do not block."""
+
+    NUDGE = "nudge"
+    """Inject advisory annotation; do not block."""
+
+    ENFORCE = "enforce"
+    """Block violations and escalate."""
+
 
 class PrincipalType(str, Enum):
     """Type of principal the agent serves."""
@@ -42,13 +72,13 @@ class RelationshipType(str, Enum):
 
 
 class Principal(BaseModel):
-    """Principal relationship declaration (SPEC Section 4.3)."""
+    """Principal relationship declaration (unified / ADR-039 §principal)."""
 
     type: PrincipalType = Field(
         ..., description="Type of principal"
     )
     identifier: str | None = Field(
-        None, description="Principal identifier (DID, email, org ID)"
+        None, description="Principal identifier (DID, email, org ID). Required when type != 'unspecified'."
     )
     relationship: RelationshipType = Field(
         ..., description="Nature of authority delegation"
@@ -57,6 +87,15 @@ class Principal(BaseModel):
         None, description="Endpoint for escalation notifications"
     )
 
+    @model_validator(mode="after")
+    def identifier_required_when_typed(self) -> Principal:
+        """`identifier` is required when `type` is not 'unspecified' (ADR-039)."""
+        if self.type != PrincipalType.UNSPECIFIED and not self.identifier:
+            raise ValueError(
+                "principal.identifier is required when principal.type is not 'unspecified'"
+            )
+        return self
+
 
 class HierarchyType(str, Enum):
     """How value conflicts are resolved."""
@@ -72,17 +111,23 @@ class HierarchyType(str, Enum):
 
 
 class ValueDefinition(BaseModel):
-    """Definition of a custom value."""
+    """Definition of a custom value (unified / ADR-039 §values).
+
+    Per the unified spec a definition carries a ``description`` and optional
+    ``priority``; ``name`` is optional (the value's identifier is the
+    ``definitions`` map key).
+    """
 
-    name: str = Field(..., description="Human-readable name")
+    name: str | None = Field(None, description="Human-readable name (optional)")
     description: str = Field(..., description="What this value means operationally")
-    priority: int = Field(
-        default=0, description="Priority for lexicographic ordering (higher = more important)"
+    priority: float = Field(
+        default=0,
+        description="Priority for lexicographic/weighted ordering (higher = more important)",
     )
 
 
 class Values(BaseModel):
-    """Value declarations (SPEC Section 4.4)."""
+    """Value declarations (unified / ADR-039 §values)."""
 
     declared: list[str] = Field(
         ..., description="List of value identifiers"
@@ -125,10 +170,10 @@ class TriggerAction(str, Enum):
 
 
 class EscalationTrigger(BaseModel):
-    """Condition that triggers escalation (SPEC Section 4.5)."""
+    """Condition that triggers escalation (unified / ADR-039 §autonomy)."""
 
     condition: str = Field(
-        ..., description="Condition expression (see SPEC Section 4.6)"
+        ..., description="Condition expression"
     )
     action: TriggerAction = Field(
         ..., description="Action to take when trigger matches"
@@ -145,14 +190,19 @@ class MonetaryValue(BaseModel):
     currency: str = Field(default="USD", description="ISO 4217 currency code")
 
 
-class AutonomyEnvelope(BaseModel):
-    """Autonomy bounds and escalation triggers (SPEC Section 4.5)."""
+class Autonomy(BaseModel):
+    """Autonomy bounds and escalation triggers (unified / ADR-039 §autonomy).
+
+    Renamed from the legacy AAP 0.5.0 ``autonomy_envelope``; semantics
+    preserved. ``escalation_triggers`` is now optional (defaults to an empty
+    list) to match the unified spec, where only ``bounded_actions`` is required.
+    """
 
     bounded_actions: list[str] = Field(
         ..., description="Actions permitted without escalation"
     )
     escalation_triggers: list[EscalationTrigger] = Field(
-        ..., description="Conditions requiring escalation"
+        default_factory=list, description="Conditions requiring escalation"
     )
     max_autonomous_value: MonetaryValue | None = Field(
         None, description="Maximum transaction value without escalation"
@@ -161,13 +211,17 @@ class AutonomyEnvelope(BaseModel):
         None, description="Actions never permitted"
     )
 
-
-class StorageType(str, Enum):
-    """Audit log storage type."""
-
-    LOCAL = "local"
-    REMOTE = "remote"
-    DISTRIBUTED = "distributed"
+    @model_validator(mode="after")
+    def bounded_and_forbidden_disjoint(self) -> Autonomy:
+        """`bounded_actions` and `forbidden_actions` must be disjoint (ADR-039)."""
+        if self.forbidden_actions:
+            overlap = set(self.bounded_actions) & set(self.forbidden_actions)
+            if overlap:
+                raise ValueError(
+                    "autonomy.bounded_actions and forbidden_actions must be disjoint; "
+                    f"both contain: {', '.join(sorted(overlap))}"
+                )
+        return self
 
 
 class TamperEvidence(str, Enum):
@@ -178,24 +232,19 @@ class TamperEvidence(str, Enum):
     MERKLE = "merkle"
 
 
-class AuditStorage(BaseModel):
-    """Audit log storage configuration."""
-
-    type: StorageType = Field(..., description="Storage type")
-    location: str | None = Field(None, description="Storage endpoint or location")
+class Audit(BaseModel):
+    """Audit trail commitments (unified / ADR-039 §audit).
 
-
-class AuditCommitment(BaseModel):
-    """Audit trail commitments (SPEC Section 4.7)."""
+    Renamed from the legacy AAP 0.5.0 ``audit_commitment``; semantics
+    preserved. The legacy ``storage`` sub-object is no longer part of the
+    unified shape (the platform validator rejects ``audit.storage``).
+    """
 
     trace_format: str = Field(
         default="ap-trace-v1", description="Trace format identifier"
     )
     retention_days: int = Field(
-        ..., ge=1, description="Minimum retention period in days"
-    )
-    storage: AuditStorage | None = Field(
-        None, description="Storage configuration"
+        ..., ge=0, description="Minimum retention period in days"
     )
     queryable: bool = Field(
         ..., description="Whether traces can be queried externally"
@@ -208,7 +257,7 @@ class AuditCommitment(BaseModel):
     )
 
     @model_validator(mode="after")
-    def queryable_requires_endpoint(self) -> AuditCommitment:
+    def queryable_requires_endpoint(self) -> Audit:
         """If queryable is true, query_endpoint is required."""
         if self.queryable and not self.query_endpoint:
             raise ValueError("query_endpoint is required when queryable is true")
@@ -216,20 +265,27 @@ class AuditCommitment(BaseModel):
 
 
 class AlignmentCard(BaseModel):
-    """Alignment Card — Agent alignment declaration (SPEC Section 4).
+    """Alignment Card — Agent alignment declaration (unified / ADR-039).
 
     A structured document declaring an agent's alignment posture. It MUST be
-    machine-readable (JSON) and SHOULD be human-readable.
+    machine-readable (JSON) and SHOULD be human-readable. This is the unified
+    card shape accepted by `mnemom card validate` and the Mnemom platform.
 
     Example:
         card = AlignmentCard(
-            aap_version="0.1.0",
+            card_version="unified/2026-04-26",
             card_id="ac-12345",
             agent_id="did:web:agent.example.com",
-            issued_at=datetime.utcnow(),
-            principal=Principal(type=PrincipalType.HUMAN, relationship=RelationshipType.DELEGATED_AUTHORITY),
+            issued_at=datetime.now(timezone.utc),
+            autonomy_mode=AlignmentMode.OBSERVE,
+            integrity_mode=AlignmentMode.OBSERVE,
+            principal=Principal(
+                type=PrincipalType.HUMAN,
+                identifier="did:web:user.example.com",
+                relationship=RelationshipType.DELEGATED_AUTHORITY,
+            ),
             values=Values(declared=["principal_benefit", "transparency"]),
-            autonomy_envelope=AutonomyEnvelope(
+            autonomy=Autonomy(
                 bounded_actions=["search", "recommend"],
                 escalation_triggers=[
                     EscalationTrigger(
@@ -239,7 +295,7 @@ class AlignmentCard(BaseModel):
                     )
                 ],
             ),
-            audit_commitment=AuditCommitment(
+            audit=Audit(
                 retention_days=90,
                 queryable=True,
                 query_endpoint="https://agent.example.com/api/traces",
@@ -247,8 +303,9 @@ class AlignmentCard(BaseModel):
         )
     """
 
-    aap_version: str = Field(
-        default="0.1.0", description="AAP specification version"
+    card_version: str = Field(
+        default=CARD_VERSION,
+        description="Unified alignment-card schema version (date-anchored identifier)",
     )
     card_id: str = Field(
         ..., description="Unique identifier for this card (UUID or URI)"
@@ -262,16 +319,24 @@ class AlignmentCard(BaseModel):
     expires_at: datetime | None = Field(
         None, description="When this card expires"
     )
+    autonomy_mode: AlignmentMode = Field(
+        default=AlignmentMode.OBSERVE,
+        description="Master switch for the action-policing pipeline",
+    )
+    integrity_mode: AlignmentMode = Field(
+        default=AlignmentMode.OBSERVE,
+        description="Master switch for the values/conscience pipeline",
+    )
     principal: Principal = Field(
         ..., description="Principal relationship declaration"
     )
     values: Values = Field(
         ..., description="Value declarations"
     )
-    autonomy_envelope: AutonomyEnvelope = Field(
+    autonomy: Autonomy = Field(
         ..., description="Autonomy bounds and escalation triggers"
     )
-    audit_commitment: AuditCommitment = Field(
+    audit: Audit = Field(
         ..., description="Audit trail commitments"
     )
     extensions: dict[str, Any] | None = Field(
@@ -288,10 +353,18 @@ class AlignmentCard(BaseModel):
         return cls.model_validate(data)
 
     def is_expired(self) -> bool:
-        """Check if the card has expired."""
+        """Check if the card has expired.
+
+        Handles both timezone-aware and naive ``expires_at`` values: the
+        comparison ``now`` is built to match the awareness of ``expires_at``.
+        """
         if self.expires_at is None:
             return False
-        return datetime.utcnow() > self.expires_at
+        if self.expires_at.tzinfo is None:
+            # Naive expiry — compare against naive UTC now.
+            return datetime.utcnow() > self.expires_at
+        # Aware expiry — compare against aware now in the same tz.
+        return datetime.now(self.expires_at.tzinfo) > self.expires_at
 
     def has_value(self, value: str) -> bool:
         """Check if a value is declared."""
@@ -299,8 +372,8 @@ class AlignmentCard(BaseModel):
 
     def is_action_bounded(self, action: str) -> bool:
         """Check if an action is in the bounded actions list."""
-        return action in self.autonomy_envelope.bounded_actions
+        return action in self.autonomy.bounded_actions
 
     def is_action_forbidden(self, action: str) -> bool:
         """Check if an action is forbidden."""
-        return action in (self.autonomy_envelope.forbidden_actions or [])
+        return action in (self.autonomy.forbidden_actions or [])

{agent_alignment_protocol-0.5.0 → agent_alignment_protocol-2.0.0}/src/aap/schemas/ap_trace.py

@@ -14,7 +14,7 @@ from __future__ import annotations
 
 from datetime import datetime
 from enum import Enum
-from typing import Any
+from typing import Any, Literal
 
 from pydantic import BaseModel, Field, model_validator
 
@@ -87,6 +87,21 @@ class Alternative(BaseModel):
     )
 
 
+class ValueScore(BaseModel):
+    """Per-value score from V2 observer scoring (Phase 3.3)."""
+
+    score: Literal["on_track", "off_track", "not_applicable"] = Field(
+        ..., description="Score against the catalog entry's observer_signals rubric"
+    )
+    rationale: str = Field(
+        ...,
+        description=(
+            "Free-form rationale citing one of the catalog "
+            "observer_signals patterns"
+        ),
+    )
+
+
 class Decision(BaseModel):
     """Decision process record (SPEC Section 5.5)."""
 
@@ -105,6 +120,18 @@ class Decision(BaseModel):
     confidence: float | None = Field(
         None, ge=0.0, le=1.0, description="Decision confidence"
     )
+    value_scores: dict[str, ValueScore] | None = Field(
+        None,
+        description=(
+            "Per-declared-value score against the alignment card's catalog "
+            "observer_signals (Phase 3.3 V2 observer surface). Optional — "
+            "present when the card declares catalog values with "
+            "observer_signals defined; absent on V1 observer output. Keyed "
+            "by catalog value id. `values_applied` is derived from "
+            "`value_scores` entries whose score is 'on_track' to preserve "
+            "the V1 surface contract for downstream consumers."
+        ),
+    )
 
     @model_validator(mode="after")
     def selected_must_be_in_alternatives(self) -> Decision:

{agent_alignment_protocol-0.5.0 → agent_alignment_protocol-2.0.0}/src/aap/verification/api.py

@@ -48,6 +48,24 @@ from aap.verification.models import (
 )
 
 
+def _card_autonomy(card: dict[str, Any]) -> dict[str, Any]:
+    """Read the autonomy section from a card.
+
+    Prefers the unified / ADR-039 ``autonomy`` key, falling back to the legacy
+    AAP 0.5.0 ``autonomy_envelope`` for interop with older cards.
+    """
+    return card.get("autonomy") or card.get("autonomy_envelope") or {}
+
+
+def _card_audit(card: dict[str, Any]) -> dict[str, Any]:
+    """Read the audit section from a card.
+
+    Prefers the unified / ADR-039 ``audit`` key, falling back to the legacy
+    AAP 0.5.0 ``audit_commitment`` for interop with older cards.
+    """
+    return card.get("audit") or card.get("audit_commitment") or {}
+
+
 def action_matches_list(action_name: str, action_list: list[str]) -> bool:
     """Check if a (possibly compound) action name matches any entry in a list.
 
@@ -121,7 +139,7 @@ def verify_trace(
         raise ValueError("trace must contain 'decision.values_applied' field")
 
     # Warn if tamper_evidence is declared but not cryptographically enforced
-    tamper_evidence = (card.get("audit") or {}).get("commitment", {}).get("tamper_evidence")
+    tamper_evidence = _card_audit(card).get("tamper_evidence")
     if tamper_evidence in ("signed", "merkle"):
         import warnings as _warnings
         _warnings.warn(
@@ -164,8 +182,9 @@ def verify_trace(
                 trace_field="card.expires_at",
             ))
 
-    # Extract envelope for remaining checks
-    envelope = card.get("autonomy_envelope", {})
+    # Extract the autonomy section for remaining checks (unified `autonomy`,
+    # legacy `autonomy_envelope` fallback).
+    envelope = _card_autonomy(card)
     action = trace.get("action", {})
 
     # Check autonomy compliance
@@ -688,7 +707,8 @@ def _evaluate_condition(condition: str, trace: dict[str, Any]) -> bool:
             if isinstance(metadata, dict):
                 actual = metadata.get(field)
         if actual is None:
-            actual = (trace.get("action") or {}).get("parameters", {}).get(field)
+            params = (trace.get("action") or {}).get("parameters") or {}
+            actual = params.get(field)
         if actual is None:
             return False
 

{agent_alignment_protocol-0.5.0 → agent_alignment_protocol-2.0.0}/src/aap/verification/features.py

@@ -295,8 +295,9 @@ class FeatureExtractor:
         """
         features: dict[str, float] = {}
 
-        # Bounded action features
-        envelope = card.get("autonomy_envelope", {})
+        # Bounded action features (unified `autonomy`, legacy
+        # `autonomy_envelope` fallback for interop with older cards)
+        envelope = card.get("autonomy") or card.get("autonomy_envelope") or {}
         for action in envelope.get("bounded_actions", []):
             features[f"action_name:{action}"] = 1.0
 
@@ -315,8 +316,8 @@ class FeatureExtractor:
         if principal_type:
             features[f"principal_type:{principal_type}"] = 1.0
 
-        # Audit commitment features
-        audit = card.get("audit_commitment", {})
+        # Audit features (unified `audit`, legacy `audit_commitment` fallback)
+        audit = card.get("audit") or card.get("audit_commitment") or {}
         if audit.get("queryable"):
             features["audit:queryable"] = 1.0
         tamper_evidence = audit.get("tamper_evidence")