From 4aa19840bc5e272adfefc7649d7a3d14ed6238f1 Mon Sep 17 00:00:00 2001
From: Albrecht Degering <albrecht@degering.name>
Date: Mon, 24 Aug 2026 11:36:53 +0200
Subject: [PATCH] feat(workflow): document destructive definition changes

---
 pyproject.toml                                    |  2 +-
 src/govoplan_workflow/__init__.py                 |  2 +-
 src/govoplan_workflow/backend/manifest.py         | 13 ++++++++++---
 tests/test_manifest.py                            |  2 +-
 webui/package.json                                |  2 +-
 webui/src/features/workflow/WorkflowInspector.tsx |  4 ++++
 webui/src/features/workflow/WorkflowPage.tsx      |  2 ++
 7 files changed, 20 insertions(+), 7 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index da3c95a..d4eefa9 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "govoplan-workflow"
-version = "0.1.21"
+version = "0.1.22"
 description = "Optional visual authoring and inspection workspace for GovOPlaN Workflow Engine."
 readme = "README.md"
 requires-python = ">=3.12"
diff --git a/src/govoplan_workflow/__init__.py b/src/govoplan_workflow/__init__.py
index 4f35d13..9088d5f 100644
--- a/src/govoplan_workflow/__init__.py
+++ b/src/govoplan_workflow/__init__.py
@@ -1,3 +1,3 @@
 """Optional GovOPlaN Workflow editor and compatibility package."""
 
-__version__ = "0.1.21"
+__version__ = "0.1.22"
diff --git a/src/govoplan_workflow/backend/manifest.py b/src/govoplan_workflow/backend/manifest.py
index 8791cd4..442e4ab 100644
--- a/src/govoplan_workflow/backend/manifest.py
+++ b/src/govoplan_workflow/backend/manifest.py
@@ -35,7 +35,7 @@ from govoplan_workflow_engine.backend.manifest import (
 
 MODULE_ID = "workflow"
 MODULE_NAME = "Workflow"
-MODULE_VERSION = "0.1.21"
+MODULE_VERSION = "0.1.22"
 SEMANTIC_SUBJECT_CAPABILITY = semantic_documentation_subject_capability(MODULE_ID)
 
 
@@ -270,7 +270,10 @@ manifest = ModuleManifest(
                 "catalogue, immutable revision comparison, activation controls, "
                 "instance inspection, and governed override/reset experience. "
                 "Definitions and instances remain owned and executed by the "
-                "headless Workflow Engine module."
+                "headless Workflow Engine module. Deleting a flow or node changes only "
+                "the editable draft until that definition is saved; deleting a workflow "
+                "removes its definition revisions and requires explicit confirmation. "
+                "Retained execution and audit evidence remains governed by Workflow Engine."
             ),
             layer="available",
             documentation_types=("admin", "user"),
@@ -289,10 +292,14 @@ manifest = ModuleManifest(
                     "summary": "Optionale Erstellung, Validierung, Revisionsprüfung und Betriebssteuerung für Workflow Engine.",
                     "body": (
                         "Workflow ergänzt den visuellen BPMN- und nativen Graph-Editor, den Definitionskatalog, den Vergleich unveränderlicher Revisionen, Aktivierungssteuerung, Instanzprüfung und gesteuerte Eingriffe zum Überschreiben oder Zurücksetzen. "
-                        "Definitionen und Instanzen bleiben Eigentum des ohne eigene Bedienoberfläche betriebenen Moduls Workflow Engine und werden dort ausgeführt."
+                        "Definitionen und Instanzen bleiben Eigentum des ohne eigene Bedienoberfläche betriebenen Moduls Workflow Engine und werden dort ausgeführt. Das Löschen eines Flusses oder Knotens verändert nur den bearbeitbaren Entwurf, bis die Definition gespeichert wird. Das Löschen eines Workflows entfernt dessen Definitionsrevisionen und verlangt eine ausdrückliche Bestätigung. Aufbewahrte Ausführungs- und Auditnachweise bleiben durch Workflow Engine geregelt."
                     ),
                 }
             },
+            metadata={
+                "kind": "reference",
+                "help_contexts": ["workflow.action.delete-definition-parts"],
+            },
             order=76,
         ),
     ),
diff --git a/tests/test_manifest.py b/tests/test_manifest.py
index f0e0a99..b3021b3 100644
--- a/tests/test_manifest.py
+++ b/tests/test_manifest.py
@@ -11,7 +11,7 @@ class WorkflowManifestTests(unittest.TestCase):
         manifest = get_manifest()
 
         self.assertEqual("workflow", manifest.id)
-        self.assertEqual("0.1.21", manifest.version)
+        self.assertEqual("0.1.22", manifest.version)
         self.assertEqual(("workflow_engine",), manifest.dependencies)
         self.assertEqual(
             {"workflow.definition_graph", "workflow.definition_catalogue", "workflow.bpmn_interchange"},
diff --git a/webui/package.json b/webui/package.json
index 3a8f90c..638df41 100644
--- a/webui/package.json
+++ b/webui/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@govoplan/workflow-webui",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "private": true,
   "type": "module",
   "main": "src/index.ts",
diff --git a/webui/src/features/workflow/WorkflowInspector.tsx b/webui/src/features/workflow/WorkflowInspector.tsx
index ebb5d1c..8704b9b 100644
--- a/webui/src/features/workflow/WorkflowInspector.tsx
+++ b/webui/src/features/workflow/WorkflowInspector.tsx
@@ -101,6 +101,8 @@ export default function WorkflowInspector({
           </span>
           <Button
             variant="ghost"
+            helpContextId="workflow.action.delete-definition-parts"
+            helpModuleId="workflow"
             className="workflow-inspector-delete"
             onClick={() => onEdgeDelete(edge.id)}
             disabled={readOnly}
@@ -232,6 +234,8 @@ export default function WorkflowInspector({
           </> : null}
           <Button
             variant="ghost"
+            helpContextId="workflow.action.delete-definition-parts"
+            helpModuleId="workflow"
             className="workflow-inspector-delete"
             onClick={() => onDelete(node.id)}
             disabled={readOnly}
diff --git a/webui/src/features/workflow/WorkflowPage.tsx b/webui/src/features/workflow/WorkflowPage.tsx
index ac68f42..f480692 100644
--- a/webui/src/features/workflow/WorkflowPage.tsx
+++ b/webui/src/features/workflow/WorkflowPage.tsx
@@ -874,6 +874,8 @@ export default function WorkflowPage({
                 destructiveActions={draft.id && draft.standard?.kind !== "baseline" ? (
                   <IconButton
                     label="Delete workflow"
+                    helpContextId="workflow.action.delete-definition-parts"
+                    helpModuleId="workflow"
                     icon={<Trash2 size={16} />}
                     variant="danger"
                     onClick={() => setDeleteOpen(true)}