23 lines
1.1 KiB
Markdown
23 lines
1.1 KiB
Markdown
# 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
|