programgarden 2.5.0__tar.gz → 2.5.2__tar.gz

{programgarden-2.5.0 → programgarden-2.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: programgarden
-Version: 2.5.0
+Version: 2.5.2
 Summary: ProgramGarden - 노드 기반 자동매매 DSL 실행 엔진
 License-Expression: AGPL-3.0-or-later
 Author: 프로그램동산
@@ -15,8 +15,8 @@ Requires-Dist: aiosqlite (>=0.20.0,<0.21.0)
 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.0,<3.0.0)
-Requires-Dist: programgarden-core (>=2.5.0,<3.0.0)
+Requires-Dist: programgarden-community (>=2.3.1,<3.0.0)
+Requires-Dist: programgarden-core (>=2.5.2,<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
 
+The REST overseas-stock account output preserves broker-reported `sellable_qty`
+separately from holdings; absent capacity remains null. See
+[the sell-capacity contract](../../docs/overseas-stock-sellable-quantity.md).
+
 Unreleased execution reconciliation work is documented in
 [execution-reconciliation.md](../../docs/execution-reconciliation.md). Its
 optional host storage identity is not yet enabled in deployed worker/tray hosts;

{programgarden-2.5.0 → programgarden-2.5.2}/README.md

@@ -1,5 +1,9 @@
 # ProgramGarden
 
+The REST overseas-stock account output preserves broker-reported `sellable_qty`
+separately from holdings; absent capacity remains null. See
+[the sell-capacity contract](../../docs/overseas-stock-sellable-quantity.md).
+
 Unreleased execution reconciliation work is documented in
 [execution-reconciliation.md](../../docs/execution-reconciliation.md). Its
 optional host storage identity is not yet enabled in deployed worker/tray hosts;

{programgarden-2.5.0 → programgarden-2.5.2}/programgarden/executor.py

@@ -2257,7 +2257,15 @@ class ScheduleNodeExecutor(NodeExecutorBase):
         # 2026-09-26). A provided value is enforced as a cap in the loop below.
         count = config.get("count")  # None → no cycle cap
         max_duration_hours = config.get("max_duration_hours")  # None → no wall-clock cap
-        
+        # Schedule jitter (owner 2026-09-28): stagger each fire 0..jitter_seconds past
+        # the cron instant so many same-cron workflows do not stampede a shared egress
+        # IP. Clamp to [0, 300]; a non-numeric value falls back to 0 (no jitter).
+        try:
+            jitter_seconds = int(config.get("jitter_seconds", 0) or 0)
+        except (TypeError, ValueError):
+            jitter_seconds = 0
+        jitter_seconds = max(0, min(jitter_seconds, 300))
+
         if not enabled:
             context.log("info", f"Schedule disabled: {cron_expr}", node_id)
             return {"trigger": False}
@@ -2289,6 +2297,7 @@ class ScheduleNodeExecutor(NodeExecutorBase):
         # 백그라운드 스케줄러 태스크
         async def scheduler_task():
             import time as _time
+            import random as _random
             cnt = 0
             start_mono = _time.monotonic()
             # None = unbounded; only compute a wall-clock cap when a bound was set.
@@ -2349,10 +2358,30 @@ class ScheduleNodeExecutor(NodeExecutorBase):
                         sleep_time = min(delay, 1.0)
                         await asyncio.sleep(sleep_time)
                         delay -= sleep_time
-                    
+
                     if not context.is_running:
                         break
-                    
+
+                    # 스케줄 지터 (오너 2026-09-28): 같은 cron 순간을 공유하는 여러
+                    # 워크플로우가 공유 egress IP 로 동시에 몰리는 것을 막으려, 실제 실행을
+                    # cron 순간 이후 0~jitter 초 랜덤 지연한다. cron 케이던스 앵커는 그대로다.
+                    # dry_run 은 위에서 단일 틱 emit 후 break 하므로 여기 도달하지 않는다
+                    # (빌드 예산·replay 의미에 영향 없음).
+                    if jitter_seconds > 0 and context.is_running:
+                        jitter_delay = _random.uniform(0, jitter_seconds)
+                        context.log(
+                            "debug",
+                            f"Schedule jitter: delaying fire by {jitter_delay:.1f}s "
+                            f"(0..{jitter_seconds}s)",
+                            node_id,
+                        )
+                        while jitter_delay > 0 and context.is_running:
+                            sleep_time = min(jitter_delay, 1.0)
+                            await asyncio.sleep(sleep_time)
+                            jitter_delay -= sleep_time
+                        if not context.is_running:
+                            break
+
                     # 스케줄 시간 도달 - 이벤트 발생
                     cnt += 1
                     context.log("info", f"Schedule tick #{cnt}: {cron_expr}", node_id)
@@ -5937,6 +5966,12 @@ class AccountNodeExecutor(NodeExecutorBase):
                 "name": item.JpnMktHanglIsuNm.strip() if item.JpnMktHanglIsuNm else symbol,
                 "qty": item.AstkBalQty,
                 "quantity": item.AstkBalQty,  # NewOrderNode 호환
+                # SDK defaults are not evidence that LS returned this quantity.
+                "sellable_qty": (
+                    item.AstkSellAbleQty
+                    if "AstkSellAbleQty" in getattr(item, "model_fields_set", set())
+                    else None
+                ),
                 "direction": "long",  # 주식은 보유=매수(long)
                 "close_side": "sell",  # 청산=매도
                 "avg_price": item.FcstckUprc,

{programgarden-2.5.0 → programgarden-2.5.2}/pyproject.toml

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