26 lines
965 B
Markdown
26 lines
965 B
Markdown
# 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`.
|