programgarden-core 1.25.0__tar.gz → 1.25.2__tar.gz

{programgarden_core-1.25.0 → programgarden_core-1.25.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: programgarden-core
-Version: 1.25.0
+Version: 1.25.2
 Summary: ProgramGarden Core - 노드 기반 DSL 핵심 타입 정의
 License-Expression: AGPL-3.0-or-later
 Author: 프로그램동산

{programgarden_core-1.25.0 → programgarden_core-1.25.2}/programgarden_core/bases/listener.py

@@ -189,7 +189,7 @@ class PositionDetail:
     """
     symbol: str
     exchange: str
-    quantity: int
+    quantity: Union[Decimal, float, int]  # 소수점(fractional) 잔고 대응
     avg_price: Union[Decimal, float]
     current_price: Union[Decimal, float]
     pnl_amount: Union[Decimal, float]

{programgarden_core-1.25.0 → programgarden_core-1.25.2}/programgarden_core/models/order_diagnostics.py

@@ -117,6 +117,12 @@ class EmptyOrderReason(str, Enum):
     NO_SYMBOL = "no_symbol"
     """No symbol was specified (missing configuration)."""
 
+    FRACTIONAL_ONLY = "fractional_only"
+    """The position quantity is fractional-only (e.g. 0.847972 shares) and the
+    order pipeline submits integer quantities, so flooring left nothing to
+    order. Distinct from NO_SIGNAL so the holder learns why nothing happened
+    (fractional balances measured on a real LS account, prod 2026-08-24)."""
+
 
 # ---------------------------------------------------------------------------
 # Market-specific reject-code tables.
@@ -132,6 +138,15 @@ class EmptyOrderReason(str, Enum):
 # Each entry was produced by deliberately triggering the rejection and reading
 # the returned rsp_cd/rsp_msg — none of these are inferred from the LS spec.
 OVERSEAS_STOCK_REJECT_CODES: Dict[str, Dict[str, str]] = {
+    # Live-verified 2026-08-24: deliberately submitted OrdQty=0.1 (COSAT00301,
+    # limit buy far below market). The LS gateway rejected at its type-validation
+    # layer with HTTP 500 + rsp_cd IGW40011 "주문수량(OrdQty) data type을
+    # 확인하세요." — fractional order quantities are not accepted by this TR.
+    "IGW40011": {
+        "retry": RetryAdvice.RETRY_AFTER_FIX.value,
+        "cause": "The order quantity failed the LS gateway's data-type validation (non-integer quantity).",
+        "tip": "Order quantities must be integers; floor fractional quantities before ordering.",
+    },
     "02201": {
         "retry": RetryAdvice.RETRY_AFTER_FIX.value,
         "cause": "The account does not have enough cash to place this order.",

{programgarden_core-1.25.0 → programgarden_core-1.25.2}/programgarden_core/nodes/backtest_futures.py

@@ -200,6 +200,7 @@ class OverseasFuturesHistoricalDataNode(BaseNode):
             "OverseasFuturesHistoricalDataNode.value → LineChartNode (price history display)",
         ],
         "pitfalls": [
+            "`symbol: {{ item }}` / `{{ nodes.<split>.item }}` resolves only inside a per-symbol loop (auto-iterate over an upstream array, or a SplitNode branch). If the upstream array is empty for this run the node logs `No symbols to fetch` and returns an empty series — normal no-signal, not a defect. A `No symbols provided` WARNING means the symbol source is missing or the binding did not resolve",
             "Bind `.time_series` not `.value` to ConditionNode data — the value port wraps the list in a dict",
             "Use OverseasFuturesBrokerNode (not OverseasStockBrokerNode) upstream",
             "Contract month codes change every quarter — update symbol (e.g., ESH26 → ESM26) when rolling",

{programgarden_core-1.25.0 → programgarden_core-1.25.2}/programgarden_core/nodes/backtest_korea_stock.py

@@ -199,6 +199,7 @@ class KoreaStockHistoricalDataNode(BaseNode):
             "KoreaStockHistoricalDataNode.value → LineChartNode (domestic price history chart)",
         ],
         "pitfalls": [
+            "`symbol: {{ item }}` / `{{ nodes.<split>.item }}` resolves only inside a per-symbol loop (auto-iterate over an upstream array, or a SplitNode branch). If the upstream array is empty for this run the node logs `No symbols to fetch` and returns an empty series — normal no-signal, not a defect. A `No symbols provided` WARNING means the symbol source is missing or the binding did not resolve",
             "Access time_series via `{{ nodes.historical.value.time_series }}` — the value port wraps the list in a dict",
             "Intraday intervals (1m/5m/15m) not supported for Korean domestic stocks — use 1d minimum",
             "adjust=True is the default; set False only if you specifically need unadjusted prices",

{programgarden_core-1.25.0 → programgarden_core-1.25.2}/programgarden_core/nodes/backtest_stock.py

@@ -201,6 +201,7 @@ class OverseasStockHistoricalDataNode(BaseNode):
             "OverseasStockHistoricalDataNode.value → LineChartNode (price chart display)",
         ],
         "pitfalls": [
+            "`symbol: {{ item }}` / `{{ nodes.<split>.item }}` resolves only inside a per-symbol loop (auto-iterate over an upstream array, or a SplitNode branch). If the upstream array is empty for this run the node logs `No symbols to fetch` and returns an empty series — normal no-signal, not a defect. A `No symbols provided` WARNING means the symbol source is missing or the binding did not resolve",
             "Access time_series via `{{ nodes.historical.value.time_series }}` — the value port is a dict, not a plain list",
             "Intraday intervals (1m/5m/15m/1h) may have limited history depth depending on LS Securities API availability",
             "adjust=False (default) returns unadjusted prices; set True when comparing long-term price levels across splits",

{programgarden_core-1.25.0 → programgarden_core-1.25.2}/programgarden_core/nodes/data_futures.py

@@ -178,6 +178,7 @@ class OverseasFuturesMarketDataNode(BaseNode):
             "OverseasFuturesMarketDataNode.values → PositionSizingNode.market_data (with symbols + balance)",
         ],
         "pitfalls": [
+            "If the bound symbol source (ConditionNode.passed_symbols / SymbolFilterNode.symbols) is empty for this run the node returns values=[] with no error (normal no-signal). The `symbols 필드가 필수입니다` error is raised only when no symbol source is configured or the binding did not resolve",
             "Symbol must include contract month code (e.g., ESH26 not ES) — check OverseasFuturesSymbolQueryNode for valid codes",
             "Use OverseasFuturesBrokerNode (not OverseasStockBrokerNode) as the upstream broker",
             "REST polling returns a snapshot; for tick-level streaming use OverseasFuturesRealMarketDataNode",

{programgarden_core-1.25.0 → programgarden_core-1.25.2}/programgarden_core/nodes/data_korea_stock.py

@@ -183,6 +183,7 @@ class KoreaStockMarketDataNode(BaseNode):
             "KoreaStockSymbolQueryNode/ConditionNode.passed_symbols → PositionSizingNode.symbols (canonical symbol list)",
         ],
         "pitfalls": [
+            "If the bound symbol source (ConditionNode.passed_symbols / SymbolFilterNode.symbols) is empty for this run the node returns values=[] with no error (normal no-signal). The `symbols 필드가 필수입니다` error is raised only when no symbol source is configured or the binding did not resolve",
             "KoreaStock does not support paper trading — KoreaStockBrokerNode always uses a live session",
             "Symbol must be a 6-digit KRX code without exchange field — do not include exchange key",
             "REST polling returns a snapshot; for tick-level streaming use KoreaStockRealMarketDataNode",

{programgarden_core-1.25.0 → programgarden_core-1.25.2}/programgarden_core/nodes/data_stock.py

@@ -184,6 +184,7 @@ class OverseasStockMarketDataNode(BaseNode):
             "OverseasStockMarketDataNode.values → PositionSizingNode.market_data (with symbols + balance)",
         ],
         "pitfalls": [
+            "If the bound symbol source (ConditionNode.passed_symbols / SymbolFilterNode.symbols) is empty for this run the node returns values=[] with no error (normal no-signal). The `symbols 필드가 필수입니다` error is raised only when no symbol source is configured or the binding did not resolve",
             "The symbol field must be a single dict — not a list. Use SplitNode for multi-symbol scenarios",
             "REST polling returns a snapshot at call time; for tick-level streaming use OverseasStockRealMarketDataNode",
             "OverseasStockBrokerNode must be upstream via a main edge for connection auto-injection to work",

{programgarden_core-1.25.0 → programgarden_core-1.25.2}/programgarden_core/nodes/risk.py

@@ -143,6 +143,7 @@ class PositionSizingNode(BaseNode):
             "Standardize risk exposure across different strategies (share the same PositionSizingNode config)",
         ],
         "when_not_to_use": [
+            "Buying/selling a FIXED quantity of every symbol that passed a ConditionNode / SymbolFilterNode — you do not need sizing at all: wire the condition/filter straight into NewOrderNode (it auto-iterates the symbol list) and set `quantity` on the order node",
             "Fixed-quantity simple tests — set `quantity` directly on NewOrderNode and skip sizing entirely",
             "Portfolio-level rebalancing — use PortfolioNode to compute allocations first, then size each leg",
             "Per-leg position-management signals (stop-loss / trailing) — that lives in ConditionNode with position-management plugins",
@@ -292,6 +293,7 @@ class PositionSizingNode(BaseNode):
             "AccountNode + MarketDataNode → PositionSizingNode(atr_based) → NewOrderNode",
         ],
         "pitfalls": [
+            "`symbols` bound to ConditionNode.passed_symbols / SymbolFilterNode.symbols may legitimately be EMPTY on a given run (no symbol met the condition today). The node then emits orders=[] with reason='no_signal' and logs an info line — that is normal runtime behaviour, not a wiring defect, and it does not block saving. A `No symbols provided for position sizing` WARNING means the symbol source itself is missing or the binding did not resolve (unknown node id / output port, or `{{ item }}` used outside a per-symbol loop) — fix the wiring in that case only",
             "`symbol` must be the object form, not a plain string",
             "method='kelly' needs kelly_fraction <= 1.0 (quarter-Kelly = 0.25 is a sane default)",
             "method='atr_based' needs `market_data` bound — otherwise the fallback produces a zero / tiny quantity",

{programgarden_core-1.25.0 → programgarden_core-1.25.2}/pyproject.toml

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