programgarden-core 1.30.0__tar.gz → 1.31.0__tar.gz

{programgarden_core-1.30.0 → programgarden_core-1.31.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: programgarden-core
-Version: 1.30.0
+Version: 1.31.0
 Summary: ProgramGarden Core - 노드 기반 DSL 핵심 타입 정의
 License-Expression: AGPL-3.0-or-later
 Author: 프로그램동산
@@ -11,6 +11,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Requires-Dist: pydantic (>=2.0.0,<3.0.0)
+Requires-Dist: tzdata (>=2025.2,<2026.0)
 Description-Content-Type: text/markdown
 
 # ProgramGarden Core
@@ -24,7 +25,7 @@ ProgramGarden은 AI 시대에 맞춰 파이썬을 모르는 투자자도 개인
 
 ## 주요 특징
 
-- **노드 기반 DSL**: 68개 내장 노드를 조합하여 워크플로우를 정의하는 도메인 특화 언어
+- **노드 기반 DSL**: 73 core nodes를 조합하여 워크플로우를 정의하는 도메인 특화 언어
 - **타입 안전한 스키마**: Pydantic 모델 기반의 FieldSchema, 입출력 포트 정의로 IDE 친화적이고 안전한 개발
 - **레지스트리 시스템**: NodeTypeRegistry와 PluginRegistry로 노드/플러그인 메타데이터 관리
 - **다국어 지원(i18n)**: 한국어/영어 번역 파일을 통한 노드 설명, 필드명 자동 번역
@@ -42,23 +43,23 @@ poetry add programgarden-core
 
 요구 사항: Python 3.12+
 
-## 노드 카테고리 (11개, 68개 코어 노드)
+## Node categories (11 categories, 73 core nodes)
 
 | 카테고리 | 노드 수 | 대표 노드 |
 |----------|---------|----------|
 | infra | 8 | StartNode, BrokerNode, ThrottleNode, SplitNode, AggregateNode, IfNode, KoreaStockBrokerNode |
-| account | 12 | AccountNode, OpenOrdersNode, RealAccountNode, RealOrderEventNode (해외주식/선물 + 국내주식) |
-| market | 20 | MarketDataNode, HistoricalDataNode, RealMarketDataNode, WatchlistNode, ExclusionListNode, CurrencyRateNode, KoreaStock* |
+| account | 13 | AccountNode, OpenOrdersNode, RealAccountNode, RealOrderEventNode (해외주식/선물 + 국내주식) |
+| market | 22 | MarketDataNode, HistoricalDataNode, RealMarketDataNode, WatchlistNode, ExclusionListNode, CurrencyRateNode, KoreaStock* |
 | condition | 2 | ConditionNode, LogicNode |
 | order | 10 | NewOrderNode, ModifyOrderNode, CancelOrderNode, PositionSizingNode (해외주식/선물 + 국내주식) |
 | risk | 1 | PortfolioNode |
-| schedule | 2 | ScheduleNode, TradingHoursFilterNode |
-| data | 3 | SQLiteNode, HTTPRequestNode, FieldMappingNode |
+| schedule | 3 | ScheduleNode, TradingHoursFilterNode, SessionGateNode |
+| data | 4 | SQLiteNode, HTTPRequestNode, FieldMappingNode, CodeNode |
 | display | 6 | TableDisplayNode, LineChartNode, CandlestickChartNode, SummaryDisplayNode |
 | analysis | 2 | BacktestEngineNode, BenchmarkCompareNode |
 | ai | 2 | LLMModelNode, AIAgentNode |
 
-> community 패키지에서 4개 노드 추가: TelegramNode(messaging), FearGreedIndexNode(market), FundamentalDataNode(market), FileReaderNode(data) → 전체 73개
+> Community adds five nodes: TelegramNode, FearGreedIndexNode, FundamentalDataNode, FileReaderNode and PerformanceReportNode, for 78 total.
 
 ## 사용 예시
 
@@ -85,7 +86,7 @@ print(schema.config_schema)
 
 ```
 programgarden_core/
-├── nodes/          # 69개 노드 정의 (base.py, infra.py, account.py, ...)
+├── nodes/          # 73 core node definitions
 ├── bases/          # Finance 베이스 클래스
 ├── models/         # Pydantic 모델 (FieldSchema, Edge, WorkflowDefinition 등)
 ├── registry/       # NodeTypeRegistry, PluginRegistry
@@ -131,3 +132,14 @@ unbound or cross-product nodes. Reuse one broker for all consumers. Account-free
 workflows and unrelated credentials remain supported. See
 [the shared contract](../../docs/workflow_account_policy.md).
 
+
+## Cancellation result contract (unreleased P4)
+
+CancelOrder metadata describes request acknowledgement (`accepted`,
+`confirmation_pending=true`), not final cancellation. Replacement orders require
+separate matching completion evidence. See
+[the cancellation contract](../../docs/cancellation-acknowledgements.md).
+
+Session windows and IfNode routing inside Split are described in
+[Session gates and guarded Split](../../docs/session-gates-and-guarded-split.md).
+

{programgarden_core-1.30.0 → programgarden_core-1.31.0}/README.md

@@ -9,7 +9,7 @@ ProgramGarden은 AI 시대에 맞춰 파이썬을 모르는 투자자도 개인
 
 ## 주요 특징
 
-- **노드 기반 DSL**: 68개 내장 노드를 조합하여 워크플로우를 정의하는 도메인 특화 언어
+- **노드 기반 DSL**: 73 core nodes를 조합하여 워크플로우를 정의하는 도메인 특화 언어
 - **타입 안전한 스키마**: Pydantic 모델 기반의 FieldSchema, 입출력 포트 정의로 IDE 친화적이고 안전한 개발
 - **레지스트리 시스템**: NodeTypeRegistry와 PluginRegistry로 노드/플러그인 메타데이터 관리
 - **다국어 지원(i18n)**: 한국어/영어 번역 파일을 통한 노드 설명, 필드명 자동 번역
@@ -27,23 +27,23 @@ poetry add programgarden-core
 
 요구 사항: Python 3.12+
 
-## 노드 카테고리 (11개, 68개 코어 노드)
+## Node categories (11 categories, 73 core nodes)
 
 | 카테고리 | 노드 수 | 대표 노드 |
 |----------|---------|----------|
 | infra | 8 | StartNode, BrokerNode, ThrottleNode, SplitNode, AggregateNode, IfNode, KoreaStockBrokerNode |
-| account | 12 | AccountNode, OpenOrdersNode, RealAccountNode, RealOrderEventNode (해외주식/선물 + 국내주식) |
-| market | 20 | MarketDataNode, HistoricalDataNode, RealMarketDataNode, WatchlistNode, ExclusionListNode, CurrencyRateNode, KoreaStock* |
+| account | 13 | AccountNode, OpenOrdersNode, RealAccountNode, RealOrderEventNode (해외주식/선물 + 국내주식) |
+| market | 22 | MarketDataNode, HistoricalDataNode, RealMarketDataNode, WatchlistNode, ExclusionListNode, CurrencyRateNode, KoreaStock* |
 | condition | 2 | ConditionNode, LogicNode |
 | order | 10 | NewOrderNode, ModifyOrderNode, CancelOrderNode, PositionSizingNode (해외주식/선물 + 국내주식) |
 | risk | 1 | PortfolioNode |
-| schedule | 2 | ScheduleNode, TradingHoursFilterNode |
-| data | 3 | SQLiteNode, HTTPRequestNode, FieldMappingNode |
+| schedule | 3 | ScheduleNode, TradingHoursFilterNode, SessionGateNode |
+| data | 4 | SQLiteNode, HTTPRequestNode, FieldMappingNode, CodeNode |
 | display | 6 | TableDisplayNode, LineChartNode, CandlestickChartNode, SummaryDisplayNode |
 | analysis | 2 | BacktestEngineNode, BenchmarkCompareNode |
 | ai | 2 | LLMModelNode, AIAgentNode |
 
-> community 패키지에서 4개 노드 추가: TelegramNode(messaging), FearGreedIndexNode(market), FundamentalDataNode(market), FileReaderNode(data) → 전체 73개
+> Community adds five nodes: TelegramNode, FearGreedIndexNode, FundamentalDataNode, FileReaderNode and PerformanceReportNode, for 78 total.
 
 ## 사용 예시
 
@@ -70,7 +70,7 @@ print(schema.config_schema)
 
 ```
 programgarden_core/
-├── nodes/          # 69개 노드 정의 (base.py, infra.py, account.py, ...)
+├── nodes/          # 73 core node definitions
 ├── bases/          # Finance 베이스 클래스
 ├── models/         # Pydantic 모델 (FieldSchema, Edge, WorkflowDefinition 등)
 ├── registry/       # NodeTypeRegistry, PluginRegistry
@@ -115,3 +115,14 @@ connection. Additional connections produce `DUPLICATE_BROKER_NODE`, including
 unbound or cross-product nodes. Reuse one broker for all consumers. Account-free
 workflows and unrelated credentials remain supported. See
 [the shared contract](../../docs/workflow_account_policy.md).
+
+
+## Cancellation result contract (unreleased P4)
+
+CancelOrder metadata describes request acknowledgement (`accepted`,
+`confirmation_pending=true`), not final cancellation. Replacement orders require
+separate matching completion evidence. See
+[the cancellation contract](../../docs/cancellation-acknowledgements.md).
+
+Session windows and IfNode routing inside Split are described in
+[Session gates and guarded Split](../../docs/session-gates-and-guarded-split.md).

{programgarden_core-1.30.0 → programgarden_core-1.31.0}/programgarden_core/__init__.py

@@ -88,6 +88,7 @@ __all__ = [
     # Nodes - Trigger
     "ScheduleNode",
     "TradingHoursFilterNode",
+    "SessionGateNode",
     # Nodes - Condition
     "ConditionNode",
     "LogicNode",

{programgarden_core-1.30.0 → programgarden_core-1.31.0}/programgarden_core/i18n/locales/en.json

@@ -931,10 +931,10 @@
   "ports.blocked_reason": "Block reason",
   "ports.blocked_symbols": "Blocked symbols",
   "ports.buy_signal": "Buy signal",
-  "ports.cancel_result": "Cancel result",
+  "ports.cancel_result": "Cancel request result",
   "ports.cancel_trigger": "Cancel execution trigger",
   "ports.cancelled": "Order cancelled",
-  "ports.cancelled_order_id": "Cancelled order ID",
+  "ports.cancelled_order_id": "Cancellation target order ID",
   "ports.cancelled_orders": "Cancelled orders",
   "ports.closed": "Exchange closed",
   "ports.combined_curve": "Combined equity curve",
@@ -1344,5 +1344,17 @@
   "fields.OverseasFuturesOrderableQuantityNode.query_type": "New positions, liquidation or total capacity.",
   "enums.query_type.new": "New",
   "enums.query_type.close": "Liquidation",
-  "enums.query_type.total": "Total"
+  "enums.query_type.total": "Total",
+  "nodes.SessionGateNode.allowed": "True only inside a configured window; bind to IfNode.",
+  "nodes.SessionGateNode.closed_dates": "Explicit YYYY-MM-DD exclusions. Either local calendar date or opening date blocks the window.",
+  "nodes.SessionGateNode.days": "Allowed opening weekdays. The post-midnight portion belongs to the previous opening day.",
+  "nodes.SessionGateNode.description": "Check configured local windows immediately; enforce allowed using IfNode.",
+  "nodes.SessionGateNode.local_date": "Current calendar date in the configured timezone.",
+  "nodes.SessionGateNode.local_time": "Current local ISO timestamp including UTC offset.",
+  "nodes.SessionGateNode.name": "Session gate",
+  "nodes.SessionGateNode.reason": "inside_configured_window or outside_configured_window.",
+  "nodes.SessionGateNode.session_date": "Opening date of the matched window, or an empty string when blocked.",
+  "nodes.SessionGateNode.timezone": "IANA timezone; daylight-saving transitions use the installed timezone database.",
+  "nodes.SessionGateNode.trigger": "Evaluate the current local time when triggered.",
+  "nodes.SessionGateNode.windows": "Local HH:MM start/end windows; start inclusive, end exclusive. Overnight windows are supported."
 }

{programgarden_core-1.30.0 → programgarden_core-1.31.0}/programgarden_core/i18n/locales/ko.json

@@ -931,10 +931,10 @@
   "ports.blocked_reason": "차단 사유",
   "ports.blocked_symbols": "차단된 종목",
   "ports.buy_signal": "매수 시그널",
-  "ports.cancel_result": "취소 결과",
+  "ports.cancel_result": "취소 요청 결과",
   "ports.cancel_trigger": "취소 실행 트리거",
   "ports.cancelled": "취소됨",
-  "ports.cancelled_order_id": "취소된 주문번호",
+  "ports.cancelled_order_id": "취소 대상 주문번호",
   "ports.cancelled_orders": "취소된 주문",
   "ports.closed": "거래소 폐장",
   "ports.combined_curve": "통합 자산 곡선",
@@ -1344,5 +1344,17 @@
   "fields.OverseasFuturesOrderableQuantityNode.query_type": "신규 진입·청산·총 주문가능수량 중 조회할 항목입니다.",
   "enums.query_type.new": "신규",
   "enums.query_type.close": "청산",
-  "enums.query_type.total": "총가능"
+  "enums.query_type.total": "총가능",
+  "nodes.SessionGateNode.allowed": "허용 구간 안에서만 true입니다. IfNode에 연결하세요.",
+  "nodes.SessionGateNode.closed_dates": "YYYY-MM-DD 제외일 목록입니다. 현지 날짜 또는 구간 시작 날짜가 해당하면 차단합니다.",
+  "nodes.SessionGateNode.days": "시작일 기준 허용 요일입니다. 자정 이후 구간은 전날의 시작 요일에 속합니다.",
+  "nodes.SessionGateNode.description": "설정한 현지 시간대를 즉시 확인합니다. IfNode로 허용 여부를 분기하세요.",
+  "nodes.SessionGateNode.local_date": "설정한 시간대의 현재 날짜입니다.",
+  "nodes.SessionGateNode.local_time": "UTC 오프셋을 포함한 현재 현지 ISO 시각입니다.",
+  "nodes.SessionGateNode.name": "거래 시간대 확인",
+  "nodes.SessionGateNode.reason": "inside_configured_window 또는 outside_configured_window입니다.",
+  "nodes.SessionGateNode.session_date": "허용 구간의 시작일입니다. 차단되면 빈 문자열입니다.",
+  "nodes.SessionGateNode.timezone": "IANA 시간대입니다. 설치된 시간대 데이터로 서머타임을 반영합니다.",
+  "nodes.SessionGateNode.trigger": "실행 시점의 현지 시간을 확인합니다.",
+  "nodes.SessionGateNode.windows": "현지 HH:MM 구간입니다. 시작은 포함하고 종료는 제외하며 자정을 넘는 구간도 지원합니다."
 }

{programgarden_core-1.30.0 → programgarden_core-1.31.0}/programgarden_core/nodes/__init__.py

@@ -62,6 +62,7 @@ from programgarden_core.nodes.symbol import (
     SymbolFilterNode,
     ExclusionListNode,
 )
+from programgarden_core.nodes.session_gate import SessionGateNode
 from programgarden_core.nodes.trigger import (
     ScheduleNode,
     TradingHoursFilterNode,
@@ -164,6 +165,7 @@ __all__ = [
     # Trigger
     "ScheduleNode",
     "TradingHoursFilterNode",
+    "SessionGateNode",
     # Condition
     "ConditionNode",
     "LogicNode",

{programgarden_core-1.30.0 → programgarden_core-1.31.0}/programgarden_core/nodes/account_futures.py

@@ -116,7 +116,7 @@ class OverseasFuturesAccountNode(BaseNode):
         },
         {
             "title": "Margin check before futures order",
-            "description": "Read account margin and place a new order only when available margin exceeds the threshold.",
+            "description": 'Read account margin and place a new order only when available margin exceeds the threshold. Component demonstration only: add validated signal, account/pending, sizing, session and persistent duplicate-submission guards before live trading.',
             "workflow_snippet": {
                 "id": "futures-account-margin-check",
                 "name": "Futures Margin Check",
@@ -125,7 +125,7 @@ class OverseasFuturesAccountNode(BaseNode):
                     {"id": "broker", "type": "OverseasFuturesBrokerNode", "credential_id": "futures_cred", "paper_trading": True},
                     {"id": "account", "type": "OverseasFuturesAccountNode"},
                     {"id": "if_margin", "type": "IfNode", "left": "{{ nodes.account.balance.orderable_amount }}", "operator": ">=", "right": 10000},
-                    {"id": "order", "type": "OverseasFuturesNewOrderNode", "symbol": "ESH26", "exchange": "CME", "side": "buy", "order_type": "limit", "quantity": 1, "price": 5200.0},
+                    {'id': 'order', 'type': 'OverseasFuturesNewOrderNode', 'side': 'buy', 'order_type': 'limit', 'order': {'symbol': 'ESH26', 'exchange': 'CME', 'quantity': 1, 'price': 5200.0}},
                 ],
                 "edges": [
                     {"from": "start", "to": "broker"},

{programgarden_core-1.30.0 → programgarden_core-1.31.0}/programgarden_core/nodes/account_korea_stock.py

@@ -115,7 +115,7 @@ class KoreaStockAccountNode(BaseNode):
         },
         {
             "title": "Cash check before Korea stock order",
-            "description": "Read account balance and only place an order when orderable cash exceeds 1,000,000 KRW.",
+            "description": 'Read account balance and only place an order when orderable cash exceeds 1,000,000 KRW. Component demonstration only: add validated signal, account/pending, sizing, session and persistent duplicate-submission guards before live trading.',
             "workflow_snippet": {
                 "id": "korea-stock-cash-check",
                 "name": "Korea Stock Cash Check",
@@ -124,7 +124,7 @@ class KoreaStockAccountNode(BaseNode):
                     {"id": "broker", "type": "KoreaStockBrokerNode", "credential_id": "broker_cred"},
                     {"id": "account", "type": "KoreaStockAccountNode"},
                     {"id": "if_cash", "type": "IfNode", "left": "{{ nodes.account.balance.orderable_amount }}", "operator": ">=", "right": 1000000},
-                    {"id": "order", "type": "KoreaStockNewOrderNode", "symbol": "005930", "side": "buy", "order_type": "limit", "quantity": 1, "price": 75000},
+                    {'id': 'order', 'type': 'KoreaStockNewOrderNode', 'side': 'buy', 'order_type': 'limit', 'order': {'symbol': '005930', 'quantity': 1, 'price': 75000}},
                 ],
                 "edges": [
                     {"from": "start", "to": "broker"},

{programgarden_core-1.30.0 → programgarden_core-1.31.0}/programgarden_core/nodes/backtest_futures.py

@@ -125,17 +125,17 @@ class OverseasFuturesHistoricalDataNode(BaseNode):
                 "nodes": [
                     {"id": "start", "type": "StartNode"},
                     {"id": "broker", "type": "OverseasFuturesBrokerNode", "credential_id": "broker_cred", "paper_trading": False},
-                    {"id": "split", "type": "SplitNode", "items": [{"symbol": "ESH26", "exchange": "CME"}]},
+                    {'id': 'split', 'type': 'SplitNode', 'array': [{'symbol': 'ESH26', 'exchange': 'CME'}]},
                     {"id": "historical", "type": "OverseasFuturesHistoricalDataNode", "symbol": "{{ nodes.split.item }}", "start_date": "{{ date.ago(60, format='yyyymmdd') }}", "end_date": "{{ date.today(format='yyyymmdd') }}", "interval": "1d", "adjust": False},
                     {"id": "condition", "type": "ConditionNode", "plugin": "BollingerBands", "items": {"from": "{{ item.time_series }}", "extract": {"symbol": "{{ item.symbol }}", "exchange": "{{ item.exchange }}", "date": "{{ row.date }}", "close": "{{ row.close }}"}}, "fields": {"period": 20, "std": 2.0, "direction": "below_lower"}},
-                ],
+                {'id': 'split_results', 'type': 'AggregateNode', 'mode': 'collect'}],
                 "edges": [
                     {"from": "start", "to": "broker"},
                     {"from": "broker", "to": "split"},
                     {"from": "split", "to": "historical"},
                     {"from": "broker", "to": "historical"},
                     {"from": "historical", "to": "condition"},
-                ],
+                {'from': 'condition', 'to': 'split_results'}],
                 "credentials": [
                     {
                         "credential_id": "broker_cred",
@@ -158,17 +158,17 @@ class OverseasFuturesHistoricalDataNode(BaseNode):
                 "nodes": [
                     {"id": "start", "type": "StartNode"},
                     {"id": "broker", "type": "OverseasFuturesBrokerNode", "credential_id": "broker_cred", "paper_trading": False},
-                    {"id": "split", "type": "SplitNode", "items": [{"symbol": "MHIH26", "exchange": "HKEX"}]},
+                    {'id': 'split', 'type': 'SplitNode', 'array': [{'symbol': 'MHIH26', 'exchange': 'HKEX'}]},
                     {"id": "historical", "type": "OverseasFuturesHistoricalDataNode", "symbol": "{{ nodes.split.item }}", "start_date": "{{ date.ago(10, format='yyyymmdd') }}", "end_date": "{{ date.today(format='yyyymmdd') }}", "interval": "1h", "adjust": False},
                     {"id": "condition", "type": "ConditionNode", "plugin": "MACD", "items": {"from": "{{ item.time_series }}", "extract": {"symbol": "{{ item.symbol }}", "exchange": "{{ item.exchange }}", "date": "{{ row.date }}", "close": "{{ row.close }}"}}, "fields": {"fast": 12, "slow": 26, "signal": 9, "direction": "bullish_cross"}},
-                ],
+                {'id': 'split_results', 'type': 'AggregateNode', 'mode': 'collect'}],
                 "edges": [
                     {"from": "start", "to": "broker"},
                     {"from": "broker", "to": "split"},
                     {"from": "split", "to": "historical"},
                     {"from": "broker", "to": "historical"},
                     {"from": "historical", "to": "condition"},
-                ],
+                {'from': 'condition', 'to': 'split_results'}],
                 "credentials": [
                     {
                         "credential_id": "broker_cred",

{programgarden_core-1.30.0 → programgarden_core-1.31.0}/programgarden_core/nodes/backtest_korea_stock.py

@@ -125,17 +125,17 @@ class KoreaStockHistoricalDataNode(BaseNode):
                 "nodes": [
                     {"id": "start", "type": "StartNode"},
                     {"id": "broker", "type": "KoreaStockBrokerNode", "credential_id": "broker_cred"},
-                    {"id": "split", "type": "SplitNode", "items": [{"symbol": "005930"}]},
+                    {'id': 'split', 'type': 'SplitNode', 'array': [{'symbol': '005930'}]},
                     {"id": "historical", "type": "KoreaStockHistoricalDataNode", "symbol": "{{ nodes.split.item }}", "start_date": "{{ date.ago(60, format='yyyymmdd') }}", "end_date": "{{ date.today(format='yyyymmdd') }}", "interval": "1d", "adjust": True},
                     {"id": "condition", "type": "ConditionNode", "plugin": "RSI", "items": {"from": "{{ item.time_series }}", "extract": {"symbol": "{{ item.symbol }}", "exchange": "{{ item.exchange }}", "date": "{{ row.date }}", "close": "{{ row.close }}"}}, "fields": {"period": 14, "threshold": 30, "direction": "below"}},
-                ],
+                {'id': 'split_results', 'type': 'AggregateNode', 'mode': 'collect'}],
                 "edges": [
                     {"from": "start", "to": "broker"},
                     {"from": "broker", "to": "split"},
                     {"from": "split", "to": "historical"},
                     {"from": "broker", "to": "historical"},
                     {"from": "historical", "to": "condition"},
-                ],
+                {'from': 'condition', 'to': 'split_results'}],
                 "credentials": [
                     {
                         "credential_id": "broker_cred",
@@ -158,17 +158,17 @@ class KoreaStockHistoricalDataNode(BaseNode):
                 "nodes": [
                     {"id": "start", "type": "StartNode"},
                     {"id": "broker", "type": "KoreaStockBrokerNode", "credential_id": "broker_cred"},
-                    {"id": "split", "type": "SplitNode", "items": [{"symbol": "247540"}]},
+                    {'id': 'split', 'type': 'SplitNode', 'array': [{'symbol': '247540'}]},
                     {"id": "historical", "type": "KoreaStockHistoricalDataNode", "symbol": "{{ nodes.split.item }}", "start_date": "{{ date.ago(365, format='yyyymmdd') }}", "end_date": "{{ date.today(format='yyyymmdd') }}", "interval": "1w", "adjust": True},
                     {"id": "condition", "type": "ConditionNode", "plugin": "BollingerBands", "items": {"from": "{{ item.time_series }}", "extract": {"symbol": "{{ item.symbol }}", "exchange": "{{ item.exchange }}", "date": "{{ row.date }}", "close": "{{ row.close }}"}}, "fields": {"period": 20, "std": 2.0, "direction": "below_lower"}},
-                ],
+                {'id': 'split_results', 'type': 'AggregateNode', 'mode': 'collect'}],
                 "edges": [
                     {"from": "start", "to": "broker"},
                     {"from": "broker", "to": "split"},
                     {"from": "split", "to": "historical"},
                     {"from": "broker", "to": "historical"},
                     {"from": "historical", "to": "condition"},
-                ],
+                {'from': 'condition', 'to': 'split_results'}],
                 "credentials": [
                     {
                         "credential_id": "broker_cred",

{programgarden_core-1.30.0 → programgarden_core-1.31.0}/programgarden_core/nodes/backtest_stock.py

@@ -125,17 +125,17 @@ class OverseasStockHistoricalDataNode(BaseNode):
                 "nodes": [
                     {"id": "start", "type": "StartNode"},
                     {"id": "broker", "type": "OverseasStockBrokerNode", "credential_id": "broker_cred", "paper_trading": False},
-                    {"id": "split", "type": "SplitNode", "items": [{"symbol": "AAPL", "exchange": "NASDAQ"}]},
+                    {'id': 'split', 'type': 'SplitNode', 'array': [{'symbol': 'AAPL', 'exchange': 'NASDAQ'}]},
                     {"id": "historical", "type": "OverseasStockHistoricalDataNode", "symbol": "{{ nodes.split.item }}", "start_date": "{{ date.ago(30, format='yyyymmdd') }}", "end_date": "{{ date.today(format='yyyymmdd') }}", "interval": "1d", "adjust": False},
                     {"id": "condition", "type": "ConditionNode", "plugin": "RSI", "items": {"from": "{{ item.time_series }}", "extract": {"symbol": "{{ item.symbol }}", "exchange": "{{ item.exchange }}", "date": "{{ row.date }}", "close": "{{ row.close }}"}}, "fields": {"period": 14, "threshold": 30, "direction": "below"}},
-                ],
+                {'id': 'split_results', 'type': 'AggregateNode', 'mode': 'collect'}],
                 "edges": [
                     {"from": "start", "to": "broker"},
                     {"from": "broker", "to": "split"},
                     {"from": "split", "to": "historical"},
                     {"from": "broker", "to": "historical"},
                     {"from": "historical", "to": "condition"},
-                ],
+                {'from': 'condition', 'to': 'split_results'}],
                 "credentials": [
                     {
                         "credential_id": "broker_cred",
@@ -158,17 +158,17 @@ class OverseasStockHistoricalDataNode(BaseNode):
                 "nodes": [
                     {"id": "start", "type": "StartNode"},
                     {"id": "broker", "type": "OverseasStockBrokerNode", "credential_id": "broker_cred", "paper_trading": False},
-                    {"id": "split", "type": "SplitNode", "items": [{"symbol": "MSFT", "exchange": "NASDAQ"}]},
+                    {'id': 'split', 'type': 'SplitNode', 'array': [{'symbol': 'MSFT', 'exchange': 'NASDAQ'}]},
                     {"id": "historical", "type": "OverseasStockHistoricalDataNode", "symbol": "{{ nodes.split.item }}", "start_date": "{{ date.ago(5, format='yyyymmdd') }}", "end_date": "{{ date.today(format='yyyymmdd') }}", "interval": "5m", "adjust": False},
                     {"id": "condition", "type": "ConditionNode", "plugin": "MACD", "items": {"from": "{{ item.time_series }}", "extract": {"symbol": "{{ item.symbol }}", "exchange": "{{ item.exchange }}", "date": "{{ row.date }}", "close": "{{ row.close }}"}}, "fields": {"fast": 12, "slow": 26, "signal": 9, "direction": "bullish_cross"}},
-                ],
+                {'id': 'split_results', 'type': 'AggregateNode', 'mode': 'collect'}],
                 "edges": [
                     {"from": "start", "to": "broker"},
                     {"from": "broker", "to": "split"},
                     {"from": "split", "to": "historical"},
                     {"from": "broker", "to": "historical"},
                     {"from": "historical", "to": "condition"},
-                ],
+                {'from': 'condition', 'to': 'split_results'}],
                 "credentials": [
                     {
                         "credential_id": "broker_cred",

{programgarden_core-1.30.0 → programgarden_core-1.31.0}/programgarden_core/nodes/broker.py

@@ -150,7 +150,7 @@ class OverseasStockBrokerNode(BaseBrokerNode):
         },
         {
             "title": "Broker → Historical → Condition → Order",
-            "description": "Full trading path: broker session feeds historical data, a condition plugin decides, then the order node fires when the condition passes.",
+            "description": 'Full trading path: broker session feeds historical data, a condition plugin decides, then the order node fires when the condition passes. Component demonstration only: add validated signal, account/pending, sizing, session and persistent duplicate-submission guards before live trading.',
             "workflow_snippet": {
                 "id": "broker-stock-trade",
                 "name": "Broker + RSI + order",
@@ -181,7 +181,7 @@ class OverseasStockBrokerNode(BaseBrokerNode):
                         },
                         "fields": {"period": 14, "threshold": 30, "direction": "below"},
                     },
-                    {"id": "order", "type": "OverseasStockNewOrderNode", "symbol": "AAPL", "exchange": "NASDAQ", "side": "buy", "quantity": 1, "price": 150.0},
+                    {'id': 'order', 'type': 'OverseasStockNewOrderNode', 'side': 'buy', 'order': {'symbol': 'AAPL', 'exchange': 'NASDAQ', 'quantity': 1, 'price': 150.0}},
                 ],
                 "edges": [
                     {"from": "start", "to": "broker"},

{programgarden_core-1.30.0 → programgarden_core-1.31.0}/programgarden_core/nodes/data.py

@@ -212,7 +212,7 @@ class SQLiteNode(BaseNode):
                         "operation": "simple",
                         "table": "hwm",
                         "action": "upsert",
-                        "values": {"symbol": "{{ nodes.market.value.symbol }}", "peak": "{{ nodes.market.value.current_price }}"},
+                        "values": {"symbol": "{{ nodes.market.value.symbol }}", "peak": '{{ nodes.market.value.price }}'},
                         "on_conflict": "symbol",
                     },
                     {

{programgarden_core-1.30.0 → programgarden_core-1.31.0}/programgarden_core/nodes/display.py

@@ -209,7 +209,7 @@ class TableDisplayNode(BaseDisplayNode):
                     {"id": "start", "type": "StartNode"},
                     {"id": "broker", "type": "OverseasStockBrokerNode", "credential_id": "broker_cred", "paper_trading": False},
                     {"id": "account", "type": "OverseasStockAccountNode"},
-                    {"id": "table", "type": "TableDisplayNode", "title": "Current Positions", "data": "{{ nodes.account.positions }}", "columns": ["symbol", "exchange", "quantity", "avg_price", "pnl"], "sort_by": "pnl", "sort_order": "desc", "limit": 20},
+                    {"id": "table", "type": "TableDisplayNode", "title": "Current Positions", "data": "{{ nodes.account.positions }}", "columns": ["symbol", "exchange", "quantity", "avg_price", 'pnl_amount'], "sort_by": "pnl", "sort_order": "desc", "limit": 20},
                 ],
                 "edges": [
                     {"from": "start", "to": "broker"},

{programgarden_core-1.30.0 → programgarden_core-1.31.0}/programgarden_core/nodes/fundamental_korea_stock.py

@@ -109,17 +109,17 @@ class KoreaStockFundamentalNode(BaseNode):
                 "nodes": [
                     {"id": "start", "type": "StartNode"},
                     {"id": "broker", "type": "KoreaStockBrokerNode", "credential_id": "broker_cred"},
-                    {"id": "split", "type": "SplitNode", "items": [{"symbol": "005930"}, {"symbol": "000660"}]},
+                    {'id': 'split', 'type': 'SplitNode', 'array': [{'symbol': '005930'}, {'symbol': '000660'}]},
                     {"id": "fundamental", "type": "KoreaStockFundamentalNode", "symbol": "{{ nodes.split.item }}"},
                     {"id": "display", "type": "TableDisplayNode", "data": "{{ nodes.fundamental.value }}"},
-                ],
+                {'id': 'split_results', 'type': 'AggregateNode', 'mode': 'collect'}],
                 "edges": [
                     {"from": "start", "to": "broker"},
                     {"from": "broker", "to": "split"},
                     {"from": "split", "to": "fundamental"},
                     {"from": "broker", "to": "fundamental"},
                     {"from": "fundamental", "to": "display"},
-                ],
+                {'from': 'display', 'to': 'split_results'}],
                 "credentials": [
                     {
                         "credential_id": "broker_cred",
@@ -142,17 +142,17 @@ class KoreaStockFundamentalNode(BaseNode):
                 "nodes": [
                     {"id": "start", "type": "StartNode"},
                     {"id": "broker", "type": "KoreaStockBrokerNode", "credential_id": "broker_cred"},
-                    {"id": "split", "type": "SplitNode", "items": [{"symbol": "005930"}, {"symbol": "005380"}, {"symbol": "051910"}]},
+                    {'id': 'split', 'type': 'SplitNode', 'array': [{'symbol': '005930'}, {'symbol': '005380'}, {'symbol': '051910'}]},
                     {"id": "fundamental", "type": "KoreaStockFundamentalNode", "symbol": "{{ nodes.split.item }}"},
                     {"id": "display", "type": "TableDisplayNode", "data": "{{ nodes.fundamental.value }}"},
-                ],
+                {'id': 'split_results', 'type': 'AggregateNode', 'mode': 'collect'}],
                 "edges": [
                     {"from": "start", "to": "broker"},
                     {"from": "broker", "to": "split"},
                     {"from": "split", "to": "fundamental"},
                     {"from": "broker", "to": "fundamental"},
                     {"from": "fundamental", "to": "display"},
-                ],
+                {'from': 'display', 'to': 'split_results'}],
                 "credentials": [
                     {
                         "credential_id": "broker_cred",

{programgarden_core-1.30.0 → programgarden_core-1.31.0}/programgarden_core/nodes/fundamental_stock.py

@@ -108,17 +108,17 @@ class OverseasStockFundamentalNode(BaseNode):
                 "nodes": [
                     {"id": "start", "type": "StartNode"},
                     {"id": "broker", "type": "OverseasStockBrokerNode", "credential_id": "broker_cred", "paper_trading": False},
-                    {"id": "split", "type": "SplitNode", "items": [{"symbol": "AAPL", "exchange": "NASDAQ"}]},
+                    {'id': 'split', 'type': 'SplitNode', 'array': [{'symbol': 'AAPL', 'exchange': 'NASDAQ'}]},
                     {"id": "fundamental", "type": "OverseasStockFundamentalNode", "symbol": "{{ nodes.split.item }}"},
                     {"id": "display", "type": "TableDisplayNode", "data": "{{ nodes.fundamental.value }}"},
-                ],
+                {'id': 'split_results', 'type': 'AggregateNode', 'mode': 'collect'}],
                 "edges": [
                     {"from": "start", "to": "broker"},
                     {"from": "broker", "to": "split"},
                     {"from": "split", "to": "fundamental"},
                     {"from": "broker", "to": "fundamental"},
                     {"from": "fundamental", "to": "display"},
-                ],
+                {'from': 'display', 'to': 'split_results'}],
                 "credentials": [
                     {
                         "credential_id": "broker_cred",
@@ -141,17 +141,17 @@ class OverseasStockFundamentalNode(BaseNode):
                 "nodes": [
                     {"id": "start", "type": "StartNode"},
                     {"id": "broker", "type": "OverseasStockBrokerNode", "credential_id": "broker_cred", "paper_trading": False},
-                    {"id": "split", "type": "SplitNode", "items": [{"symbol": "AAPL", "exchange": "NASDAQ"}, {"symbol": "MSFT", "exchange": "NASDAQ"}]},
+                    {'id': 'split', 'type': 'SplitNode', 'array': [{'symbol': 'AAPL', 'exchange': 'NASDAQ'}, {'symbol': 'MSFT', 'exchange': 'NASDAQ'}]},
                     {"id": "fundamental", "type": "OverseasStockFundamentalNode", "symbol": "{{ nodes.split.item }}"},
                     {"id": "display", "type": "TableDisplayNode", "data": "{{ nodes.fundamental.value }}"},
-                ],
+                {'id': 'split_results', 'type': 'AggregateNode', 'mode': 'collect'}],
                 "edges": [
                     {"from": "start", "to": "broker"},
                     {"from": "broker", "to": "split"},
                     {"from": "split", "to": "fundamental"},
                     {"from": "broker", "to": "fundamental"},
                     {"from": "fundamental", "to": "display"},
-                ],
+                {'from': 'display', 'to': 'split_results'}],
                 "credentials": [
                     {
                         "credential_id": "broker_cred",