idea147-greekshub-federated-cross/AGENTS.md

GreeksHub: Federated Cross-Venue Greeks MVP

Architecture overview

• Local primitives: LocalHedgeProblem, SharedGreeks, DualVariables, PlanDelta, AuditLog, PrivacyBudget.
• Graph-of-Contracts (GoC): lightweight in-process registry to version adapters and data contracts.
• Adapters: two starter adapters (price/vol feed, broker/execution) with TLS transport concept.
• ADMM-lite coordinator: edge-friendly coordinator that aggregates locally computed signals with secure summaries.
• Deterministic replay: plan deltas and signals are replayable for backtests and audits.
• Governance ledger: signed events, lightweight DID-based identity, policy checks.

Scope and testing

• Language: Python (production-ready, strong typing, tests).
• Testing: pytest with a small test suite; test.sh orchestrates tests and packaging sanity checks.

Development workflow

• Add small, composable components first; extend registry and adapters later.
• Run tests locally; ensure packaging metadata compiles (python build) as part of test.sh.

Contribution rules

• Follow minimal, well-documented changes; preserve existing contracts.
• Write tests for any new public API surface.

Checklist for publishing (to be checked by the final phase):

• README.md with marketing and usage detail.
• AGENTS.md present.
• test.sh runs pytest and python -m build for packaging sanity.
• READY_TO_PUBLISH present (empty file to signal completion).