Skip to main content

Compliance Documentation

Regulatory compliance mappings and controls for Aragora.

Table of Contents


Overview

Aragora is designed with privacy and security as core principles. This document maps Aragora's features to common regulatory frameworks.

Compliance Summary

FrameworkStatusNotes
GDPRSupportedFull data subject rights
SOC 2 Type IIMappableControls documented below
HIPAAPartialRequires BAA and additional config
EU AI ActSupportedRisk assessment available
CCPASupportedFull consumer rights
ISO 27001MappableControls align with Annex A

GDPR Compliance

Article Mapping

GDPR ArticleRequirementAragora Implementation
Art. 5Data minimizationOnly essential data collected
Art. 6Lawful basisConsent and legitimate interest tracking
Art. 7Consent conditionsExplicit opt-in, withdrawable consent
Art. 12-14TransparencyPrivacy policy, data usage disclosure
Art. 15Right of accessData export API
Art. 16Right to rectificationUser profile editing
Art. 17Right to erasureAccount deletion API
Art. 18Right to restrictionProcessing pause capability
Art. 20Data portabilityJSON/CSV export
Art. 25Privacy by designEncryption, access controls
Art. 30Records of processingAudit logging
Art. 32Security measuresSee SECURITY.md
Art. 33-34Breach notificationIncident response procedures

Data Subject Rights Implementation

Right of Access (Art. 15)

Users can export their data via the self-service API:

# Export all user data
GET /api/privacy/export
GET /api/v2/users/me/export?format=json

# CSV format
GET /api/privacy/export?format=csv

# Data inventory (categories collected)
GET /api/privacy/data-inventory

Exports include:

  • Profile information
  • Organization membership
  • OAuth provider links
  • User preferences
  • Audit log (90 days)
  • Usage summary

For manual requests: privacy@aragora.ai (processed within 30 days). See DSAR_WORKFLOW.md for detailed procedures.

Right to Erasure (Art. 17)

Users can delete their account via the self-service API:

# Delete account (requires password confirmation)
DELETE /api/privacy/account
DELETE /api/v2/users/me

# Request body
{
"password": "your_password",
"confirm": true,
"reason": "optional reason"
}

For manual requests: privacy@aragora.ai with subject "Account Deletion Request"

Deletion process:

  1. User profile anonymized (email, name replaced)
  2. OAuth provider links removed
  3. API keys revoked
  4. MFA data cleared
  5. Active sessions invalidated
  6. Audit logs: PII redacted (retained for compliance)
  7. Backups: marked for exclusion in next rotation

Data Portability (Art. 20)

# Export in machine-readable format
curl -X GET /api/v2/users/me/export?format=json \
-H "Authorization: Bearer $TOKEN"

# Alternative formats
?format=csv # CSV export
?format=xml # XML export
# Consent tracking in database
consent_record = {
"user_id": "uuid",
"consent_type": "marketing|analytics|third_party",
"granted": True,
"granted_at": "2026-01-13T10:00:00Z",
"ip_address": "hashed",
"version": "v2.1" # Policy version
}

Data Retention

Data TypeRetention PeriodLegal Basis
User accountsUntil deletionConsent
Debate contentIndefinite (anonymizable)Legitimate interest
Decision receipts7 years (configurable)Financial audit compliance
Audit logs1 yearLegal obligation
Access logs90 daysSecurity
Backup data14 daysLegitimate interest
Deleted user data30 days (soft delete)Recovery period

SOC 2 Controls

Trust Service Criteria Mapping

Security (Common Criteria)

ControlCC#Aragora Implementation
Logical accessCC6.1RBAC, JWT authentication
System boundariesCC6.2Network policies, firewalls
Access removalCC6.3Session invalidation, token revocation
Access restrictionsCC6.6Rate limiting, IP allowlisting
Transmission securityCC6.7TLS 1.2+, WSS
Vulnerability managementCC7.1Dependency scanning, updates
Security monitoringCC7.2Audit logs, Prometheus alerts
Incident responseCC7.3Documented procedures
Incident recoveryCC7.4Backup/restore tested
Security testingCC7.5Penetration testing (annual)

Availability

ControlA#Aragora Implementation
Capacity planningA1.1Resource monitoring, scaling
Recovery planningA1.2DR runbook, RTO/RPO targets
Backup proceduresA1.2Daily backups, 14-day retention
Incident recoveryA1.3Tested recovery procedures

Processing Integrity

ControlPI#Aragora Implementation
Processing accuracyPI1.1Input validation, checksums
Processing completenessPI1.2Transaction logging
Processing timelinessPI1.3SLO monitoring

Confidentiality

ControlC#Aragora Implementation
Confidential info identificationC1.1Data classification
Confidential info protectionC1.2Encryption at rest/transit

Privacy

ControlP#Aragora Implementation
Privacy noticeP1.1Privacy policy displayed
Choice and consentP2.1Opt-in consent
Collection limitationP3.1Minimal data collection
Use and retentionP4.1Defined retention periods
AccessP5.1Data export available
DisclosureP6.1No third-party sale
QualityP7.1User can update profile
MonitoringP8.1Privacy compliance audits

Evidence Collection

# Generate SOC 2 evidence report
python scripts/compliance_report.py --framework soc2 --output soc2_evidence.json

# Evidence includes:
# - Access control configurations
# - Encryption settings
# - Audit log samples
# - Backup verification results
# - Incident response test results

HIPAA Considerations

Note: Aragora is not HIPAA-certified by default. Additional configuration and a Business Associate Agreement (BAA) are required for PHI handling.

Technical Safeguards

Safeguard§Implementation Status
Access control164.312(a)(1)✅ RBAC, unique user IDs
Audit controls164.312(b)✅ Comprehensive audit logging
Integrity controls164.312(c)(1)✅ Checksums, validation
Transmission security164.312(e)(1)✅ TLS encryption
Authentication164.312(d)✅ MFA available

Administrative Safeguards

Safeguard§Notes
Security officer164.308(a)(2)Customer responsibility
Workforce training164.308(a)(5)Customer responsibility
Incident procedures164.308(a)(6)✅ Documented
Contingency plan164.308(a)(7)✅ DR runbook
BAA requirements164.308(b)(1)Contact sales

Physical Safeguards

Safeguard§Notes
Facility access164.310(a)(1)Cloud provider responsibility
Workstation use164.310(b)Customer responsibility
Device controls164.310(d)(1)Encryption at rest

HIPAA-Ready Configuration

# Enable HIPAA-ready mode
export ARAGORA_HIPAA_MODE=1

# This enables:
# - Enhanced audit logging
# - Automatic session timeout (15 minutes)
# - Mandatory MFA for all users
# - Encrypted local storage
# - PHI data classification warnings

AI Act Compliance

Risk Classification

Aragora's multi-agent debate system is classified as:

Use CaseRisk LevelRationale
Code review debatesMinimalDeveloper tool, no direct user impact
Decision supportLimitedAdvisory only, human oversight required
Content moderationLimitedRequires human review
Autonomous actionsHighNomic loop has safety guardrails

Transparency Requirements

Model Documentation

RequirementImplementation
Training dataThird-party models (Anthropic, OpenAI)
Model capabilitiesDocumented per agent
LimitationsListed in agent descriptions
Intended useDebate and critique

User Disclosure

This system uses AI models from multiple providers:
- Anthropic Claude
- OpenAI GPT
- Google Gemini
- Mistral AI
- xAI Grok

AI-generated content is clearly labeled. Human oversight
is maintained through voting and approval mechanisms.

Human Oversight

MechanismDescription
Vote requirementsConsensus requires human votes
Approval workflowsCritical changes need human approval
Override capabilityHumans can override AI decisions
Audit trailsAll AI actions logged
Kill switchCircuit breaker stops runaway processes

Technical Documentation

# Generate AI Act compliance report
python scripts/compliance_report.py --framework ai-act --output ai_act_report.json

# Report includes:
# - Model inventory
# - Risk assessment
# - Transparency measures
# - Human oversight mechanisms
# - Testing documentation

CCPA Compliance

Consumer Rights

RightImplementation
Right to knowData inventory, privacy policy
Right to deleteAccount deletion API
Right to opt-outMarketing consent toggle
Right to non-discriminationNo service degradation
Right to correctProfile editing

Data Collection Disclosure

Categories of personal information collected:

CategoryExamplesPurpose
IdentifiersEmail, usernameAccount management
Internet activityDebate participationService provision
GeolocationIP-derived countryCompliance, analytics
InferencesAgent preferencesPersonalization

Do Not Sell

Aragora does not sell personal information. Third-party sharing is limited to:

  • LLM providers (for debate processing)
  • Analytics (anonymized, opt-out available)
  • Legal requirements (law enforcement)

CCPA Request Handling

# Right to know (data inventory)
GET /api/privacy/data-inventory
GET /api/v2/users/me/data-inventory

# Right to know (full export)
GET /api/privacy/export
GET /api/v2/users/me/export

# Right to delete
DELETE /api/privacy/account
DELETE /api/v2/users/me
# Body: {"password": "...", "confirm": true}

# Right to opt-out (Do Not Sell)
GET /api/privacy/preferences # Get current settings
POST /api/privacy/preferences # Update settings
# Body: {"do_not_sell": true, "marketing_opt_out": true, "analytics_opt_out": true}

Data Processing

Data Flow Diagram

[User] --> [Frontend] --> [API Gateway]
|
v
[Authentication]
|
v
[Rate Limiting (Redis)]
|
v
[API Handlers]
/ \
v v
[Debate Engine] [User Store]
| |
v v
[LLM Providers] [SQLite/PostgreSQL]
(External APIs) (Encrypted)

Data Processing Activities

ActivityDataLegal BasisRetention
AuthenticationEmail, password hashContractAccount lifetime
Debate participationMessages, votesConsentIndefinite
Agent callsPrompts, responsesContract30 days
AnalyticsUsage patternsLegitimate interest90 days
Audit loggingActions, timestampsLegal obligation1 year

Third-Party Processors

ProcessorPurposeData SharedSafeguards
AnthropicClaude APIDebate promptsDPA, encryption
OpenAIGPT APIDebate promptsDPA, encryption
GoogleGemini APIDebate promptsDPA, encryption
SentryError trackingStack traces (no PII)Data processing agreement
PrometheusMetricsAggregated stats onlySelf-hosted option

Audit Support

Available Reports

# Generate compliance evidence
python scripts/compliance_report.py --all

# Individual frameworks
python scripts/compliance_report.py --framework gdpr
python scripts/compliance_report.py --framework soc2
python scripts/compliance_report.py --framework hipaa
python scripts/compliance_report.py --framework ccpa

Audit Log Access

# Export audit logs for external review
sqlite3 .nomic/aragora_audit.db ".mode csv" ".headers on" \
".output audit_export.csv" "SELECT * FROM audit_log"

# Filter by date range
sqlite3 .nomic/aragora_audit.db \
"SELECT * FROM audit_log WHERE timestamp BETWEEN '2026-01-01' AND '2026-01-31'"

Control Evidence

Control AreaEvidence Location
Access controlUser role assignments, permission logs
AuthenticationLogin audit trail, MFA enrollment
EncryptionTLS certificates, encryption config
BackupBackup logs, restore test results
MonitoringAlert configurations, incident logs
Change managementGit history, deployment logs

Auditor Access

# Create read-only auditor account
curl -X POST /api/v2/admin/users \
-H "Authorization: Bearer $ADMIN_TOKEN" \
-d '{
"email": "auditor@example.com",
"role": "auditor",
"permissions": ["read:audit_logs", "read:users", "read:config"]
}'

Compliance Checklist

Pre-Deployment

  • Privacy policy published and accessible
  • Cookie consent banner implemented (if applicable)
  • Data processing agreements with third parties
  • Encryption enabled at rest and in transit
  • Audit logging configured
  • Backup procedures documented and tested

Ongoing

  • Monthly access review
  • Quarterly vulnerability scan
  • Annual penetration test
  • Annual privacy impact assessment
  • Incident response drill (semi-annual)
  • Employee security training (annual)

On Request

  • Data subject requests processed within 30 days
  • Breach notification within 72 hours (GDPR)
  • Audit evidence available within 5 business days

Contact