programgarden 2.6.0__tar.gz → 2.6.1__tar.gz

{programgarden-2.6.0 → programgarden-2.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: programgarden
-Version: 2.6.0
+Version: 2.6.1
 Summary: ProgramGarden - 노드 기반 자동매매 DSL 실행 엔진
 License-Expression: AGPL-3.0-or-later
 Author: 프로그램동산
@@ -16,7 +16,7 @@ Requires-Dist: croniter (>=6.0.0,<7.0.0)
 Requires-Dist: litellm (>=1.40.0)
 Requires-Dist: lxml (>=6.0.2,<7.0.0)
 Requires-Dist: programgarden-community (>=2.3.1,<3.0.0)
-Requires-Dist: programgarden-core (>=2.6.0,<3.0.0)
+Requires-Dist: programgarden-core (>=2.6.1,<3.0.0)
 Requires-Dist: programgarden-finance (>=2.0.1,<3.0.0)
 Requires-Dist: psutil (>=6.0.0,<7.0.0)
 Requires-Dist: psycopg2-binary (>=2.9.11,<3.0.0)
@@ -29,6 +29,10 @@ Description-Content-Type: text/markdown
 
 # ProgramGarden
 
+An unreleased [stock history interval correction](../../docs/stock-history-interval-contract.md)
+rejects unsupported intraday periods instead of silently querying daily bars.
+Supported g3204 periods retain their existing requests and output contract.
+
 An unreleased [futures detail and durable state candidate](../../docs/futures-contract-details-and-rollover-state.md)
 adds exact o3105 metadata, opt-in execution-scoped SQLite and XHKG calendar
 intersection. Missing evidence remains explicit; this does not authorize orders.

{programgarden-2.6.0 → programgarden-2.6.1}/README.md

@@ -1,5 +1,9 @@
 # ProgramGarden
 
+An unreleased [stock history interval correction](../../docs/stock-history-interval-contract.md)
+rejects unsupported intraday periods instead of silently querying daily bars.
+Supported g3204 periods retain their existing requests and output contract.
+
 An unreleased [futures detail and durable state candidate](../../docs/futures-contract-details-and-rollover-state.md)
 adds exact o3105 metadata, opt-in execution-scoped SQLite and XHKG calendar
 intersection. Missing evidence remains explicit; this does not authorize orders.

{programgarden-2.6.0 → programgarden-2.6.1}/programgarden/executor.py

@@ -12186,7 +12186,7 @@ class HistoricalDataNodeExecutor(NodeExecutorBase):
     HistoricalDataNode executor - 과거 OHLCV 데이터 조회
     
     LS Finance Chart API를 사용하여 과거 차트 데이터를 조회합니다.
-    - 해외주식: g3103 (일/주/월봉)
+    - Overseas stock: g3204 (daily/weekly/monthly/yearly; no intraday)
     - 해외선물: o3108 (일봉), o3103 (분봉)
     """
 
@@ -12208,6 +12208,15 @@ class HistoricalDataNodeExecutor(NodeExecutorBase):
     ) -> Dict[str, Any]:
         """과거 데이터 조회"""
 
+        # Reject unsupported stock periods before fixtures can manufacture success.
+        # The broker-specific fetch repeats this guard for direct/legacy callers.
+        connection = config.get("connection")
+        product = connection.get("product") if isinstance(connection, dict) else None
+        if node_type == "OverseasStockHistoricalDataNode" or (
+            node_type == "HistoricalDataNode" and product in (None, "overseas_stock")
+        ):
+            self._stock_history_gubun(config.get("interval", "1d"))
+
         # deep_validate: HistoricalDataNode hits the real LS API. Inject a fixture
         # time series so the flow completes without a network call.
         if context.is_deep_validate:
@@ -12451,6 +12460,18 @@ class HistoricalDataNodeExecutor(NodeExecutorBase):
         # 파싱 실패 시 오늘 날짜 반환
         return datetime.now().strftime("%Y%m%d")
 
+    @staticmethod
+    def _stock_history_gubun(interval: str) -> str:
+        """Reject unsupported periods instead of relabeling daily bars."""
+        periods = {"1d": "2", "1w": "3", "1M": "4", "1Y": "5"}
+        if not isinstance(interval, str) or interval not in periods:
+            raise ValueError(
+                "UNSUPPORTED_STOCK_HISTORY_INTERVAL: OverseasStockHistoricalDataNode "
+                "supports 1d, 1w, 1M and 1Y through LS g3204. "
+                "Intraday g3203 is not supported; select a supported period explicitly."
+            )
+        return periods[interval]
+
     async def _fetch_overseas_stock(
         self,
         symbols: List[str],
@@ -12472,6 +12493,9 @@ class HistoricalDataNodeExecutor(NodeExecutorBase):
         반환: [{symbol, exchange, time_series: [{date, open, high, low, close, volume}, ...]}, ...]
         """
         
+        # Validate before credential access or login, outside the soft-failure handler.
+        gubun = self._stock_history_gubun(interval)
+
         credential = context.get_credential()
         if not credential:
             context.log("error", "Credential not set for HistoricalDataNode", node_id)
@@ -12494,10 +12518,6 @@ class HistoricalDataNodeExecutor(NodeExecutorBase):
             
             api = ls.overseas_stock()
 
-            # interval → gubun 변환 (g3204: 2=일, 3=주, 4=월, 5=년)
-            gubun_map = {"1d": "2", "1w": "3", "1M": "4", "1Y": "5"}
-            gubun = gubun_map.get(interval, "2")
-
             # 거래소 코드 매핑 (역변환용)
             exchcd_to_exchange = {"82": "NASDAQ", "81": "NYSE", "83": "AMEX"}
 

{programgarden-2.6.0 → programgarden-2.6.1}/programgarden/resolver.py

@@ -345,6 +345,7 @@ class WorkflowResolver:
 
         # Order routing choices are literals, never prices or item bindings.
         self._validate_order_enums(workflow, registry, result)
+        self._validate_stock_history_interval(workflow, registry, result)
 
         # 11. Static recommendations (topology analysis)
         for rec in run_static_recommendation_rules(
@@ -362,6 +363,29 @@ class WorkflowResolver:
 
         return result
 
+    def _validate_stock_history_interval(self, workflow, registry, result) -> None:
+        """Keep static/deep validation aligned with the stock chart executor."""
+        node_type = "OverseasStockHistoricalDataNode"
+        node_class = registry.get(node_type)
+        if node_class is None:
+            return
+        field = node_class.get_field_schema()["interval"]
+        for node in workflow.nodes:
+            if node.get("type") != node_type:
+                continue
+            if node.get("interval", field.default) in field.enum_values:
+                continue
+            result.add(build_error(
+                ErrorCode.INVALID_FIELD_ENUM,
+                "Stock historical intervals require a supported LS g3204 period; "
+                "intraday g3203 is not supported.",
+                location=ErrorLocation(
+                    node_id=node.get("id"), node_type=node_type, field_path="interval",
+                ),
+                available_values=field.enum_values,
+                suggestion="Choose 1d, 1w, 1M or 1Y explicitly; do not substitute daily bars for an intraday strategy.",
+            ))
+
     def _validate_order_enums(self, workflow, registry, result) -> None:
         """Enforce fixed price/order types without changing dynamic close sides."""
         from programgarden_core.models.field_binding import ExpressionMode

{programgarden-2.6.0 → programgarden-2.6.1}/pyproject.toml

@@ -5,7 +5,7 @@ authors = [
 homepage = "https://programgarden.com"
 requires-python = ">=3.12"
 name = "programgarden"
-version = "2.6.0"
+version = "2.6.1"
 license = "AGPL-3.0-or-later"
 description = "ProgramGarden - 노드 기반 자동매매 DSL 실행 엔진"
 readme = "README.md"
@@ -36,7 +36,7 @@ litellm = ">=1.40.0"
 # 로 통째 실패한다(1.35.1 의 조용한 TypeError 보다 강한 모듈 로드 실패).
 # (1.26.0 이후로도 context.py 는 WorkflowPnLEvent(**event_data) 에 personal_metrics
 #  를 무조건 실으므로 그 하한 근거도 이 상한에 포함된다.)
-programgarden-core = "^2.6.0"
+programgarden-core = "^2.6.1"
 programgarden-finance = "^2.0.1"
 programgarden-community = "^2.3.1"