idea69-tradeseal-federated-compliance/AGENTS.md

TradeSeal Agents

This repository contains a production-grade baseline for a federated compliance and audit fabric. The system is designed to be extended by agents that contribute components such as data adapters, local solvers, and governance policies.

Architecture overview:

• Core primitives (tradeseal/core.py)
• Federated reconciliation engine (tradeseal/federation.py)
• Governance ledger and attestations (tradeseal/governance.py)
• Adapters registry (tradeseal/adapter_registry.py)
• Tests (tests/)

Tech stack:

• Python 3.11+ (standard library for cryptography, hashing, and data structures)
• No external dependencies required for MVP; future work may introduce more dependencies (e.g., cryptography, ZK proofs)

Testing and commands:

• Run unit tests: pytest
• Run test script: ./test.sh
• Build package: python -m build
• Linting/formatting: not included in MVP, but can be added later

Contribution rules:

• Implement components with clear APIs and minimal surface area
• Add tests for new features
• Update README with usage and interfaces

Operational rules:

• Do not push to remote without explicit instruction
• Keep log messages deterministic for auditability