# SignalCanvas Agents Architecture & Testing Guide - Language: Python (package name: signalcanvas_graph_based_market_signal_s) - Core tech: Python 3.8+, dataclasses, simple cryptographic hashes for attestations - Tests: pytest-based test suite located in tests/ - Build: python3 -m build to create wheels; test.sh runs tests and build to verify packaging - Run locally: bash test.sh Conventions - All code lives under signalcanvas_graph_based_market_signal_s/ with a lightweight delta-sync extension in delta_sync.py - Readable, minimal APIs: Graph primitives (SignalNode, Link, Scenario, HedgePlan), backtester, privacy, NLP - Adapters live in adapters.py and are designed to be extended for FIX/WebSocket and simulated venues Phases (as per MVP plan) - Phase 0: Graph core, 2 adapters, local replay engine - Phase 1: Delta-sync protocol + narrative templates - Phase 2: Cross-venue demo with governance ledger scaffolding How to contribute - Follow the repository’s existing Python packaging and test commands - Add new adapters or primitives with corresponding tests under tests/ - Update README with usage and examples