idea69-tradeseal-federated-.../AGENTS.md

30 lines
1.2 KiB
Markdown

# 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