# 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