# 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`.