community
/
idea44-soundgraph-studio-verifiable
34
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
idea44-soundgraph-studio-ve.../README.md

1.2 KiB
Raw Blame History

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:
./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.