Source: docs/integration/privacy-and-retention.md

Privacy and retention policy for the integration MVP

This policy describes the minimum handling of data sent through Forgium. The

host application remains responsible for its own user notice, lawful basis,

access controls, and deletion obligations.

Data classes

ClassStored by ForgiumPurposeDefault retention
Message textConversation and message recordsGenerate and audit a reply30 days
Action metadataAction ID, capability ID/revision, status, expiry, subject IDs, hashesConfirmation and execution30 days after terminal state
Capability auditIDs, SHA-256 hashes, timing, HTTP status, stable error codesSecurity and operations90 days
CredentialsAES-GCM ciphertext onlyAuthenticate an endpointUntil revoked, then 30 days for deletion evidence
Signing materialPrivate key in the Worker secret store onlySign outbound contextManaged by key-rotation policy; never stored in D1

Bodies, bearer tokens, complete JWS values, and capability arguments are not

written to capability audit records. Staging fixtures use synthetic data only.

Access, deletion, and support

Access is limited to the authenticated host backend, the Forgium runtime for

execution, and authorized Operations/Security personnel for incident response.

Support access is time-limited, logged, and must use redacted identifiers.

The host application can request deletion of conversations, messages, action

records, credentials, and related audit records through the operational owner.

Deletion requests are acknowledged with scope, timestamp, requester, and

completion evidence. Legal holds or active incident investigations may delay

deletions; the requester receives the reason and expected review date.

Incidents

For suspected disclosure, the host application must revoke the endpoint token

and Forgium access bundle, preserve redacted evidence, and contact the

platform incident owner. Forgium Operations rotates affected credentials or

signing keys, reviews security events, and communicates impact and recovery

steps. Never include secrets or raw message bodies in an incident ticket.

This MVP policy requires Product, Legal, and Security approval before a

production access bundle is issued. Changes to retention, data classes, or

support access require a documented review.