signalcanvas-graph-based-market-signal-s/AGENTS.md

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