25 lines
1.2 KiB
Markdown
25 lines
1.2 KiB
Markdown
# SoundGraph Studio — Phase0 primitives
|
|
|
|
This repository contains Phase0 primitives for SoundGraph Studio: a content-addressed representation of AudioModule objects, an AudioPatch structure with a Merkle-based root for provable inclusion, and simple provenance events with cryptographic signatures.
|
|
|
|
What is included
|
|
- A small Python package `idea44_soundgraph_studio_verifiable` implementing:
|
|
- AudioModule: content-addressed modules (SHA-256 over canonical JSON)
|
|
- AudioPatch: nodes referencing module CIDs and edges; Merkle root over nodes+edges
|
|
- ProvenanceEvent: lightweight signed events (ed25519) for tamper-evident audit trails
|
|
- Tests (pytest) that validate CID reproducibility, Merkle inclusion proofs, and signature verification
|
|
- Packaging (pyproject.toml + setup.cfg) and a `test.sh` that runs the test suite and verifies build
|
|
|
|
How to run tests
|
|
1. Make sure you have Python 3.8+ and `python3 -m pip` available.
|
|
2. Run:
|
|
|
|
```bash
|
|
./test.sh
|
|
```
|
|
|
|
This will install the package in editable mode, run pytest, and run `python3 -m build` to verify packaging.
|
|
|
|
Notes
|
|
- This is intentionally focused on Phase0 local graph primitives — a solid foundation for future delta-sync, adapters, and governance ledger work.
|