Adapters & Connectors

Connectors translate between external systems and ENTITY; they must not silently convert external possession/account state into ENTITY authority.

Connector responsibilities

• Authenticate to the external system using its own credentials.
• Resolve the ENTITY principal/authority separately.
• Normalize data into the applicable schema/profile.
• Capture source/provenance and evidence.
• Enforce rights/consent before mutation or use.
• Preserve external identifiers without treating them as sovereign Entity IDs unless explicitly bound.

Read vs write

A read connector can ingest evidence without receiving authority to modify source systems. A write connector requires explicit scoped authority for the target action.

Failure isolation

Connector failure should not corrupt canonical ENTITY state. Record partial/rejected operations and make retries idempotent where possible.