feat(workflow): orchestrate resumable dataflow handoffs

src/govoplan_workflow/backend/manifest.py

@@ -4,6 +4,7 @@ from pathlib import Path
 
 from govoplan_core.core.access import (
     CAPABILITY_ACCESS_DIRECTORY,
+    CAPABILITY_AUTH_AUTOMATION_PRINCIPAL_PROVIDER,
     CAPABILITY_AUTH_PERMISSION_EVALUATOR,
     CAPABILITY_AUTH_PRINCIPAL_RESOLVER,
 )
@@ -28,8 +29,14 @@ from govoplan_core.core.modules import (
 from govoplan_core.core.policy import (
     CAPABILITY_POLICY_DEFINITION_GOVERNANCE,
 )
+from govoplan_core.core.notifications import (
+    CAPABILITY_NOTIFICATIONS_DISPATCH,
+)
 from govoplan_core.core.references import CAPABILITY_ACCESS_REFERENCE_OPTIONS
 from govoplan_core.core.views import CAPABILITY_VIEWS_RESOLVER
+from govoplan_core.core.workflows import (
+    CAPABILITY_WORKFLOW_RUNTIME_WORKER,
+)
 from govoplan_core.db.base import Base
 from govoplan_workflow.backend.db import models as workflow_models
 
@@ -123,6 +130,14 @@ def _router(context: ModuleContext):
     return router
 
 
+def _runtime_worker(context: ModuleContext):
+    from govoplan_workflow.backend.instance_service import (
+        SqlWorkflowRuntimeWorker,
+    )
+
+    return SqlWorkflowRuntimeWorker(registry=context.registry)
+
+
 manifest = ModuleManifest(
     id=MODULE_ID,
     name=MODULE_NAME,
@@ -141,9 +156,11 @@ manifest = ModuleManifest(
     optional_capabilities=(
         CAPABILITY_ACCESS_DIRECTORY,
         CAPABILITY_ACCESS_REFERENCE_OPTIONS,
+        CAPABILITY_AUTH_AUTOMATION_PRINCIPAL_PROVIDER,
         CAPABILITY_AUTH_PRINCIPAL_RESOLVER,
         CAPABILITY_AUTH_PERMISSION_EVALUATOR,
         CAPABILITY_DATAFLOW_RUN_LIFECYCLE,
+        CAPABILITY_NOTIFICATIONS_DISPATCH,
         CAPABILITY_POLICY_DEFINITION_GOVERNANCE,
         CAPABILITY_VIEWS_RESOLVER,
     ),
@@ -151,6 +168,7 @@ manifest = ModuleManifest(
         ModuleInterfaceProvider(name="workflow.definition_graph", version="0.1.0"),
         ModuleInterfaceProvider(name="workflow.node_library", version="0.1.0"),
         ModuleInterfaceProvider(name="workflow.definition_catalogue", version="0.1.0"),
+        ModuleInterfaceProvider(name="workflow.runtime_worker", version=MODULE_VERSION),
     ),
     requires_interfaces=(
         ModuleInterfaceRequirement(
@@ -165,6 +183,18 @@ manifest = ModuleManifest(
             version_max_exclusive="1.0.0",
             optional=True,
         ),
+        ModuleInterfaceRequirement(
+            name="auth.automation_principal",
+            version_min="0.1.0",
+            version_max_exclusive="1.0.0",
+            optional=True,
+        ),
+        ModuleInterfaceRequirement(
+            name=CAPABILITY_NOTIFICATIONS_DISPATCH,
+            version_min="0.1.0",
+            version_max_exclusive="1.0.0",
+            optional=True,
+        ),
         ModuleInterfaceRequirement(
             name="policy.definition_governance",
             version_min="0.1.0",
@@ -211,12 +241,18 @@ manifest = ModuleManifest(
         ),
     ),
     route_factory=_router,
+    capability_factories={
+        CAPABILITY_WORKFLOW_RUNTIME_WORKER: _runtime_worker,
+    },
     migration_spec=MigrationSpec(
         module_id=MODULE_ID,
         metadata=Base.metadata,
         script_location=str(Path(__file__).with_name("migrations") / "versions"),
         retirement_supported=True,
         retirement_provider=drop_table_retirement_provider(
+            workflow_models.WorkflowInstanceEvent,
+            workflow_models.WorkflowInstanceStep,
+            workflow_models.WorkflowInstance,
             workflow_models.WorkflowDefinitionRevision,
             workflow_models.WorkflowDefinition,
             label="Workflow",
@@ -230,6 +266,9 @@ manifest = ModuleManifest(
         persistent_table_uninstall_guard(
             workflow_models.WorkflowDefinition,
             workflow_models.WorkflowDefinitionRevision,
+            workflow_models.WorkflowInstance,
+            workflow_models.WorkflowInstanceStep,
+            workflow_models.WorkflowInstanceEvent,
             label="Workflow",
         ),
     ),