From f2bfa0de034d4a9f959400bb9442beec82cdaad6 Mon Sep 17 00:00:00 2001 From: agent-58ba63c88b4c9625 Date: Thu, 23 Apr 2026 22:44:06 +0200 Subject: [PATCH] build(agent): new-agents-4#58ba63 iteration --- README.md | 36 +++++++++++++++++++++++++++++++++++- pyproject.toml | 1 + 2 files changed, 36 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 34e0d59..02994d7 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,40 @@ # DeltaForge Skeleton -DeltaForge MVP skeleton: a real-time cross-asset strategy synthesis engine prototype. +DeltaForge Real-Time Cross-Asset Strategy Synthesis Engine + +Overview +- DeltaForge is an open-source engine that synthesizes, validates, and executes hedging/arbitrage strategies across assets and venues with low latency. +- MVP focuses on two assets across two venues with a simple delta-hedge and cross-venue spread demonstration. + +Architecture (mapping to code in this repository) +- Core DSL: Asset, MarketSignal, StrategyDelta, PlanDelta (src/deltaforge/dsl.py) +- Lightweight ADMM-like coordinator: ADMMCoordinator (src/deltaforge/coordinator.py) +- Graph-of-Contracts registry: GoCRegistry (src/deltaforge/registry.py) +- Adapters: equity_feed and options_feed (src/deltaforge/adapters) +- Execution layer: ExecutionEngine (src/deltaforge/execution.py) +- Backtester: Backtester (src/deltaforge/backtester.py) +- Tamper-evident/logging placeholders: signature fields in PlanDelta +- Two starter adapters for data feeds: equity_feed and options_feed + +Usage (high level) +- Create assets and signals with the DSL +- Compose PlanDelta with StrategyDelta entries +- Run ADMMCoordinator.reconcile(plan) to enforce cross-venue coherence +- Use ExecutionEngine to route actions to venues +- Run Backtester.replay(signals, plan) to simulate PnL deterministically + +Packaging and publishing +- This project is configured as deltaforge-skeleton in pyproject.toml +- To publish, ensure READY_TO_PUBLISH exists (empty file is fine) and run your usual publish workflow +- README.md is hooked into packaging via readme = "README.md" in pyproject.toml + +Roadmap (high level) +- Expand GoC registry, versioned contracts, and interoperability with external IRs +- Add a minimal deterministic replay harness for end-to-end testing across venues +- Add more realistic latency-aware routing and cryptographic tags for auditability +- Produce a comprehensive test suite ensuring deterministic outcomes + +See src/deltaforge for implementation details. - Core DSL: Asset, MarketSignal, StrategyDelta, PlanDelta - Lightweight ADMM-like coordinator: ADMMCoordinator diff --git a/pyproject.toml b/pyproject.toml index 7d522cb..b7a414d 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -15,6 +15,7 @@ dependencies = [ "pandas>=1.5", "pytest>=7.0", ] +readme = "README.md" [tool.setuptools.packages.find] where = ["src"]