@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.
Files changed (108) hide show
  1. package/dist/cli/composer-commands.d.ts +37 -0
  2. package/dist/cli/composer-commands.d.ts.map +1 -0
  3. package/dist/cli/composer-commands.js +396 -0
  4. package/dist/cli/composer-commands.js.map +1 -0
  5. package/dist/cli/senpi-commands.d.ts.map +1 -1
  6. package/dist/cli/senpi-commands.js +2 -0
  7. package/dist/cli/senpi-commands.js.map +1 -1
  8. package/dist/cli/validate-runtime-config.mjs +190 -0
  9. package/dist/composer/AUTHORING.md +435 -0
  10. package/dist/composer/__init__.py +29 -0
  11. package/dist/composer/authoring/__init__.py +59 -0
  12. package/dist/composer/authoring/answers.py +297 -0
  13. package/dist/composer/authoring/archetypes/__init__.py +26 -0
  14. package/dist/composer/authoring/archetypes/_common.py +410 -0
  15. package/dist/composer/authoring/archetypes/breakout.py +134 -0
  16. package/dist/composer/authoring/archetypes/classifier.py +109 -0
  17. package/dist/composer/authoring/archetypes/skeleton.py +76 -0
  18. package/dist/composer/authoring/archetypes/thesis_fund.py +103 -0
  19. package/dist/composer/authoring/archetypes/trend_momentum.py +132 -0
  20. package/dist/composer/authoring/builder.py +191 -0
  21. package/dist/composer/authoring/emit.py +264 -0
  22. package/dist/composer/authoring/gaps.py +115 -0
  23. package/dist/composer/authoring/generate.py +131 -0
  24. package/dist/composer/authoring/presets.py +168 -0
  25. package/dist/composer/authoring/runtime_emit.py +266 -0
  26. package/dist/composer/authoring/strategy_manifest.py +94 -0
  27. package/dist/composer/cli.py +487 -0
  28. package/dist/composer/compiler/__init__.py +22 -0
  29. package/dist/composer/compiler/compile.py +739 -0
  30. package/dist/composer/examples/breakout_swing.graph.yaml +121 -0
  31. package/dist/composer/examples/conviction_scorer.graph.yaml +216 -0
  32. package/dist/composer/examples/macro_thesis_basket.graph.yaml +247 -0
  33. package/dist/composer/examples/pre_listing_classifier.graph.yaml +204 -0
  34. package/dist/composer/examples/trend_momentum_majors.graph.yaml +133 -0
  35. package/dist/composer/generated/README.md +22 -0
  36. package/dist/composer/generated/catalog.md +118 -0
  37. package/dist/composer/generated/describe.md +1168 -0
  38. package/dist/composer/generated/graph.schema.json +1946 -0
  39. package/dist/composer/primitives/__init__.py +320 -0
  40. package/dist/composer/primitives/_candles.py +76 -0
  41. package/dist/composer/primitives/adapter.py +363 -0
  42. package/dist/composer/primitives/emitters.py +142 -0
  43. package/dist/composer/primitives/filters.py +71 -0
  44. package/dist/composer/primitives/indicators.py +326 -0
  45. package/dist/composer/primitives/rankers.py +40 -0
  46. package/dist/composer/primitives/scorers.py +100 -0
  47. package/dist/composer/primitives/sources.py +979 -0
  48. package/dist/composer/primitives/stateful.py +254 -0
  49. package/dist/composer/pure_fn/__init__.py +34 -0
  50. package/dist/composer/pure_fn/checks.py +39 -0
  51. package/dist/composer/pure_fn/models.py +177 -0
  52. package/dist/composer/pure_fn/purity.py +311 -0
  53. package/dist/composer/pure_fn/runtests.py +155 -0
  54. package/dist/composer/registry/__init__.py +40 -0
  55. package/dist/composer/registry/generate.py +425 -0
  56. package/dist/composer/registry/mcp-tools-snapshot.json +193 -0
  57. package/dist/composer/registry/mcp_closure.py +311 -0
  58. package/dist/composer/registry/models.py +417 -0
  59. package/dist/composer/registry/nodes.py +1297 -0
  60. package/dist/composer/requirements.txt +21 -0
  61. package/dist/composer/scaffold_path.py +118 -0
  62. package/dist/composer/templates/__init__.py +13 -0
  63. package/dist/composer/templates/scan.py.j2 +34 -0
  64. package/dist/composer/validator/__init__.py +29 -0
  65. package/dist/composer/validator/desugar.py +133 -0
  66. package/dist/composer/validator/errors.py +227 -0
  67. package/dist/composer/validator/graph_checks.py +443 -0
  68. package/dist/composer/validator/loader.py +110 -0
  69. package/dist/composer/validator/schema_checks.py +147 -0
  70. package/dist/composer/validator/validate.py +86 -0
  71. package/dist/composer/vendoring.py +103 -0
  72. package/dist/composer/verbs/__init__.py +49 -0
  73. package/dist/composer/verbs/_box.py +308 -0
  74. package/dist/composer/verbs/check.py +254 -0
  75. package/dist/composer/verbs/close.py +494 -0
  76. package/dist/composer/verbs/deploy.py +279 -0
  77. package/dist/composer/verbs/docs.py +30 -0
  78. package/dist/composer/verbs/fund.py +498 -0
  79. package/dist/composer/verbs/install.py +586 -0
  80. package/dist/composer/verbs/runtime_validate.py +422 -0
  81. package/dist/composer/verbs/smoke.py +134 -0
  82. package/dist/composer/verbs/status.py +383 -0
  83. package/dist/index.d.ts.map +1 -1
  84. package/dist/index.js +2 -9
  85. package/dist/index.js.map +1 -1
  86. package/dist/runtime/load-runtime-config.d.ts +17 -0
  87. package/dist/runtime/load-runtime-config.d.ts.map +1 -1
  88. package/dist/runtime/load-runtime-config.js +2 -2
  89. package/dist/runtime/load-runtime-config.js.map +1 -1
  90. package/dist/runtime-api/config.d.ts +2 -2
  91. package/dist/runtime-api/config.js +4 -4
  92. package/dist/runtime-api/config.js.map +1 -1
  93. package/dist/runtime-api/handlers/ingest-signals.d.ts +3 -5
  94. package/dist/runtime-api/handlers/ingest-signals.d.ts.map +1 -1
  95. package/dist/runtime-api/handlers/ingest-signals.js +5 -14
  96. package/dist/runtime-api/handlers/ingest-signals.js.map +1 -1
  97. package/dist/runtime-api/intake/intake-mount.d.ts.map +1 -1
  98. package/dist/runtime-api/intake/intake-mount.js +2 -8
  99. package/dist/runtime-api/intake/intake-mount.js.map +1 -1
  100. package/dist/skills-manager/manifest.d.ts.map +1 -1
  101. package/dist/skills-manager/manifest.js +1 -3
  102. package/dist/skills-manager/manifest.js.map +1 -1
  103. package/dist/skills-manager/skills-manifest.json +1 -3
  104. package/package.json +4 -2
  105. package/dist/runtime-api/intake/ingest-mutex.d.ts +0 -16
  106. package/dist/runtime-api/intake/ingest-mutex.d.ts.map +0 -1
  107. package/dist/runtime-api/intake/ingest-mutex.js +0 -18
  108. 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