AGENTS

Architecture overview for AudioLedger Studio.

Language: Python 3.9+ (pyproject configured)
Core modules:
- core.py: DSL parsing and IR data classes (LocalProblemIR, SharedVariableIR, PlanDeltaIR, AuditLog)
- runtime.py: ExecutionGraph and a minimal deterministic allocator
- delta.py: DeltaStore for offline delta-synchronization
- signer.py: Lightweight HMAC-based attestations for audit logs
- registry.py: GraphRegistry primitive with adapters support
- adapters.py: PriceFeedAdapter as a sample adapter
- sonifier.py: Audio cue mapping from risk/allocation state
- tests/ (unit tests)
Testing: pytest-based tests to cover DSL parsing, runtime allocation, delta syncing, signing, and registry; a test.sh script will run tests and Python packaging to verify build integrity.
How to contribute: follow these steps
1. Implement or modify a feature in the core, then run tests via test.sh
2. Update AGENTS.md if you introduce new components or interfaces
3. Ensure READY_TO_PUBLISH is created only after the repository is fully ready for publishing