programgarden-core 2.5.3__tar.gz → 2.6.0__tar.gz

{programgarden_core-2.5.3 → programgarden_core-2.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: programgarden-core
-Version: 2.5.3
+Version: 2.6.0
 Summary: ProgramGarden Core - 노드 기반 DSL 핵심 타입 정의
 License-Expression: AGPL-3.0-or-later
 Author: 프로그램동산
@@ -19,6 +19,10 @@ US regular-session requests can opt into SessionGateNode.exchange_calendar (XNYS
 
 # ProgramGarden Core
 
+Unreleased schema additions: OverseasFuturesContractInfoNode, SQLiteNode's opt-in
+storage_scope=execution, and SessionGateNode's XHKG calendar. See the
+[runtime contract](../../docs/futures-contract-details-and-rollover-state.md).
+
 The REST overseas-stock position catalog declares `sellable_qty`, matching the
 broker-reported capacity preserved by the engine. Missing evidence remains null;
 see [the contract](../../docs/overseas-stock-sellable-quantity.md).

{programgarden_core-2.5.3 → programgarden_core-2.6.0}/README.md

@@ -2,6 +2,10 @@ US regular-session requests can opt into SessionGateNode.exchange_calendar (XNYS
 
 # ProgramGarden Core
 
+Unreleased schema additions: OverseasFuturesContractInfoNode, SQLiteNode's opt-in
+storage_scope=execution, and SessionGateNode's XHKG calendar. See the
+[runtime contract](../../docs/futures-contract-details-and-rollover-state.md).
+
 The REST overseas-stock position catalog declares `sellable_qty`, matching the
 broker-reported capacity preserved by the engine. Missing evidence remains null;
 see [the contract](../../docs/overseas-stock-sellable-quantity.md).

{programgarden_core-2.5.3 → programgarden_core-2.6.0}/programgarden_core/__init__.py

@@ -57,6 +57,7 @@ __all__ = [
     "OverseasFuturesRealMarketDataNode",
     "OverseasFuturesSymbolQueryNode",
     "FuturesContractNode",
+    "OverseasFuturesContractInfoNode",
     # Nodes - Market (국내주식)
     "KoreaStockMarketDataNode",
     "KoreaStockHistoricalDataNode",

{programgarden_core-2.5.3 → programgarden_core-2.6.0}/programgarden_core/i18n/locales/en.json

@@ -296,7 +296,6 @@
   "fields.PerformanceReportNode.risk_free_rate": "Annual risk-free rate as a fraction (e.g. 0.02 for 2%) for Sharpe/Sortino. Default 0.",
   "fields.HTTPRequestNode.auth_required": "Does the API require authentication? Leave unset to let the chatbot decide from context; set true for private APIs (a credential is then required), false for public APIs.",
   "fields.HTTPRequestNode.body": "Request body for POST/PUT/PATCH. Automatically serialized to JSON.",
-
   "fields.HTTPRequestNode.credential_id": "Credential ID for authentication. Supports: http_bearer, http_header, http_basic, http_query",
   "fields.HTTPRequestNode.headers": "HTTP headers. Click + to add custom headers (e.g., Content-Type, X-API-Key).",
   "fields.HTTPRequestNode.method": "HTTP method for the request",
@@ -602,7 +601,6 @@
   "fieldNames.PerformanceReportNode.risk_free_rate": "Risk-Free Rate",
   "fieldNames.HTTPRequestNode.auth_required": "Requires Auth",
   "fieldNames.HTTPRequestNode.body": "Request Body",
-
   "fieldNames.HTTPRequestNode.credential_id": "Credential",
   "fieldNames.HTTPRequestNode.headers": "Headers",
   "fieldNames.HTTPRequestNode.method": "HTTP Method",
@@ -877,7 +875,6 @@
   "ports.http_request_data": "Request data",
   "ports.http_response": "API response data",
   "ports.http_results": "Per-item results (one {item, response, status_code, success, error} entry per iterated item)",
-
   "ports.http_status_code": "HTTP status code",
   "ports.http_success": "Request success flag",
   "ports.items": "Item list",
@@ -1207,7 +1204,6 @@
   "connection.OverseasStockBrokerNode.label": "LS Securities overseas stock account",
   "connection.TelegramNode.label": "Telegram bot",
   "connection_rules.realtime_to_http.reason": "Direct connection from realtime node to HTTPRequestNode is not recommended. Each tick would trigger an HTTP request, potentially hitting external API rate limits.",
-
   "connection_rules.realtime_to_http.suggestion": "Place a ThrottleNode between the realtime node and HTTP request node to control request frequency.",
   "fields.BaseOrderNode.rate_limit_interval": "Minimum order interval (seconds). Default 5 seconds. The next order will only execute after this time has elapsed since the last order.",
   "fields.BaseOrderNode.rate_limit_action": "Action when order interval is not met. skip: silently skip, error: raise error",
@@ -1251,6 +1247,9 @@
   "enums.contract_selection.front": "Front month (nearest expiry)",
   "enums.contract_selection.next": "Next month (roll target)",
   "enums.contract_selection.quarterly": "Quarterly (Mar/Jun/Sep/Dec)",
+  "nodes.OverseasFuturesContractInfoNode.name": "Futures Contract Details",
+  "nodes.OverseasFuturesContractInfoNode.description": "Reads observed contract dates, margins and reported session times from the connected broker. Missing values remain unknown; no order is placed.",
+  "fieldNames.OverseasFuturesContractInfoNode.symbol": "Futures contract",
   "nodes.OverseasFuturesOrderableQuantityNode.name": "Futures Orderable Quantity",
   "nodes.OverseasFuturesOrderableQuantityNode.description": "Reads contract-specific orderable quantity from the connected futures account. No order is submitted. Require verified=true and sufficient quantity before entry.",
   "fieldNames.OverseasFuturesOrderableQuantityNode.symbol": "Contract",
@@ -1278,5 +1277,6 @@
   "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."
+  "nodes.SessionGateNode.windows": "Local HH:MM start/end windows; start inclusive, end exclusive. Overnight windows are supported.",
+  "fields.SQLiteNode.storage_scope": "Storage scope: shared filename or a durable namespace per execution."
 }

{programgarden_core-2.5.3 → programgarden_core-2.6.0}/programgarden_core/i18n/locales/ko.json

@@ -296,7 +296,6 @@
   "fields.PerformanceReportNode.risk_free_rate": "무위험 수익률(소수, 예 0.02=2%) — Sharpe/Sortino용. 기본 0.",
   "fields.HTTPRequestNode.auth_required": "이 API 가 인증이 필요한가요? 미설정이면 챗봇이 문맥으로 판단합니다. 비공개 API 는 true(자격증명 필요), 공개 API 는 false 로 두세요.",
   "fields.HTTPRequestNode.body": "요청 본문 (POST/PUT/PATCH용). 자동으로 JSON 직렬화됨.",
-
   "fields.HTTPRequestNode.credential_id": "인증정보 ID. 지원: http_bearer, http_header, http_basic, http_query",
   "fields.HTTPRequestNode.headers": "HTTP 헤더. + 버튼으로 커스텀 헤더 추가 (예: Content-Type, X-API-Key).",
   "fields.HTTPRequestNode.method": "HTTP 요청 메서드",
@@ -602,7 +601,6 @@
   "fieldNames.PerformanceReportNode.risk_free_rate": "무위험 수익률",
   "fieldNames.HTTPRequestNode.auth_required": "인증 필요 여부",
   "fieldNames.HTTPRequestNode.body": "요청본문",
-
   "fieldNames.HTTPRequestNode.credential_id": "인증정보",
   "fieldNames.HTTPRequestNode.headers": "헤더",
   "fieldNames.HTTPRequestNode.method": "HTTP메소드",
@@ -877,7 +875,6 @@
   "ports.http_request_data": "요청 데이터",
   "ports.http_response": "API 응답 데이터",
   "ports.http_results": "항목별 결과 (반복된 항목마다 {item, response, status_code, success, error} 한 건)",
-
   "ports.http_status_code": "HTTP 상태 코드",
   "ports.http_success": "요청 성공 여부",
   "ports.items": "아이템 목록",
@@ -1207,7 +1204,6 @@
   "connection.OverseasStockBrokerNode.label": "LS증권 해외주식 계좌",
   "connection.TelegramNode.label": "텔레그램 봇",
   "connection_rules.realtime_to_http.reason": "실시간 노드에서 HTTPRequestNode로의 직접 연결은 권장하지 않습니다. 틱 데이터마다 HTTP 요청이 발생하여 외부 API 제한에 걸릴 수 있습니다.",
-
   "connection_rules.realtime_to_http.suggestion": "실시간 노드와 HTTP 요청 노드 사이에 ThrottleNode를 배치하여 요청 빈도를 제어하세요.",
   "fields.BaseOrderNode.rate_limit_interval": "최소 주문 간격 (초). 기본값 5초. 직전 주문 후 이 시간이 지나야 다음 주문이 실행됩니다.",
   "fields.BaseOrderNode.rate_limit_action": "주문 간격 미달 시 동작. skip: 조용히 건너뜀, error: 에러 발생",
@@ -1251,6 +1247,9 @@
   "enums.contract_selection.front": "근월물 (만기 가장 가까움)",
   "enums.contract_selection.next": "차월물 (롤오버 대상)",
   "enums.contract_selection.quarterly": "분기월물 (3·6·9·12월)",
+  "nodes.OverseasFuturesContractInfoNode.name": "해외선물 종목상세 조회",
+  "nodes.OverseasFuturesContractInfoNode.description": "연결된 증권사를 통해 선물 종목의 만기일·최종거래일·증거금·거래시간을 조회합니다. 확인되지 않은 값은 비워 두며 주문을 실행하지 않습니다.",
+  "fieldNames.OverseasFuturesContractInfoNode.symbol": "선물 종목",
   "nodes.OverseasFuturesOrderableQuantityNode.name": "해외선물 주문가능수량",
   "nodes.OverseasFuturesOrderableQuantityNode.description": "연결된 해외선물 계좌에서 해당 종목의 주문가능수량을 조회합니다. 주문은 제출하지 않으며, 확인 성공 여부와 가능 수량을 확인한 뒤 진입합니다.",
   "fieldNames.OverseasFuturesOrderableQuantityNode.symbol": "선물 종목",
@@ -1278,5 +1277,6 @@
   "nodes.SessionGateNode.session_date": "허용 구간의 시작일입니다. 차단되면 빈 문자열입니다.",
   "nodes.SessionGateNode.timezone": "IANA 시간대입니다. 설치된 시간대 데이터로 서머타임을 반영합니다.",
   "nodes.SessionGateNode.trigger": "실행 시점의 현지 시간을 확인합니다.",
-  "nodes.SessionGateNode.windows": "현지 HH:MM 구간입니다. 시작은 포함하고 종료는 제외하며 자정을 넘는 구간도 지원합니다."
+  "nodes.SessionGateNode.windows": "현지 HH:MM 구간입니다. 시작은 포함하고 종료는 제외하며 자정을 넘는 구간도 지원합니다.",
+  "fields.SQLiteNode.storage_scope": "저장 범위: 공용 파일 또는 실행별로 분리한 영구 저장 파일"
 }

{programgarden_core-2.5.3 → programgarden_core-2.6.0}/programgarden_core/market_calendar.py

@@ -1,4 +1,4 @@
-"""Scheduled US equity sessions, independent of credentials and live market data.
+"""Scheduled equity sessions, independent of credentials and live market data.
 
 This schedule includes published holidays and early closes. It cannot observe
 new emergency closures, instrument halts, or a broker's ability to accept orders.
@@ -19,15 +19,22 @@ def _calendar(name: str, year: int):
 
 def scheduled_session_open(name: str, instant: datetime) -> bool:
     """Exact seconds: opening is inclusive and closing is exclusive."""
-    if name not in {"XNYS", "XNAS"}:
+    if name not in {"XNYS", "XNAS", "XHKG"}:
         raise ValueError("Unsupported exchange calendar")
     if instant.tzinfo is None or instant.utcoffset() is None:
         raise ValueError("Calendar clock must include timezone")
-    market_date = instant.astimezone(ZoneInfo("America/New_York")).date()
+    zone = "Asia/Hong_Kong" if name == "XHKG" else "America/New_York"
+    market_date = instant.astimezone(ZoneInfo(zone)).date()
     schedule = _calendar(name, market_date.year).schedule
     day = market_date.isoformat()
     if day not in schedule.index:
         return False
     row = schedule.loc[day]
     clock = instant.astimezone(timezone.utc)
-    return bool(row["open"] <= clock < row["close"])
+    if not row["open"] <= clock < row["close"]:
+        return False
+    # XHKG has a scheduled midday break. NaT comparisons are false for markets
+    # without breaks; do not admit the lunch interval as an open session.
+    if "break_start" in row and row["break_start"] <= clock < row["break_end"]:
+        return False
+    return True

{programgarden_core-2.5.3 → programgarden_core-2.6.0}/programgarden_core/nodes/__init__.py

@@ -28,6 +28,7 @@ from programgarden_core.nodes.broker import OverseasStockBrokerNode, OverseasFut
 from programgarden_core.nodes.data_stock import OverseasStockMarketDataNode
 from programgarden_core.nodes.fundamental_stock import OverseasStockFundamentalNode
 from programgarden_core.nodes.data_futures import OverseasFuturesMarketDataNode
+from programgarden_core.nodes.contract_info_futures import OverseasFuturesContractInfoNode
 from programgarden_core.nodes.backtest_stock import OverseasStockHistoricalDataNode
 from programgarden_core.nodes.backtest_futures import OverseasFuturesHistoricalDataNode
 from programgarden_core.nodes.realtime_stock import (
@@ -131,6 +132,7 @@ __all__ = [
     "OverseasFuturesRealMarketDataNode",
     "OverseasFuturesSymbolQueryNode",
     "FuturesContractNode",
+    "OverseasFuturesContractInfoNode",
     # Account - Stock (해외주식)
     "OverseasStockAccountNode",
     "OverseasStockRealAccountNode",

programgarden_core-2.6.0/programgarden_core/nodes/contract_info_futures.py

@@ -0,0 +1,122 @@
+"""Runtime contract metadata for an exact listed overseas futures symbol."""
+from typing import ClassVar, Dict, List, Literal, Optional
+
+from pydantic import Field
+
+from programgarden_core.nodes.base import BaseNode, BrokerProvider, InputPort, NodeCategory, OutputPort, ProductScope
+from programgarden_core.models.field_binding import ExpressionMode, FieldCategory, FieldSchema, FieldType
+
+
+CONTRACT_INFO_FIELDS = [
+    {"name": key, "type": "string", "description": description}
+    for key, description in {
+        "symbol": "Exact observed contract symbol.",
+        "exchange": "Observed exchange code matching the request.",
+        "symbol_name": "Observed contract name; null if absent.",
+        "underlying_code": "Observed underlying product code; null if absent.",
+        "currency": "Observed contract currency; null if absent.",
+        "maturity_date": "LS MtrtDt, YYYY-MM-DD; null if missing or invalid.",
+        "last_trading_date": "LS FnlDlDt, YYYY-MM-DD; distinct from maturity; null if unknown.",
+        "first_notice_date": "LS FstTrsfrDt, YYYY-MM-DD; null if unknown or not supplied.",
+        "master_received_date": "LS ApplDate, YYYY-MM-DD; not proof of future calendar coverage.",
+        "korea_start_date": "LS DlDt date, YYYY-MM-DD.",
+        "korea_start_time": "LS DlStrtTm time, HH:MM:SS; a reported session, not all trading windows.",
+        "korea_end_time": "LS DlEndTm time, HH:MM:SS; no end date is inferred.",
+        "local_start_date": "LS OvsStrDay date, YYYY-MM-DD.",
+        "local_start_time": "LS OvsStrTm time, HH:MM:SS.",
+        "local_end_date": "LS OvsEndDay date, YYYY-MM-DD.",
+        "local_end_time": "LS OvsEndTm time, HH:MM:SS.",
+        "trade_status_code": "Raw LS DlPsblCd; no undocumented enum interpretation.",
+        "source_tr": "o3105.",
+        "observed_at": "UTC time of this observation, ISO8601; not a broker data timestamp.",
+    }.items()
+] + [
+    {"name": key, "type": "number", "description": description}
+    for key, description in {
+        "initial_margin": "Observed OpngMgn; null if absent/invalid. Not account order capacity.",
+        "maintenance_margin": "Observed MntncMgn; null if absent/invalid.",
+        "tick_size": "Observed positive UntPrc; null if unavailable.",
+        "tick_value": "Observed positive MnChgAmt; null if unavailable.",
+    }.items()
+]
+
+
+class OverseasFuturesContractInfoNode(BaseNode):
+    type: Literal["OverseasFuturesContractInfoNode"] = "OverseasFuturesContractInfoNode"
+    category: NodeCategory = NodeCategory.MARKET
+    description: str = "i18n:nodes.OverseasFuturesContractInfoNode.description"
+    _product_scope: ClassVar[ProductScope] = ProductScope.FUTURES
+    _broker_provider: ClassVar[BrokerProvider] = BrokerProvider.LS
+    _version: ClassVar[str] = "1.0.0"
+    _updated_at: ClassVar[str] = "2026-10-03"
+    _change_note: ClassVar[str] = "Read native futures contract dates, margins and reported sessions without placing an order."
+
+    symbol: Optional[Dict[str, str]] = Field(default=None, description="Exact listed contract identity: symbol and exchange.")
+    _inputs: List[InputPort] = [InputPort(name="trigger", type="signal", required=False, description="Refresh after resolving the contract.")]
+    _outputs: List[OutputPort] = [
+        OutputPort(name="value", type="object", fields=CONTRACT_INFO_FIELDS, description="Observed contract details; null when the query fails. Optional fields remain null."),
+        OutputPort(name="verified", type="boolean", description="Successful response with matching symbol/exchange; not completeness of all optional fields."),
+        OutputPort(name="missing_fields", type="array", description="Optional output fields absent or invalid in the broker response."),
+        OutputPort(name="error", type="string", description="Safe failure reason; null for a matching successful response."),
+    ]
+    _usage: ClassVar[dict] = {
+        "when_to_use": ["Inspect runtime maturity/last-trading/notice dates, margins, currency and reported session times for an exact futures contract."],
+        "when_not_to_use": ["Selecting front/next months (FuturesContractNode), confirming fills, computing a holiday calendar or authorizing an order."],
+        "typical_scenarios": ["FuturesContractNode → OverseasFuturesContractInfoNode → date guard; account-held symbol → detail → rollover eligibility."],
+    }
+    _features: ClassVar[list] = [
+        "One read-only o3105 request; no model call, positive quote requirement or order submission.",
+        "Always reads one explicit symbol object; upstream arrays do not repeat the request. Use SplitNode and bind nodes.split.item for an explicit batch.",
+        "Missing dates/numbers remain null; source dates are never guessed from the contract month.",
+        "Deep validation uses synthetic data; replay uses recorded SDK responses through the same parser.",
+    ]
+    _node_guide: ClassVar[dict] = {
+        "input_handling": "Bind one {symbol, exchange} object, with an ordering edge from its producer and an upstream futures broker. Use the actual held contract for rollover, which may differ from today's front month.",
+        "output_consumption": "Require verified=true and the specific non-null fields the decision needs. Dates use YYYY-MM-DD. Session times describe the returned session only; use an authoritative calendar for holidays/trading-day offsets. Confirm close fills before reopening.",
+        "pitfalls": ["verified does not assert every optional field exists. Initial margin is not available account capacity. Neither dates nor raw trade status prove the exchange is currently open."],
+        "common_combinations": ["FuturesContractNode, OverseasFuturesAccountNode, CodeNode, OverseasFuturesOrderableQuantityNode."],
+    }
+    _anti_patterns: ClassVar[list] = [{"pattern": "Guess missing expiry from weekdays or reopen on order ACK.", "reason": "A reported date and a broker-confirmed execution are separate inputs.", "alternative": "Require the authoritative date and correlated close fills; report unavailable evidence explicitly."}]
+    _examples: ClassVar[list] = [{
+        "title": "Inspect the current front contract",
+        "description": "Read-only component; no order is submitted.",
+        "expected_output": "value contains observed details; unsupported or missing fields stay null.",
+        "workflow_snippet": {
+            "id": "futures-contract-details", "name": "Inspect futures contract",
+            "nodes": [{"id": "start", "type": "StartNode"},
+                      {"id": "broker", "type": "OverseasFuturesBrokerNode", "credential_id": "broker_cred", "paper_trading": True},
+                      {"id": "contract", "type": "FuturesContractNode", "base_products": ["HMH"], "contract_selection": "front"},
+                      {"id": "detail", "type": "OverseasFuturesContractInfoNode", "symbol": "{{ nodes.contract.symbols[0] }}"}],
+            "edges": [{"from": a, "to": b} for a, b in [("start", "broker"), ("broker", "contract"), ("contract", "detail")]],
+            "credentials": [{"credential_id": "broker_cred", "type": "broker_ls_overseas_futures", "data": [{"key": "appkey", "value": ""}, {"key": "appsecret", "value": ""}]}],
+        },
+    }, {
+        "title": "Inspect the proposed next contract",
+        "description": "Resolve and inspect the successor before a separate rollover decision; no order is submitted.",
+        "expected_output": "The selected next contract's observed dates and margins, with unknown fields remaining null.",
+        "workflow_snippet": {
+            "id": "futures-next-contract-details", "name": "Inspect next futures contract",
+            "nodes": [{"id": "start", "type": "StartNode"},
+                      {"id": "broker", "type": "OverseasFuturesBrokerNode", "credential_id": "broker_cred", "paper_trading": True},
+                      {"id": "contract", "type": "FuturesContractNode", "base_products": ["HMH"], "contract_selection": "next"},
+                      {"id": "detail", "type": "OverseasFuturesContractInfoNode", "symbol": "{{ nodes.contract.symbols[0] }}"}],
+            "edges": [{"from": a, "to": b} for a, b in [("start", "broker"), ("broker", "contract"), ("contract", "detail")]],
+            "credentials": [{"credential_id": "broker_cred", "type": "broker_ls_overseas_futures", "data": [{"key": "appkey", "value": ""}, {"key": "appsecret", "value": ""}]}],
+        },
+    }]
+
+    @classmethod
+    def is_tool_enabled(cls) -> bool:
+        return True
+
+    @classmethod
+    def get_field_schema(cls) -> Dict[str, FieldSchema]:
+        return {"symbol": FieldSchema(
+            name="symbol", type=FieldType.OBJECT,
+            display_name="i18n:fieldNames.OverseasFuturesContractInfoNode.symbol",
+            description="Exact listed contract symbol and exchange; resolve at run time.",
+            category=FieldCategory.PARAMETERS, expression_mode=ExpressionMode.BOTH, required=True,
+            object_schema=[{"name": "symbol", "type": "STRING", "required": True}, {"name": "exchange", "type": "STRING", "required": True}],
+            bindable_sources=["FuturesContractNode.symbols", "SplitNode.item"],
+            example_binding="{{ nodes.contract.symbols[0] }}",
+        )}

{programgarden_core-2.5.3 → programgarden_core-2.6.0}/programgarden_core/nodes/data.py

@@ -177,6 +177,9 @@ class SQLiteNode(BaseNode):
     _img_url: ClassVar[str] = ""
 
     # === 기본 설정 ===
+    storage_scope: Literal['shared', 'execution'] = Field(
+        default='shared', description='i18n:fields.SQLiteNode.storage_scope',
+    )
     db_name: str = Field(
         default="default.db",
         description="데이터베이스 파일명 (/app/data/ 폴더 내)",
@@ -248,7 +251,7 @@ class SQLiteNode(BaseNode):
         "Upsert support via 'on_conflict' column in simple mode — ideal for idempotent state updates",
         "Outputs rows (list), affected_count (int), and last_insert_id (int) to cover all read/write patterns",
         "is_tool_enabled=True — AI Agent can use SQLiteNode as a tool to read or write local state",
-        "Databases are scoped to /app/data/ directory; db_name selects the file",
+        "The host injects storage_dir (default /app/data); db_name selects the file. storage_scope=execution prefixes a stable host execution identity (or workflow ID for standalone use), survives process restarts, and separates managed account executions. Default shared preserves existing filenames. Keep the host directory on durable storage and do not reset reservations on startup.",
         "Has a dedicated replay adapter (execute_sqlite) and takes no external recording; it runs against a file-backed database rooted at the run's storage directory",
         "State written on one tick or event frame persists to that database and stays visible on later frames within the run, so a durable duplicate guard can be built on it",
         "Each execution runs exactly ONE SQL statement (execute_query and every simple-mode action call db.execute once); 'CREATE TABLE …; INSERT …' in one query fails with 'You can only execute one statement at a time'",
@@ -426,6 +429,12 @@ class SQLiteNode(BaseNode):
     def get_field_schema(cls) -> Dict[str, "FieldSchema"]:
         from programgarden_core.models.field_binding import FieldSchema, FieldType, FieldCategory, ExpressionMode, UIComponent
         return {
+            "storage_scope": FieldSchema(
+                name="storage_scope", type=FieldType.ENUM,
+                description="i18n:fields.SQLiteNode.storage_scope", default="shared",
+                enum_values=["shared", "execution"], category=FieldCategory.PARAMETERS,
+                expression_mode=ExpressionMode.FIXED_ONLY,
+            ),
             # === PARAMETERS: 기본 설정 ===
             "db_name": FieldSchema(
                 name="db_name",

{programgarden_core-2.5.3 → programgarden_core-2.6.0}/programgarden_core/nodes/realtime_futures.py

@@ -601,8 +601,16 @@ class OverseasFuturesRealOrderEventNode(BaseNode):
 
     _inputs: List[InputPort] = []
     _outputs: List[OutputPort] = [
+        OutputPort(name="status", type="string", description="Subscription status; subscribed only after successful registration."),
+        OutputPort(name="error", type="string", description="Subscription failure when unavailable."),
         OutputPort(name="accepted", type="order_event", description="i18n:ports.accepted", fields=ORDER_EVENT_FIELDS),
-        OutputPort(name="filled", type="order_event", description="i18n:ports.filled", fields=ORDER_EVENT_FIELDS),
+        OutputPort(name="filled", type="order_event", description="i18n:ports.filled", fields=ORDER_EVENT_FIELDS + [
+            {"name": "tr_cd", "type": "string", "description": "Native stream identifier (TC3 for executions)."},
+            {"name": "svc_id", "type": "string", "description": "Native service classifier; require CH01 for a positive execution."},
+            {"name": "order_date", "type": "string", "description": "Observed broker order date, YYYYMMDD; no local date fallback."},
+            {"name": "fill_no", "type": "string", "description": "Observed TC3 execution identity; never equate with REST execution numbers."},
+            {"name": "fill_time", "type": "string", "description": "Observed TC3 execution time."},
+        ]),
         OutputPort(name="modified", type="order_event", description="i18n:ports.modified", fields=ORDER_EVENT_FIELDS),
         OutputPort(name="cancelled", type="order_event", description="i18n:ports.cancelled", fields=ORDER_EVENT_FIELDS),
         OutputPort(name="rejected", type="order_event", description="i18n:ports.rejected", fields=ORDER_EVENT_FIELDS),

{programgarden_core-2.5.3 → programgarden_core-2.6.0}/programgarden_core/nodes/session_gate.py

@@ -43,7 +43,7 @@ class SessionGateNode(BaseNode):
     windows: list[SessionWindow] = Field(..., min_length=1, description='i18n:nodes.SessionGateNode.windows')
     days: list[Literal['mon','tue','wed','thu','fri','sat','sun']] = Field(..., min_length=1, description='i18n:nodes.SessionGateNode.days')
     closed_dates: list[str] = Field(default_factory=list, description='i18n:nodes.SessionGateNode.closed_dates')
-    exchange_calendar: Literal['XNYS', 'XNAS'] | None = Field(default=None, description='i18n:nodes.SessionGateNode.exchange_calendar')
+    exchange_calendar: Literal['XNYS', 'XNAS', 'XHKG'] | None = Field(default=None, description='i18n:nodes.SessionGateNode.exchange_calendar')
 
     _inputs: list[InputPort] = [InputPort(name='trigger',type='signal',required=False,description='i18n:nodes.SessionGateNode.trigger')]
     _outputs: list[OutputPort] = [OutputPort(name=k,type=t,description=d) for k,t,d in [
@@ -53,15 +53,15 @@ class SessionGateNode(BaseNode):
         ('local_time','string','i18n:nodes.SessionGateNode.local_time'),
         ('reason','string','i18n:nodes.SessionGateNode.reason'),
     ]]
-    _change_note: ClassVar[str] = 'Add opt-in scheduled US equity holidays and early closes.'
-    _version: ClassVar[str] = '1.1.0'
-    _updated_at: ClassVar[str] = '2026-09-29'
+    _change_note: ClassVar[str] = 'Add the XHKG cash-session intersection, including lunch breaks; this is not a derivatives calendar.'
+    _version: ClassVar[str] = '1.2.0'
+    _updated_at: ClassVar[str] = '2026-10-03'
     _usage: ClassVar[dict[str,Any]] = {
         'when_to_use':['Check a market-local order window immediately before submission.','Handle overnight sessions, breaks and daylight-saving time.'],
         'when_not_to_use':['Live trading halts or new emergency closures must be observed.','Wait until opening: use TradingHoursFilterNode.'],
         'typical_scenarios':['ScheduleNode -> SessionGateNode -> IfNode(allowed) -> strategy','Reservation -> SessionGateNode -> IfNode(allowed) -> OrderNode'],
     }
-    _features: ClassVar[list[str]] = ['No credentials or network.', 'Optional exchange_calendar XNYS/XNAS intersects user windows with scheduled holidays and early closes; missing/broken calendar data blocks entry. Default null preserves explicit-window behavior.','No sleeping and no dry-run bypass.','IANA timezone/DST and opening-weekday semantics.','Explicit IfNode controls downstream work.','Output is a pure function of the evaluation instant and the configuration (windows are start-inclusive and end-exclusive, plus days, closed_dates and the IANA timezone); replay evaluates it at the scenario as_of.','Two frames at the same instant produce the same allowed value; an outside-window scenario must sit at an instant outside the window.','allowed skips nothing by itself; bind it to an IfNode and hang the order chain on the IfNode true edge.']
+    _features: ClassVar[list[str]] = ['No credentials or network.', 'Optional exchange_calendar XNYS/XNAS/XHKG intersects user windows with scheduled holidays, breaks and early closes; XHKG is the cash calendar, not all futures sessions; missing/broken calendar data blocks entry. Default null preserves explicit-window behavior.','No sleeping and no dry-run bypass.','IANA timezone/DST and opening-weekday semantics.','Explicit IfNode controls downstream work.','Output is a pure function of the evaluation instant and the configuration (windows are start-inclusive and end-exclusive, plus days, closed_dates and the IANA timezone); replay evaluates it at the scenario as_of.','Two frames at the same instant produce the same allowed value; an outside-window scenario must sit at an instant outside the window.','allowed skips nothing by itself; bind it to an IfNode and hang the order chain on the IfNode true edge.']
     _anti_patterns: ClassVar[list[dict[str,str]]] = [{'pattern':'Connect directly to an order and assume an ordinary edge checks allowed.','reason':'Edges sequence execution; false output does not automatically skip successors.','alternative':'Bind allowed to IfNode and use its true edge.'}]
     _node_guide: ClassVar[dict[str,Any]] = {
         'input_handling':'Configure timezone, windows, days and optional closed_dates. No current-time override is accepted from workflow data.',
@@ -122,7 +122,7 @@ class SessionGateNode(BaseNode):
         fields['exchange_calendar'] = FieldSchema(
             name='exchange_calendar', type=FieldType.STRING,
             description=cls.model_fields['exchange_calendar'].description, required=False,
-            enum_values=['XNYS', 'XNAS'], category=FieldCategory.PARAMETERS,
+            enum_values=['XNYS', 'XNAS', 'XHKG'], category=FieldCategory.PARAMETERS,
             expression_mode=ExpressionMode.FIXED_ONLY,
         )
         return fields

{programgarden_core-2.5.3 → programgarden_core-2.6.0}/programgarden_core/registry/node_registry.py

@@ -195,7 +195,7 @@ class NodeTypeRegistry:
             OverseasFuturesMarketDataNode, OverseasFuturesHistoricalDataNode,
             OverseasFuturesRealMarketDataNode,
             OverseasFuturesSymbolQueryNode,
-            FuturesContractNode,
+            FuturesContractNode, OverseasFuturesContractInfoNode,
             # Account - Stock (해외주식)
             OverseasStockAccountNode, OverseasStockRealAccountNode, OverseasStockRealOrderEventNode,
             # Account - Futures (해외선물)
@@ -239,7 +239,7 @@ class NodeTypeRegistry:
             OverseasFuturesMarketDataNode, OverseasFuturesHistoricalDataNode,
             OverseasFuturesRealMarketDataNode,
             OverseasFuturesSymbolQueryNode,
-            FuturesContractNode,
+            FuturesContractNode, OverseasFuturesContractInfoNode,
             # Account - Stock (해외주식)
             OverseasStockAccountNode, OverseasStockRealAccountNode, OverseasStockRealOrderEventNode,
             # Account - Futures (해외선물)

{programgarden_core-2.5.3 → programgarden_core-2.6.0}/pyproject.toml

@@ -5,7 +5,7 @@ authors = [
 homepage = "https://programgarden.com"
 requires-python = ">=3.12"
 name = "programgarden-core"
-version = "2.5.3"
+version = "2.6.0"
 license = "AGPL-3.0-or-later"
 description = "ProgramGarden Core - 노드 기반 DSL 핵심 타입 정의"
 readme = "README.md"