programgarden-core 1.25.3__tar.gz → 1.26.0__tar.gz

{programgarden_core-1.25.3 → programgarden_core-1.26.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: programgarden-core
-Version: 1.25.3
+Version: 1.26.0
 Summary: ProgramGarden Core - 노드 기반 DSL 핵심 타입 정의
 License-Expression: AGPL-3.0-or-later
 Author: 프로그램동산
@@ -113,3 +113,13 @@ is inferred from these estimates. Actual zero and negative amounts are retained.
 `currency` is null for mixed or unavailable currencies. Consumers must handle
 nullable monetary fields and must not coerce them to zero.
 
+`WorkflowPnLEvent.personal_metrics` is an optional versioned envelope for retained
+local workflow executions. Version 1 includes `scope` (kind, product, provider,
+trading mode), timezone-aware `as_of`, `basis`, executed-order count/status,
+per-symbol/exchange/currency realized amounts/status, and unavailable MDD.
+It is unverified personal evidence, independent of whole-account contest results.
+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.
+

{programgarden_core-1.25.3 → programgarden_core-1.26.0}/README.md

@@ -97,3 +97,13 @@ monetary/rate scalars remain null when accounting evidence is unavailable.
 is inferred from these estimates. Actual zero and negative amounts are retained.
 `currency` is null for mixed or unavailable currencies. Consumers must handle
 nullable monetary fields and must not coerce them to zero.
+
+`WorkflowPnLEvent.personal_metrics` is an optional versioned envelope for retained
+local workflow executions. Version 1 includes `scope` (kind, product, provider,
+trading mode), timezone-aware `as_of`, `basis`, executed-order count/status,
+per-symbol/exchange/currency realized amounts/status, and unavailable MDD.
+It is unverified personal evidence, independent of whole-account contest results.
+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.

{programgarden_core-1.25.3 → programgarden_core-1.26.0}/programgarden_core/bases/listener.py

@@ -346,6 +346,8 @@ class WorkflowPnLEvent:
     pnl_by_currency: Dict[str, Any] = field(default_factory=dict)
     monetary_positions: Dict[str, Any] = field(default_factory=dict)
     unavailable_position_count: int = 0
+    # Unverified retained workflow executions; separate from account/contest PnL.
+    personal_metrics: Optional[Dict[str, Any]] = None
 
     # ========== NEW FIELDS (v2.0) ==========
 

{programgarden_core-1.25.3 → programgarden_core-1.26.0}/pyproject.toml

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