# 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