feat: add governed service workflow launcher

src/govoplan_workflow_engine/backend/manifest.py

@@ -14,6 +14,7 @@ from govoplan_core.core.module_guards import (
     persistent_table_uninstall_guard,
 )
 from govoplan_core.core.modules import (
+    CapabilityDocumentation,
     DocumentationTopic,
     MigrationSpec,
     ModuleContext,
@@ -23,6 +24,7 @@ from govoplan_core.core.modules import (
     PermissionDefinition,
     RoleTemplate,
 )
+from govoplan_core.core.provider_governance import declared_module_architecture
 from govoplan_core.core.policy import (
     CAPABILITY_POLICY_DEFINITION_GOVERNANCE,
 )
@@ -41,6 +43,10 @@ from govoplan_workflow_engine.backend.db import models as workflow_models
 from govoplan_workflow_engine.backend.configuration_provider import (
     WORKFLOW_CONFIGURATION_CAPABILITY,
 )
+from govoplan_workflow_engine.backend.service_launcher import (
+    CAPABILITY_WORKFLOW_SERVICE_LAUNCHER,
+    WorkflowServiceLauncher,
+)
 
 
 MODULE_ID = "workflow_engine"
@@ -164,6 +170,10 @@ def _orchestration_provider(context: ModuleContext):
     return SqlWorkflowOrchestrationProvider(registry=context.registry)
 
 
+def _service_launcher(context: ModuleContext) -> WorkflowServiceLauncher:
+    return WorkflowServiceLauncher(registry=context.registry)
+
+
 manifest = ModuleManifest(
     id=MODULE_ID,
     name=MODULE_NAME,
@@ -209,6 +219,10 @@ manifest = ModuleManifest(
         ),
         ModuleInterfaceProvider(name="workflow.runtime_worker", version=MODULE_VERSION),
         ModuleInterfaceProvider(name="workflow.bpmn_interchange", version="1.0.0"),
+        ModuleInterfaceProvider(
+            name=CAPABILITY_WORKFLOW_SERVICE_LAUNCHER,
+            version="0.1.0",
+        ),
         ModuleInterfaceProvider(
             name="workflow.bpmn_execution_adapters",
             version="1.0.0",
@@ -262,6 +276,14 @@ manifest = ModuleManifest(
         CAPABILITY_WORKFLOW_RUNTIME_WORKER: _runtime_worker,
         CAPABILITY_WORKFLOW_ORCHESTRATION: _orchestration_provider,
         WORKFLOW_CONFIGURATION_CAPABILITY: _configuration_provider,
+        CAPABILITY_WORKFLOW_SERVICE_LAUNCHER: _service_launcher,
+    },
+    capability_documentation={
+        CAPABILITY_WORKFLOW_SERVICE_LAUNCHER: CapabilityDocumentation(
+            label="Workflow service launcher",
+            summary="Starts an authorized active Workflow from an exact available Service revision.",
+            contract_version="0.1.0",
+        ),
     },
     migration_spec=MigrationSpec(
         module_id=MODULE_ID,
@@ -302,7 +324,9 @@ manifest = ModuleManifest(
                 "Unlike Dataflow, Workflow permits cycles for correction and retry paths. "
                 "Module actions are addressed through versioned capabilities rather than "
                 "implementation imports. Definitions are persisted as immutable graph "
-                "revisions; activation pins the exact revision used by future instances."
+                "revisions; activation pins the exact revision used by future instances. "
+                "The optional service-launch capability starts an authorized active "
+                "revision from an exact Portal Service binding and records that provenance."
             ),
             layer="available",
             documentation_types=("admin", "user"),
@@ -338,6 +362,19 @@ manifest = ModuleManifest(
             order=77,
         ),
     ),
+    architecture=declared_module_architecture(
+        layer="human_work_procedure",
+        kind="runtime",
+        maturity="vertical_slice",
+        documentation_ref="docs/ENGINE_EDITOR_SPLIT.md",
+        test_ref="tests/test_instance_service.py",
+        known_limits=("Execution adapters support declared conformance profiles but do not cover every editable BPMN semantic.",),
+        owned_concepts=("workflow definition", "workflow revision", "workflow instance", "work transition", "execution adapter binding"),
+        non_owned_concepts=("visual editor", "domain action", "notification", "dataflow run"),
+        recovery_docs=("docs/CONCEPT.md",),
+        security_docs=("docs/CONCEPT.md",),
+        operations_docs=("README.md",),
+    ),
 )