solfuse-privacy-preserving-federated-orc/AGENTS.md

SolFuse Repository Rules

Architecture

• Language: Python 3.11+
• Layout: src/solfuse package with pytest tests in tests/
• Core modules:
  • models.py: canonical protocol primitives
  • identity.py: DID-style identities and signed envelopes
  • registry.py: graph-of-contracts registry backed by SQLite
  • solver.py: ADMM-lite federated planner
  • governance.py: audit ledger and privacy-budget tracking
  • delta_sync.py: islanding-friendly incremental plan journal
  • transport.py: canonical serialization and TLS context helpers

Testing

• Install editable dependencies: python3 -m pip install -e .[dev]
• Run tests: pytest
• Build package: python3 -m build
• Full validation: bash test.sh

Contribution Rules

• Keep changes minimal and production-oriented.
• Prefer validated models and deterministic behavior.
• Do not add new dependencies unless they are used directly.
• Keep public APIs documented in README.md.