@senpi/runtime 3.0.9-dev.20260710204324 → 3.0.9-dev.feat-strategy-compos.20260716233548
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli/composer-commands.d.ts +37 -0
- package/dist/cli/composer-commands.d.ts.map +1 -0
- package/dist/cli/composer-commands.js +396 -0
- package/dist/cli/composer-commands.js.map +1 -0
- package/dist/cli/senpi-commands.d.ts.map +1 -1
- package/dist/cli/senpi-commands.js +2 -0
- package/dist/cli/senpi-commands.js.map +1 -1
- package/dist/cli/validate-runtime-config.mjs +190 -0
- package/dist/composer/AUTHORING.md +435 -0
- package/dist/composer/__init__.py +29 -0
- package/dist/composer/authoring/__init__.py +59 -0
- package/dist/composer/authoring/answers.py +297 -0
- package/dist/composer/authoring/archetypes/__init__.py +26 -0
- package/dist/composer/authoring/archetypes/_common.py +410 -0
- package/dist/composer/authoring/archetypes/breakout.py +134 -0
- package/dist/composer/authoring/archetypes/classifier.py +109 -0
- package/dist/composer/authoring/archetypes/skeleton.py +76 -0
- package/dist/composer/authoring/archetypes/thesis_fund.py +103 -0
- package/dist/composer/authoring/archetypes/trend_momentum.py +132 -0
- package/dist/composer/authoring/builder.py +191 -0
- package/dist/composer/authoring/emit.py +264 -0
- package/dist/composer/authoring/gaps.py +115 -0
- package/dist/composer/authoring/generate.py +131 -0
- package/dist/composer/authoring/presets.py +168 -0
- package/dist/composer/authoring/runtime_emit.py +266 -0
- package/dist/composer/authoring/strategy_manifest.py +94 -0
- package/dist/composer/cli.py +487 -0
- package/dist/composer/compiler/__init__.py +22 -0
- package/dist/composer/compiler/compile.py +739 -0
- package/dist/composer/examples/breakout_swing.graph.yaml +121 -0
- package/dist/composer/examples/conviction_scorer.graph.yaml +216 -0
- package/dist/composer/examples/macro_thesis_basket.graph.yaml +247 -0
- package/dist/composer/examples/pre_listing_classifier.graph.yaml +204 -0
- package/dist/composer/examples/trend_momentum_majors.graph.yaml +133 -0
- package/dist/composer/generated/README.md +22 -0
- package/dist/composer/generated/catalog.md +118 -0
- package/dist/composer/generated/describe.md +1168 -0
- package/dist/composer/generated/graph.schema.json +1946 -0
- package/dist/composer/primitives/__init__.py +320 -0
- package/dist/composer/primitives/_candles.py +76 -0
- package/dist/composer/primitives/adapter.py +363 -0
- package/dist/composer/primitives/emitters.py +142 -0
- package/dist/composer/primitives/filters.py +71 -0
- package/dist/composer/primitives/indicators.py +326 -0
- package/dist/composer/primitives/rankers.py +40 -0
- package/dist/composer/primitives/scorers.py +100 -0
- package/dist/composer/primitives/sources.py +979 -0
- package/dist/composer/primitives/stateful.py +254 -0
- package/dist/composer/pure_fn/__init__.py +34 -0
- package/dist/composer/pure_fn/checks.py +39 -0
- package/dist/composer/pure_fn/models.py +177 -0
- package/dist/composer/pure_fn/purity.py +311 -0
- package/dist/composer/pure_fn/runtests.py +155 -0
- package/dist/composer/registry/__init__.py +40 -0
- package/dist/composer/registry/generate.py +425 -0
- package/dist/composer/registry/mcp-tools-snapshot.json +193 -0
- package/dist/composer/registry/mcp_closure.py +311 -0
- package/dist/composer/registry/models.py +417 -0
- package/dist/composer/registry/nodes.py +1297 -0
- package/dist/composer/requirements.txt +21 -0
- package/dist/composer/scaffold_path.py +118 -0
- package/dist/composer/templates/__init__.py +13 -0
- package/dist/composer/templates/scan.py.j2 +34 -0
- package/dist/composer/validator/__init__.py +29 -0
- package/dist/composer/validator/desugar.py +133 -0
- package/dist/composer/validator/errors.py +227 -0
- package/dist/composer/validator/graph_checks.py +443 -0
- package/dist/composer/validator/loader.py +110 -0
- package/dist/composer/validator/schema_checks.py +147 -0
- package/dist/composer/validator/validate.py +86 -0
- package/dist/composer/vendoring.py +103 -0
- package/dist/composer/verbs/__init__.py +49 -0
- package/dist/composer/verbs/_box.py +308 -0
- package/dist/composer/verbs/check.py +254 -0
- package/dist/composer/verbs/close.py +494 -0
- package/dist/composer/verbs/deploy.py +279 -0
- package/dist/composer/verbs/docs.py +30 -0
- package/dist/composer/verbs/fund.py +498 -0
- package/dist/composer/verbs/install.py +586 -0
- package/dist/composer/verbs/runtime_validate.py +422 -0
- package/dist/composer/verbs/smoke.py +134 -0
- package/dist/composer/verbs/status.py +383 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -9
- package/dist/index.js.map +1 -1
- package/dist/runtime/load-runtime-config.d.ts +17 -0
- package/dist/runtime/load-runtime-config.d.ts.map +1 -1
- package/dist/runtime/load-runtime-config.js +2 -2
- package/dist/runtime/load-runtime-config.js.map +1 -1
- package/dist/runtime-api/config.d.ts +2 -2
- package/dist/runtime-api/config.js +4 -4
- package/dist/runtime-api/config.js.map +1 -1
- package/dist/runtime-api/handlers/ingest-signals.d.ts +3 -5
- package/dist/runtime-api/handlers/ingest-signals.d.ts.map +1 -1
- package/dist/runtime-api/handlers/ingest-signals.js +5 -14
- package/dist/runtime-api/handlers/ingest-signals.js.map +1 -1
- package/dist/runtime-api/intake/intake-mount.d.ts.map +1 -1
- package/dist/runtime-api/intake/intake-mount.js +2 -8
- package/dist/runtime-api/intake/intake-mount.js.map +1 -1
- package/dist/skills-manager/manifest.d.ts.map +1 -1
- package/dist/skills-manager/manifest.js +1 -3
- package/dist/skills-manager/manifest.js.map +1 -1
- package/dist/skills-manager/skills-manifest.json +1 -3
- package/package.json +4 -2
- package/dist/runtime-api/intake/ingest-mutex.d.ts +0 -16
- package/dist/runtime-api/intake/ingest-mutex.d.ts.map +0 -1
- package/dist/runtime-api/intake/ingest-mutex.js +0 -18
- package/dist/runtime-api/intake/ingest-mutex.js.map +0 -1
|
@@ -0,0 +1,320 @@
|
|
|
1
|
+
"""primitives — the runtime-owned pure Python implementing the registry nodes (D2 §1).
|
|
2
|
+
|
|
3
|
+
Primitive nodes are the parameterized building blocks where all I/O and effects live
|
|
4
|
+
(sources, indicators, filters, rankers, emitters) plus the stateful TTL-dedup variant
|
|
5
|
+
whose state is a typed in/out port pair compiled onto ``ctx.state`` (D2). Their
|
|
6
|
+
implementations live here so both the compiled ``scan.py`` and, later, hand-written
|
|
7
|
+
tier-3 scanners can import them; the emitted scanner reaches this package through the
|
|
8
|
+
scaffold ``sys.path`` (recorded POC decision: no packaging yet, ``senpi_ta`` versioning
|
|
9
|
+
stays open post-POC).
|
|
10
|
+
|
|
11
|
+
Slice-3 scope: real implementations for every node the stag AND hawk graphs use —
|
|
12
|
+
3 sources, 7 indicators, 2 filters, 1 scorer, 1 ranker, 1 emitter, 1 stateful = 16.
|
|
13
|
+
Each is a pure function (or, for the sources, a pure normalizer paired with the thin
|
|
14
|
+
``adapter`` that does the I/O) over plain data structures. Semantics are ported from
|
|
15
|
+
the corpus originals (cited in each module); per-primitive golden vectors under
|
|
16
|
+
python-tests/composer define correctness.
|
|
17
|
+
|
|
18
|
+
``IMPLEMENTATIONS`` is the machine-checkable bridge between the registry declarations
|
|
19
|
+
and these functions: the registry<->implementation signature-agreement test asserts,
|
|
20
|
+
for every implemented node, that the callable's signature and the params/ports it
|
|
21
|
+
consumes match the registry NodeDef exactly.
|
|
22
|
+
"""
|
|
23
|
+
|
|
24
|
+
from __future__ import annotations
|
|
25
|
+
|
|
26
|
+
from dataclasses import dataclass
|
|
27
|
+
from typing import Callable, Optional
|
|
28
|
+
|
|
29
|
+
from . import emitters, filters, indicators, rankers, scorers, sources, stateful
|
|
30
|
+
from .adapter import McpSourceAdapter, make_adapter
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
@dataclass(frozen=True)
|
|
34
|
+
class ImplSpec:
|
|
35
|
+
"""How one registry node maps onto its Python implementation.
|
|
36
|
+
|
|
37
|
+
fn_args — the callable's exact ordered parameter names (pins the signature).
|
|
38
|
+
param_args — registry param names the callable consumes.
|
|
39
|
+
adapter_params — registry param names consumed by the adapter / emitted code, not fn.
|
|
40
|
+
port_args — registry (non-state) input-port names the callable consumes.
|
|
41
|
+
out_ports — registry (non-state) output-port names the callable returns, in order.
|
|
42
|
+
write_fn/args — the WRITE half of a split stateful node (epilogue), if any.
|
|
43
|
+
"""
|
|
44
|
+
|
|
45
|
+
node: str
|
|
46
|
+
fn: Callable
|
|
47
|
+
fn_args: tuple = ()
|
|
48
|
+
param_args: tuple = ()
|
|
49
|
+
adapter_params: tuple = ()
|
|
50
|
+
port_args: tuple = ()
|
|
51
|
+
out_ports: tuple = ()
|
|
52
|
+
write_fn: Optional[Callable] = None
|
|
53
|
+
write_args: tuple = ()
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
IMPLEMENTATIONS: dict[str, ImplSpec] = {
|
|
57
|
+
# ---- sources (pure normalizer + adapter-fetched raw) --------------------
|
|
58
|
+
"candles_fetch": ImplSpec(
|
|
59
|
+
node="candles_fetch", fn=sources.candles_fetch,
|
|
60
|
+
fn_args=("raw_by_asset", "intervals"),
|
|
61
|
+
param_args=("intervals",),
|
|
62
|
+
adapter_params=("whitelist", "include_funding", "include_asset_context"),
|
|
63
|
+
port_args=(), out_ports=("candles",),
|
|
64
|
+
),
|
|
65
|
+
"clearinghouse_state": ImplSpec(
|
|
66
|
+
node="clearinghouse_state", fn=sources.clearinghouse_state,
|
|
67
|
+
fn_args=("raw",), out_ports=("held", "equity"),
|
|
68
|
+
),
|
|
69
|
+
"sm_lean": ImplSpec(
|
|
70
|
+
node="sm_lean", fn=sources.sm_lean,
|
|
71
|
+
fn_args=("raw", "assets", "agree_threshold"),
|
|
72
|
+
param_args=("agree_threshold",), port_args=("assets",), out_ports=("lean",),
|
|
73
|
+
),
|
|
74
|
+
"instrument_list": ImplSpec(
|
|
75
|
+
node="instrument_list", fn=sources.instrument_list,
|
|
76
|
+
fn_args=("raw",), adapter_params=("dex",), out_ports=("instruments",),
|
|
77
|
+
),
|
|
78
|
+
"universe_discover": ImplSpec(
|
|
79
|
+
node="universe_discover", fn=sources.universe_discover,
|
|
80
|
+
fn_args=("instruments", "min_day_volume", "max_leverage_cap", "name_prefix"),
|
|
81
|
+
param_args=("min_day_volume", "max_leverage_cap", "name_prefix"),
|
|
82
|
+
port_args=("instruments",), out_ports=("universe",),
|
|
83
|
+
),
|
|
84
|
+
"own_return_24h": ImplSpec(
|
|
85
|
+
node="own_return_24h", fn=sources.own_return_24h,
|
|
86
|
+
fn_args=("candles",), port_args=("candles",), out_ports=("return_24h",),
|
|
87
|
+
),
|
|
88
|
+
# ---- batch C: world-coverage sources ------------------------------------
|
|
89
|
+
"market_prices_fetch": ImplSpec(
|
|
90
|
+
node="market_prices_fetch", fn=sources.market_prices,
|
|
91
|
+
fn_args=("raw", "assets"),
|
|
92
|
+
adapter_params=("dex",), port_args=("assets",), out_ports=("prices",),
|
|
93
|
+
),
|
|
94
|
+
"strategy_list_fetch": ImplSpec(
|
|
95
|
+
node="strategy_list_fetch", fn=sources.strategy_list,
|
|
96
|
+
fn_args=("raw",), adapter_params=("status", "strategy_type"),
|
|
97
|
+
out_ports=("strategies",),
|
|
98
|
+
),
|
|
99
|
+
"open_orders_fetch": ImplSpec(
|
|
100
|
+
node="open_orders_fetch", fn=sources.open_orders,
|
|
101
|
+
fn_args=("raw",), out_ports=("orders",),
|
|
102
|
+
),
|
|
103
|
+
"trader_history_fetch": ImplSpec(
|
|
104
|
+
node="trader_history_fetch", fn=sources.trader_history,
|
|
105
|
+
fn_args=("raw",), adapter_params=("trader_address", "limit"),
|
|
106
|
+
out_ports=("closed_positions",),
|
|
107
|
+
),
|
|
108
|
+
"asset_trading_limits_fetch": ImplSpec(
|
|
109
|
+
node="asset_trading_limits_fetch", fn=sources.asset_trading_limits,
|
|
110
|
+
fn_args=("raw_by_asset",), adapter_params=("dex",),
|
|
111
|
+
out_ports=("max_leverage",),
|
|
112
|
+
),
|
|
113
|
+
"strategy_pnl_snapshot": ImplSpec(
|
|
114
|
+
node="strategy_pnl_snapshot", fn=sources.strategy_pnl_snapshot,
|
|
115
|
+
fn_args=("raw",), adapter_params=("period", "drawdown_reset_on_day_rollover"),
|
|
116
|
+
out_ports=("today_pnl", "today_account_value", "today_drawdown"),
|
|
117
|
+
),
|
|
118
|
+
"trader_state_fetch": ImplSpec(
|
|
119
|
+
node="trader_state_fetch", fn=sources.trader_state,
|
|
120
|
+
fn_args=("raw",), adapter_params=("trader_address",),
|
|
121
|
+
out_ports=("held", "equity"),
|
|
122
|
+
),
|
|
123
|
+
# ---- wave A: remaining world-coverage sources (2026-07-16) --------------
|
|
124
|
+
"funding_regime_fetch": ImplSpec(
|
|
125
|
+
node="funding_regime_fetch", fn=sources.funding_regime,
|
|
126
|
+
fn_args=("raw",), out_ports=("regime", "companions"),
|
|
127
|
+
),
|
|
128
|
+
"top_traders_fetch": ImplSpec(
|
|
129
|
+
node="top_traders_fetch", fn=sources.top_traders,
|
|
130
|
+
fn_args=("raw_pages",),
|
|
131
|
+
adapter_params=("time_frame", "sort_by", "bias", "limit", "max_pages",
|
|
132
|
+
"open_position_filter", "activity_labels", "consistency", "risk_labels"),
|
|
133
|
+
out_ports=("traders",),
|
|
134
|
+
),
|
|
135
|
+
"trader_states_fetch": ImplSpec(
|
|
136
|
+
node="trader_states_fetch", fn=sources.trader_states,
|
|
137
|
+
fn_args=("raw_pages",),
|
|
138
|
+
adapter_params=("wallets", "latest", "include_position_age",
|
|
139
|
+
"sort_open_positions_by", "sort_open_positions_direction"),
|
|
140
|
+
out_ports=("traders",),
|
|
141
|
+
),
|
|
142
|
+
"funding_history_fetch": ImplSpec(
|
|
143
|
+
node="funding_history_fetch", fn=sources.funding_history,
|
|
144
|
+
fn_args=("raw",),
|
|
145
|
+
adapter_params=("asset", "min_annualized_pct", "min_persistence_hours"),
|
|
146
|
+
out_ports=("assets",),
|
|
147
|
+
),
|
|
148
|
+
"cross_asset_flows_fetch": ImplSpec(
|
|
149
|
+
node="cross_asset_flows_fetch", fn=sources.cross_asset_flows,
|
|
150
|
+
fn_args=("raw",),
|
|
151
|
+
adapter_params=("leader_asset", "min_move_pct", "window"),
|
|
152
|
+
out_ports=("laggards", "leader"),
|
|
153
|
+
),
|
|
154
|
+
"trader_positions_fetch": ImplSpec(
|
|
155
|
+
node="trader_positions_fetch", fn=sources.trader_positions,
|
|
156
|
+
fn_args=("raw",),
|
|
157
|
+
adapter_params=("trader_id",),
|
|
158
|
+
out_ports=("positions", "header"),
|
|
159
|
+
),
|
|
160
|
+
# ---- wave B: the last scanner-usable Senpi MCP reads (2026-07-16) --------
|
|
161
|
+
"momentum_events_fetch": ImplSpec(
|
|
162
|
+
node="momentum_events_fetch", fn=sources.momentum_events,
|
|
163
|
+
fn_args=("raw",),
|
|
164
|
+
adapter_params=("limit", "tier", "asset", "from_time", "to_time"),
|
|
165
|
+
out_ports=("events", "header"),
|
|
166
|
+
),
|
|
167
|
+
"top_strategies_fetch": ImplSpec(
|
|
168
|
+
node="top_strategies_fetch", fn=sources.top_strategies,
|
|
169
|
+
fn_args=("raw_pages",),
|
|
170
|
+
adapter_params=("limit", "offset", "force_fetch", "max_pages"),
|
|
171
|
+
out_ports=("strategies",),
|
|
172
|
+
),
|
|
173
|
+
"arena_leaderboard_fetch": ImplSpec(
|
|
174
|
+
node="arena_leaderboard_fetch", fn=sources.arena_leaderboard,
|
|
175
|
+
fn_args=("raw",),
|
|
176
|
+
adapter_params=("period_type", "period_number", "limit", "offset", "qualified"),
|
|
177
|
+
out_ports=("entries",),
|
|
178
|
+
),
|
|
179
|
+
"leaderboard_top_fetch": ImplSpec(
|
|
180
|
+
node="leaderboard_top_fetch", fn=sources.leaderboard_top,
|
|
181
|
+
fn_args=("raw",), adapter_params=("limit",),
|
|
182
|
+
out_ports=("traders", "header"),
|
|
183
|
+
),
|
|
184
|
+
"leaderboard_trader_fetch": ImplSpec(
|
|
185
|
+
node="leaderboard_trader_fetch", fn=sources.leaderboard_trader,
|
|
186
|
+
fn_args=("raw",), adapter_params=("trader_id",),
|
|
187
|
+
out_ports=("trader",),
|
|
188
|
+
),
|
|
189
|
+
"open_positions_realized_pnl_fetch": ImplSpec(
|
|
190
|
+
node="open_positions_realized_pnl_fetch", fn=sources.open_positions_realized_pnl,
|
|
191
|
+
fn_args=("raw_pages",), adapter_params=("latest",),
|
|
192
|
+
out_ports=("realized",),
|
|
193
|
+
),
|
|
194
|
+
"account_history_fetch": ImplSpec(
|
|
195
|
+
node="account_history_fetch", fn=sources.account_history,
|
|
196
|
+
fn_args=("raw",), adapter_params=("bucket_duration_ms",),
|
|
197
|
+
out_ports=("periods",),
|
|
198
|
+
),
|
|
199
|
+
# ---- indicators ---------------------------------------------------------
|
|
200
|
+
"sma": ImplSpec(
|
|
201
|
+
node="sma", fn=indicators.sma,
|
|
202
|
+
fn_args=("candles", "period", "interval"),
|
|
203
|
+
param_args=("period", "interval"), port_args=("candles",),
|
|
204
|
+
out_ports=("value", "above"),
|
|
205
|
+
),
|
|
206
|
+
"pct_change": ImplSpec(
|
|
207
|
+
node="pct_change", fn=indicators.pct_change,
|
|
208
|
+
fn_args=("candles", "lookback", "interval"),
|
|
209
|
+
param_args=("lookback", "interval"), port_args=("candles",), out_ports=("pct",),
|
|
210
|
+
),
|
|
211
|
+
"recent_high_bars_ago": ImplSpec(
|
|
212
|
+
node="recent_high_bars_ago", fn=indicators.recent_high_bars_ago,
|
|
213
|
+
fn_args=("candles", "window", "interval"),
|
|
214
|
+
param_args=("window", "interval"), port_args=("candles",), out_ports=("bars_ago",),
|
|
215
|
+
),
|
|
216
|
+
"volume_surge_ratio": ImplSpec(
|
|
217
|
+
node="volume_surge_ratio", fn=indicators.volume_surge_ratio,
|
|
218
|
+
fn_args=("candles", "recent_window", "baseline_window", "interval"),
|
|
219
|
+
param_args=("recent_window", "baseline_window", "interval"),
|
|
220
|
+
port_args=("candles",), out_ports=("ratio",),
|
|
221
|
+
),
|
|
222
|
+
"acceleration": ImplSpec(
|
|
223
|
+
node="acceleration", fn=indicators.acceleration,
|
|
224
|
+
fn_args=("candles", "short_window", "long_window", "interval"),
|
|
225
|
+
param_args=("short_window", "long_window", "interval"),
|
|
226
|
+
port_args=("candles",), out_ports=("accelerating",),
|
|
227
|
+
),
|
|
228
|
+
"trend_structure": ImplSpec(
|
|
229
|
+
node="trend_structure", fn=indicators.trend_structure,
|
|
230
|
+
fn_args=("candles", "lookback", "interval"),
|
|
231
|
+
param_args=("lookback", "interval"), port_args=("candles",), out_ports=("direction",),
|
|
232
|
+
),
|
|
233
|
+
"breakout_detect": ImplSpec(
|
|
234
|
+
node="breakout_detect", fn=indicators.breakout_detect,
|
|
235
|
+
fn_args=("candles", "window", "interval"),
|
|
236
|
+
param_args=("window", "interval"), port_args=("candles",), out_ports=("direction",),
|
|
237
|
+
),
|
|
238
|
+
"threshold_gate": ImplSpec(
|
|
239
|
+
node="threshold_gate", fn=indicators.threshold_gate,
|
|
240
|
+
fn_args=("values", "op", "value"),
|
|
241
|
+
param_args=("op", "value"), port_args=("values",), out_ports=("passed",),
|
|
242
|
+
),
|
|
243
|
+
"rsi": ImplSpec(
|
|
244
|
+
node="rsi", fn=indicators.rsi,
|
|
245
|
+
fn_args=("candles", "period", "interval"),
|
|
246
|
+
param_args=("period", "interval"), port_args=("candles",), out_ports=("rsi",),
|
|
247
|
+
),
|
|
248
|
+
# ---- filters ------------------------------------------------------------
|
|
249
|
+
"held_asset_exclusion": ImplSpec(
|
|
250
|
+
node="held_asset_exclusion", fn=filters.held_asset_exclusion,
|
|
251
|
+
fn_args=("candidates", "held"), port_args=("candidates", "held"), out_ports=("kept",),
|
|
252
|
+
),
|
|
253
|
+
"recent_signal_ttl_dedup": ImplSpec(
|
|
254
|
+
node="recent_signal_ttl_dedup", fn=filters.recent_signal_ttl_dedup,
|
|
255
|
+
fn_args=("candidates", "recent"), port_args=("candidates", "recent"), out_ports=("kept",),
|
|
256
|
+
),
|
|
257
|
+
"classifier_predicate": ImplSpec(
|
|
258
|
+
node="classifier_predicate", fn=filters.classifier_predicate,
|
|
259
|
+
fn_args=("candidates", "max_funding_abs", "max_leverage", "exclude_delisted"),
|
|
260
|
+
param_args=("max_funding_abs", "max_leverage", "exclude_delisted"),
|
|
261
|
+
port_args=("candidates",), out_ports=("kept",),
|
|
262
|
+
),
|
|
263
|
+
"live_instrument_validation": ImplSpec(
|
|
264
|
+
node="live_instrument_validation", fn=filters.live_instrument_validation,
|
|
265
|
+
fn_args=("candidates", "instruments"),
|
|
266
|
+
port_args=("candidates", "instruments"), out_ports=("kept",),
|
|
267
|
+
),
|
|
268
|
+
# ---- scorer -------------------------------------------------------------
|
|
269
|
+
"hard_gates_all": ImplSpec(
|
|
270
|
+
node="hard_gates_all", fn=scorers.hard_gates_all,
|
|
271
|
+
fn_args=("features", "required_gates", "weights", "min_score"),
|
|
272
|
+
param_args=("required_gates", "weights", "min_score"),
|
|
273
|
+
port_args=("features",), out_ports=("scores",),
|
|
274
|
+
),
|
|
275
|
+
# ---- ranker -------------------------------------------------------------
|
|
276
|
+
"emit_single_best": ImplSpec(
|
|
277
|
+
node="emit_single_best", fn=rankers.emit_single_best,
|
|
278
|
+
fn_args=("scores", "min_score"),
|
|
279
|
+
param_args=("min_score",), port_args=("scores",), out_ports=("selected",),
|
|
280
|
+
),
|
|
281
|
+
"rank_pool_cap_to_open_slots": ImplSpec(
|
|
282
|
+
node="rank_pool_cap_to_open_slots", fn=rankers.rank_pool_cap_to_open_slots,
|
|
283
|
+
fn_args=("scores", "held", "max_slots", "min_score"),
|
|
284
|
+
param_args=("max_slots", "min_score"), port_args=("scores", "held"),
|
|
285
|
+
out_ports=("selected",),
|
|
286
|
+
),
|
|
287
|
+
# ---- emitter ------------------------------------------------------------
|
|
288
|
+
"signal_envelope": ImplSpec(
|
|
289
|
+
node="signal_envelope", fn=emitters.signal_envelope,
|
|
290
|
+
fn_args=("selected", "equity", "margin_pct", "leverage", "clamp_leverage_to_venue",
|
|
291
|
+
"instruments", "valid_for_seconds", "signal_type"),
|
|
292
|
+
param_args=("margin_pct", "leverage", "clamp_leverage_to_venue",
|
|
293
|
+
"valid_for_seconds", "signal_type"),
|
|
294
|
+
port_args=("selected", "equity", "instruments"), out_ports=("signals",),
|
|
295
|
+
),
|
|
296
|
+
# ---- stateful (split read/write halves) ---------------------------------
|
|
297
|
+
"ttl_dedup_state": ImplSpec(
|
|
298
|
+
node="ttl_dedup_state", fn=stateful.ttl_dedup_state_read,
|
|
299
|
+
fn_args=("state", "ttl_seconds", "prune_factor", "now"),
|
|
300
|
+
param_args=("ttl_seconds", "prune_factor"),
|
|
301
|
+
port_args=(), out_ports=("recent",),
|
|
302
|
+
write_fn=stateful.ttl_dedup_state_write,
|
|
303
|
+
write_args=("state", "working_map", "emitted", "now"),
|
|
304
|
+
),
|
|
305
|
+
}
|
|
306
|
+
|
|
307
|
+
__all__ = [
|
|
308
|
+
"sources",
|
|
309
|
+
"indicators",
|
|
310
|
+
"filters",
|
|
311
|
+
"scorers",
|
|
312
|
+
"rankers",
|
|
313
|
+
"emitters",
|
|
314
|
+
"stateful",
|
|
315
|
+
"adapter",
|
|
316
|
+
"McpSourceAdapter",
|
|
317
|
+
"make_adapter",
|
|
318
|
+
"ImplSpec",
|
|
319
|
+
"IMPLEMENTATIONS",
|
|
320
|
+
]
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
"""_candles — shared candle-field coercion helpers for the indicator primitives.
|
|
2
|
+
|
|
3
|
+
These reproduce the dual-key float coercion used verbatim across the corpus
|
|
4
|
+
originals (``_f`` / ``_close`` / ``_high`` / ``_low`` / ``_vol``); see
|
|
5
|
+
``/Users/duncan/Senpi/skills/strategies/hawk/main/scanners/scoring.py`` and
|
|
6
|
+
``/Users/duncan/Senpi/skills/strategies/stag/main/scanners/scoring.py``. A candle
|
|
7
|
+
is a dict carrying either the long key (``close``) or the short key (``c``); the
|
|
8
|
+
list branch ``[t, o, h, l, c, v]`` is defensive and never fires on dict candles.
|
|
9
|
+
|
|
10
|
+
The goldens WE author (python-tests/composer) define correctness — these helpers
|
|
11
|
+
follow the originals' coercion so the compiled graphs behave the same way on the
|
|
12
|
+
same candle series, but bit-level parity with the originals is not the oracle.
|
|
13
|
+
"""
|
|
14
|
+
|
|
15
|
+
from __future__ import annotations
|
|
16
|
+
|
|
17
|
+
from typing import Any
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
def _f(v: Any, d: float = 0.0) -> float:
|
|
21
|
+
"""Float coercion (corpus ``scoring._f``): non-numeric / None -> default."""
|
|
22
|
+
try:
|
|
23
|
+
return float(v if v is not None else d)
|
|
24
|
+
except (TypeError, ValueError):
|
|
25
|
+
return d
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
def _close(c: Any) -> float:
|
|
29
|
+
if isinstance(c, dict):
|
|
30
|
+
return _f(c.get("close", c.get("c", 0)))
|
|
31
|
+
if isinstance(c, (list, tuple)) and len(c) >= 5:
|
|
32
|
+
return _f(c[4])
|
|
33
|
+
return 0.0
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
def _high(c: Any) -> float:
|
|
37
|
+
if isinstance(c, dict):
|
|
38
|
+
return _f(c.get("high", c.get("h", 0)))
|
|
39
|
+
if isinstance(c, (list, tuple)) and len(c) >= 5:
|
|
40
|
+
return _f(c[2])
|
|
41
|
+
return 0.0
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
def _low(c: Any) -> float:
|
|
45
|
+
if isinstance(c, dict):
|
|
46
|
+
return _f(c.get("low", c.get("l", 0)))
|
|
47
|
+
if isinstance(c, (list, tuple)) and len(c) >= 5:
|
|
48
|
+
return _f(c[3])
|
|
49
|
+
return 0.0
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
def _vol(c: Any) -> float:
|
|
53
|
+
if isinstance(c, dict):
|
|
54
|
+
return _f(c.get("volume", c.get("v", c.get("vlm", 0))))
|
|
55
|
+
if isinstance(c, (list, tuple)) and len(c) >= 6:
|
|
56
|
+
return _f(c[5])
|
|
57
|
+
return 0.0
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
def _closes(series: list) -> list[float]:
|
|
61
|
+
return [_close(c) for c in series]
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
def _pct_change(closes: list[float], lookback: int):
|
|
65
|
+
"""% change of the latest close vs the close ``lookback`` bars ago.
|
|
66
|
+
|
|
67
|
+
Verbatim shape from stag ``scoring.pct_change`` (cited file above): None on
|
|
68
|
+
insufficient data or a non-positive reference price.
|
|
69
|
+
"""
|
|
70
|
+
if not closes or len(closes) <= lookback:
|
|
71
|
+
return None
|
|
72
|
+
ref = closes[-(lookback + 1)]
|
|
73
|
+
latest = closes[-1]
|
|
74
|
+
if ref is None or ref <= 0:
|
|
75
|
+
return None
|
|
76
|
+
return ((latest - ref) / ref) * 100.0
|