programgarden-core 1.28.2__tar.gz → 1.29.0__tar.gz

{programgarden_core-1.28.2 → programgarden_core-1.29.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: programgarden-core
-Version: 1.28.2
+Version: 1.29.0
 Summary: ProgramGarden Core - 노드 기반 DSL 핵심 타입 정의
 License-Expression: AGPL-3.0-or-later
 Author: 프로그램동산
@@ -123,3 +123,11 @@ unknown currency stays null. Futures monetary values and portfolio MDD require
 accounting evidence absent from this ledger and remain null. Consumers must
 preserve null/status and use the latest cumulative observation, not sum dates.
 
+## Workflow account boundary
+
+Each workflow allows one account and one product through at most one broker
+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).
+

{programgarden_core-1.28.2 → programgarden_core-1.29.0}/README.md

@@ -107,3 +107,11 @@ Stock realized amounts are stored long-only FIFO gross values excluding fees;
 unknown currency stays null. Futures monetary values and portfolio MDD require
 accounting evidence absent from this ledger and remain null. Consumers must
 preserve null/status and use the latest cumulative observation, not sum dates.
+
+## Workflow account boundary
+
+Each workflow allows one account and one product through at most one broker
+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).

{programgarden_core-1.28.2 → programgarden_core-1.29.0}/programgarden_core/bases/listener.py

@@ -412,6 +412,9 @@ class WorkflowPnLEvent:
     # Open-position money, independent of closed-trade personal metrics.
     account_valuation: Optional[Dict[str, Any]] = None
     workflow_valuation: Optional[Dict[str, Any]] = None
+    # Dated account assets/flows, separate from workflow holdings or official scoring.
+    account_snapshot: Optional[Dict[str, Any]] = None
+    account_daily_snapshots: Optional[Dict[str, Any]] = None
 
 
 # ============================================================

{programgarden_core-1.28.2 → programgarden_core-1.29.0}/programgarden_core/models/workflow.py

@@ -13,6 +13,44 @@ from programgarden_core.models.edge import Edge
 from programgarden_core.models.resource import ResourceLimits
 
 
+def validate_broker_connections(nodes: List[Dict[str, Any]]) -> List["ErrorInfo"]:
+    """Allow at most one account/product connection, including unbound brokers.
+
+    Inspect registered connection ports so aliases and custom broker node types
+    use the same rule. Reusing one connection through multiple edges is allowed;
+    account-free workflows and unrelated credential types remain unaffected.
+    """
+    from programgarden_core.registry import NodeTypeRegistry
+    from programgarden_core.models.validation import ErrorCode, ErrorLocation, build_error
+
+    registry = NodeTypeRegistry()
+    brokers = []
+    for node in nodes:
+        schema = registry.get_schema(node.get("type"))
+        if schema and any(port.get("type") == "broker_connection" for port in schema.outputs):
+            brokers.append(node)
+    if len(brokers) <= 1:
+        return []
+
+    broker_ids = [node.get("id") for node in brokers]
+    return [
+        build_error(
+            ErrorCode.DUPLICATE_BROKER_NODE,
+            "Duplicate broker connection: a workflow allows only one account and one product",
+            location=ErrorLocation(node_id=node.get("id"), node_type=node.get("type")),
+            suggestion=(
+                "Reuse the existing broker node for every consumer. Create a separate "
+                "workflow for another account or product; do not add another broker."
+            ),
+            details={
+                "existing": broker_ids[0], "duplicate": node.get("id"),
+                "broker_node_ids": broker_ids, "max_broker_connections": 1,
+            },
+        )
+        for node in brokers[1:]
+    ]
+
+
 class InputType(str, Enum):
     """워크플로우 입력 타입"""
 
@@ -220,7 +258,7 @@ class WorkflowDefinition(BaseModel):
             build_error,
         )
 
-        errors: List[ErrorInfo] = []
+        errors: List[ErrorInfo] = validate_broker_connections(self.nodes)
 
         # 1. Duplicate node IDs
         node_ids = self.get_node_ids()

{programgarden_core-1.28.2 → programgarden_core-1.29.0}/programgarden_core/nodes/broker.py

@@ -111,7 +111,7 @@ class OverseasStockBrokerNode(BaseBrokerNode):
         {
             "pattern": "Wiring a single broker across overseas_stock and overseas_futures nodes",
             "reason": "Product scope is a hard separator — overseas_futures nodes ignore stock-broker connections and the executor's auto-inject picks the wrong credential.",
-            "alternative": "Add OverseasFuturesBrokerNode in parallel; each product scope's nodes pick up its matching broker automatically.",
+            "alternative": "Use a separate workflow for overseas futures. Each workflow allows only one account and one product; reuse its existing broker node.",
         },
         {
             "pattern": "Omitting OverseasStockBrokerNode when using overseas_stock nodes",
@@ -207,7 +207,7 @@ class OverseasStockBrokerNode(BaseBrokerNode):
         ],
         "pitfalls": [
             "paper_trading must be false — overseas_stock has no LS-Sec paper trading channel",
-            "One workflow can have only one OverseasStockBrokerNode; duplicates compete for credential injection",
+            "A workflow allows at most one broker connection across all products and accounts, including unbound nodes; reuse that node for all consumers",
             "Credential type must be `broker_ls_overseas_stock` exactly; `broker_ls_overseas_futureoption` will not match",
         ],
     }
@@ -367,7 +367,7 @@ class OverseasFuturesBrokerNode(BaseBrokerNode):
         "pitfalls": [
             "Credential type must be `broker_ls_overseas_futureoption`",
             "paper_trading=True is not a full sandbox — some TRs still hit the real datafeed; always double-check order nodes before production",
-            "Each workflow holds exactly one futures broker; if you also trade stocks, add OverseasStockBrokerNode in parallel",
+            "Use one account and one product per workflow. Trade stocks in a separate workflow instead of adding a second broker",
         ],
     }
 
@@ -547,6 +547,7 @@ class KoreaStockBrokerNode(BaseBrokerNode):
         ],
         "pitfalls": [
             "Credential type must be `broker_ls_korea_stock` — overseas credentials will not match even though the fields are identical",
+            "Use one account and one product per workflow; reuse this broker for every domestic consumer instead of adding a second connection",
             "Every live order counts — always gate order nodes behind IfNode or ConditionNode when experimenting",
             "Use `dry_run=True` in ExecutionContext for sandbox runs (paper trading is not available at the LS-Sec level)",
         ],

{programgarden_core-1.28.2 → programgarden_core-1.29.0}/pyproject.toml

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