refactor(workflow): drop propagate_lineage/propagate_own_history factories

Per review feedback, Go-style factory helpers are not idiomatic Python: they
obscure the actual enum value at the call site and confuse static type
checkers (return annotation only shows PropagationScope, not the specific
member). Use PropagationScope.LINEAGE / PropagationScope.OWN_HISTORY
directly instead.

Signed-off-by: Nelson Parente <nelson_parente@live.com.pt>

Author: nelson-parente

examples/workflow/README.md

@@ -544,9 +544,9 @@ history to a child workflow and to an activity, and how the receivers query
 that history through `ctx.get_propagated_history()`.
 
 It shows:
-- `propagation=propagate_own_history()` on a child workflow call —
+- `propagation=PropagationScope.OWN_HISTORY` on a child workflow call —
   forwards the caller's events only.
-- `propagation=propagate_lineage()` on an activity call — forwards the
+- `propagation=PropagationScope.LINEAGE` on an activity call — forwards the
   caller's events *plus* anything the caller itself received from its parent.
 - `PropagatedHistory.get_last_workflow_by_name(...)` and
   `WorkflowResult.get_last_activity_by_name(...)` on the receiving side.

examples/workflow/history_propagation.py

@@ -13,8 +13,8 @@
 """History propagation example.
 
 The parent workflow runs a couple of activities, then calls a child workflow
-with ``propagation=propagate_own_history()`` and an activity with
-``propagation=propagate_lineage()``. The child workflow and the
+with ``propagation=PropagationScope.OWN_HISTORY`` and an activity with
+``propagation=PropagationScope.LINEAGE``. The child workflow and the
 downstream activity read the parent's recorded history via
 ``ctx.get_propagated_history()`` and inspect specific events by name.
 
@@ -106,14 +106,14 @@ def merchant_checkout(ctx: wf.DaprWorkflowContext, merchant_id: str):
     child_result = yield ctx.call_child_workflow(
         process_payment,
         input=None,
-        propagation=wf.propagate_own_history(),
+        propagation=wf.PropagationScope.OWN_HISTORY,
     )
     print(f'*** child workflow result: {child_result}', flush=True)
 
     audit = yield ctx.call_activity(
         log_summary,
         input=None,
-        propagation=wf.propagate_lineage(),
+        propagation=wf.PropagationScope.LINEAGE,
     )
     print(f'*** audit activity result: {audit}', flush=True)
     return {'child': child_result, 'audit': audit}

ext/dapr-ext-workflow/dapr/ext/workflow/__init__.py

@@ -25,8 +25,6 @@
     PropagationNotFoundError,
     PropagationScope,
     WorkflowResult,
-    propagate_lineage,
-    propagate_own_history,
 )
 from dapr.ext.workflow.retry_policy import RetryPolicy
 from dapr.ext.workflow.workflow_activity_context import WorkflowActivityContext
@@ -51,8 +49,6 @@
     'WorkflowResult',
     'ActivityResult',
     'ChildWorkflowResult',
-    'propagate_lineage',
-    'propagate_own_history',
     'DaprMCPClient',
     'MCPToolDef',
 ]

ext/dapr-ext-workflow/dapr/ext/workflow/propagation.py

@@ -34,33 +34,20 @@ class PropagationScope(Enum):
 
     Values map 1:1 to the protobuf ``HistoryPropagationScope`` enum; the
     plumbing layer reads ``.value`` when writing to proto fields.
+
+    * ``OWN_HISTORY`` — propagate the caller's events only; drop any ancestor
+      chain. Use as a trust boundary, where downstream code should only see
+      the immediate caller.
+    * ``LINEAGE`` — propagate the caller's events plus any ancestor events it
+      received. Use for chain-of-custody verification, where downstream code
+      needs visibility into the full lineage of upstream workflows.
     """
 
     NONE = int(pb.HISTORY_PROPAGATION_SCOPE_NONE)
     OWN_HISTORY = int(pb.HISTORY_PROPAGATION_SCOPE_OWN_HISTORY)
     LINEAGE = int(pb.HISTORY_PROPAGATION_SCOPE_LINEAGE)
 
 
-def propagate_lineage() -> PropagationScope:
-    """Propagate the caller's own events plus any ancestor events it received.
-
-    Use this for chain-of-custody verification, where downstream code needs
-    visibility into the full lineage of upstream workflows. Mirrors the
-    go-sdk ``workflow.PropagateLineage()`` helper.
-    """
-    return PropagationScope.LINEAGE
-
-
-def propagate_own_history() -> PropagationScope:
-    """Propagate the caller's events only; drop any ancestor chain.
-
-    Use this as a trust boundary, where downstream code should only see the
-    immediate caller. Mirrors the go-sdk ``workflow.PropagateOwnHistory()``
-    helper.
-    """
-    return PropagationScope.OWN_HISTORY
-
-
 class PropagationNotFoundError(Exception):
     """Raised when a query against propagated history finds no match."""
 

ext/dapr-ext-workflow/tests/durabletask/test_propagation.py

@@ -23,8 +23,6 @@
     PropagatedHistory,
     PropagationNotFoundError,
     PropagationScope,
-    propagate_lineage,
-    propagate_own_history,
 )
 from google.protobuf import wrappers_pb2
 
@@ -372,14 +370,3 @@ def test_from_proto_handles_empty_chunks():
     assert ph.events == []
     assert ph.get_app_ids() == []
     assert ph.get_workflows() == []
-
-
-# --- Factory helpers (go-sdk parity) ----------------------------------------
-
-
-def test_propagate_lineage_helper_returns_lineage_scope():
-    assert propagate_lineage() is PropagationScope.LINEAGE
-
-
-def test_propagate_own_history_helper_returns_own_history_scope():
-    assert propagate_own_history() is PropagationScope.OWN_HISTORY