signalcanvas-graph-based-ma.../AGENTS.md

24 lines
1.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 repositorys existing Python packaging and test commands
- Add new adapters or primitives with corresponding tests under tests/
- Update README with usage and examples