fix(ui): align contextual documentation with headings

Verified with the coordinated workspace changes by devkit full run
2026-09-08T225814-186389-0000-3e3ed7cd (all seven phases passed).
This shared UI pass does not mark the individual module reviews complete.

README.md

@@ -10,3 +10,21 @@ Notifications keeps delivery state, and each domain module keeps its business
 objects and commands.
 
 See [Tasks Domain And Unified Work Inbox](docs/TASKS_DOMAIN.md).
+
+## Git-source WebUI package
+
+The repository root exposes `@govoplan/tasks-webui` for Git-tagged release
+dependencies. It mirrors the owning `webui/package.json` version, public
+TypeScript/CSS exports and peer requirements, with entry paths under
+`webui/src`. Consumers provide the shared Core/React peers; the facade runs no
+development or install scripts. The source archive contains `webui/src`, this
+README and any repository license file. Run module development checks from `webui/`; Python
+installation remains governed by `pyproject.toml`.
+
+Das Repository stellt `@govoplan/tasks-webui` am Wurzelpfad für versionierte
+Git-Abhängigkeiten bereit. Version, öffentliche TypeScript-/CSS-Exporte und
+Peer-Anforderungen entsprechen `webui/package.json`; die Einstiegspfade liegen
+unter `webui/src`. Gemeinsame Core-/React-Peers stellt die einbindende Anwendung
+bereit. Die Fassade führt keine Entwicklungs- oder Installationsskripte aus.
+Entwicklungsprüfungen bleiben in `webui/`, die Python-Installation weiterhin in
+`pyproject.toml` definiert.

package.json

@@ -1,8 +1,34 @@
 {
-  "name": "@govoplan/tasks",
+  "name": "@govoplan/tasks-webui",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "private": true,
   "description": "Governed work items and unified work inbox for GovOPlaN.",
   "type": "module",
-  "peerDependencies": {}
+  "peerDependencies": {
+    "@govoplan/core-webui": "^0.1.45",
+    "lucide-react": "^1.23.0",
+    "react": ">=19.2.7 <20",
+    "react-dom": ">=19.2.7 <20",
+    "react-router": ">=8.3.0 <9"
+  },
+  "main": "webui/src/index.ts",
+  "module": "webui/src/index.ts",
+  "types": "webui/src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./webui/src/index.ts",
+      "import": "./webui/src/index.ts"
+    },
+    "./styles/tasks.css": "./webui/src/styles/tasks.css"
+  },
+  "peerDependenciesMeta": {
+    "@govoplan/core-webui": {
+      "optional": true
+    }
+  },
+  "files": [
+    "webui/src",
+    "README.md",
+    "LICENSE"
+  ]
 }

pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "govoplan-tasks"
-version = "0.1.22"
+version = "0.1.23"
 description = "Governed work items and unified work inbox for GovOPlaN."
 readme = "README.md"
 requires-python = ">=3.12"
 authors = [{ name = "GovOPlaN" }]
 dependencies = [
-  "govoplan-core>=0.1.44",
+  "govoplan-core>=0.1.45",
   "govoplan-access>=0.1.18",
 ]
 

src/govoplan_tasks/__init__.py

@@ -1,3 +1,3 @@
 """GovOPlaN Tasks module."""
 
-__version__ = "0.1.22"
+__version__ = "0.1.23"

src/govoplan_tasks/backend/manifest.py

@@ -49,7 +49,7 @@ from govoplan_tasks.backend.service import SqlTaskService
 
 MODULE_ID = "tasks"
 MODULE_NAME = "Tasks"
-MODULE_VERSION = "0.1.22"
+MODULE_VERSION = "0.1.23"
 READ_SCOPE = "tasks:item:read"
 WRITE_SCOPE = "tasks:item:write"
 ADMIN_SCOPE = "tasks:item:admin"
@@ -136,6 +136,26 @@ ROLE_TEMPLATES = (
 )
 
 DOCUMENTATION = (
+    DocumentationTopic(
+        id="tasks.workspace-layout",
+        title="Tasks workspace actions",
+        summary="Find collection-wide commands in their consistent workspace position.",
+        body="Documentation books sit immediately beside the visible heading or contextual label for "
+        "Tasks, not among operational action buttons. Field help remains beside its label. "
+        "Reload and Create task use the persistent full-width workspace header at the upper right; Reload sits immediately before creation. Selecting a record, changing filters, or opening an editor does not move these collection-wide commands into the left pane. Search and status filters stay in the task list; completion, ownership, and other task-specific actions remain with the selected task. Existing permissions, disabled-state rules, and unsaved-change guards still apply. Administrators configure authority through the existing permission system; no new permission or automatic operation is introduced.",
+        layer="static",
+        documentation_types=("user", "admin"),
+        audience=("user", "module_admin", "operator"),
+        order=5,
+        translations={"de": {
+            "title": "Aufgaben: Aktionen im Arbeitsbereich",
+            "summary": "Sammlungsweite Aktionen an ihrer einheitlichen Position im Arbeitsbereich finden.",
+            "body": "Dokumentationsbücher stehen unmittelbar neben der sichtbaren Überschrift oder "
+            "Kontextbezeichnung für Aufgaben, nicht zwischen ausführbaren Aktionsschaltflächen. Feldhilfe "
+            "bleibt neben der Feldbezeichnung. "
+            "Neu laden und Aufgabe anlegen stehen oben rechts in der dauerhaft sichtbaren, arbeitsbereichsweiten Leiste; Neu laden steht unmittelbar vor dem Anlegen. Auswahl, Filterwechsel und Bearbeitung verschieben diese sammlungsweiten Aktionen nicht in den linken Bereich. Suche und Statusfilter bleiben in der Aufgabenliste; Abschluss, Zuständigkeit und weitere aufgabenspezifische Aktionen bleiben bei der ausgewählten Aufgabe. Bestehende Berechtigungen, Deaktivierungsregeln und der Schutz ungespeicherter Änderungen gelten weiterhin. Administratoren konfigurieren Rechte im bestehenden Berechtigungssystem; es entstehen weder neue Rechte noch automatische Vorgänge.",
+        }},
+    ),
     DocumentationTopic(
         id="tasks.data-subject-requests",
         title="Task data-subject requests",

tests/test_webui_contract.py

@@ -16,7 +16,12 @@ class TasksQuickAccessContractTests(unittest.TestCase):
         topics = get_manifest().documentation
         kinds = {topic.metadata.get("kind", "system") for topic in topics}
 
-        self.assertEqual(3, len(topics))
+        self.assertEqual({
+            "tasks.workspace-layout",
+            "tasks.data-subject-requests",
+            "tasks.quick-access-and-product-area",
+            "tasks.work-inbox",
+        }, {topic.id for topic in topics})
         self.assertTrue({"workflow", "reference"}.issubset(kinds))
         for topic in topics:
             translation = topic.translations["de"]

webui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@govoplan/tasks-webui",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "private": true,
   "type": "module",
   "main": "src/index.ts",
@@ -14,7 +14,7 @@
     "./styles/tasks.css": "./src/styles/tasks.css"
   },
   "peerDependencies": {
-    "@govoplan/core-webui": "^0.1.44",
+    "@govoplan/core-webui": "^0.1.45",
     "lucide-react": "^1.23.0",
     "react": ">=19.2.7 <20",
     "react-dom": ">=19.2.7 <20",

webui/src/features/tasks/TasksPage.tsx

@@ -124,6 +124,23 @@ export default function TasksPage({ settings, auth }: { settings: ApiSettings; a
 
   return (
     <WorkspaceFrame as="main" height="viewport" surface="plain" className="tasks-page" label="Task inbox" data-help-context-id="tasks.page.inbox">
+      <WorkspaceActionBar
+        scope="workspace"
+        variant="collection"
+        refreshable
+        reloadAction={{ onReload: () => void load(), loading: loading || busy, label: "i18n:govoplan-tasks.refresh" }}
+        contextActions={<span className="tasks-title"><ListChecks size={18} /><strong>i18n:govoplan-tasks.work</strong></span>}
+        createAction={canWrite ? (
+          <Button
+            variant="primary"
+            onClick={() => setCreateOpen(true)}
+            disabled={busy}
+            helpContextId="tasks.action.create"
+          >
+            <Plus size={16} aria-hidden="true" /> i18n:govoplan-tasks.create_task
+          </Button>
+        ) : undefined}
+      />
       <WorkspaceLayout
         variant="split"
         primarySize="default"
@@ -138,24 +155,6 @@ export default function TasksPage({ settings, auth }: { settings: ApiSettings; a
         helpContextId="tasks.page.inbox"
         helpModuleId="tasks"
         primary={<>
-          <WorkspaceActionBar
-            scope="collection-pane"
-            variant="collection"
-            refreshable
-            reloadAction={{ onReload: () => void load(), loading: loading || busy, label: "i18n:govoplan-tasks.refresh" }}
-            className="tasks-sidebar-bar"
-            contextActions={<span className="tasks-title"><ListChecks size={18} /><strong>i18n:govoplan-tasks.work</strong></span>}
-            createAction={canWrite ? (
-              <Button
-                variant="primary"
-                onClick={() => setCreateOpen(true)}
-                disabled={busy}
-                helpContextId="tasks.action.create"
-              >
-                <Plus size={16} aria-hidden="true" /> i18n:govoplan-tasks.create_task
-              </Button>
-            ) : undefined}
-          />
           <FilterBar as="form" surface="control" wrap="never" className="tasks-search" onSubmit={submitSearch} role="search">
             <Search size={15} aria-hidden="true" />
             <input
@@ -204,8 +203,8 @@ export default function TasksPage({ settings, auth }: { settings: ApiSettings; a
             variant="detail"
             className="tasks-topbar"
             data-help-context-id="tasks.page.detail"
-            contextActions={<span className="tasks-detail-title"><ListChecks size={18} /><strong>{selected?.title ?? "i18n:govoplan-tasks.work_details"}</strong></span>}
+            title={<span className="tasks-detail-title"><ListChecks size={18} aria-hidden="true" /><strong>{selected?.title ?? "i18n:govoplan-tasks.work_details"}</strong></span>}
-            helpAction={<DocumentationHelpLink reference={DOCUMENTATION} />}
+            titleHelp={<DocumentationHelpLink reference={DOCUMENTATION} />}
             primaryActions={selected?.provider_id === "tasks.explicit" && canWrite ? (
               <TaskPrimaryActions item={selected} busy={busy} onAction={(action) => action === "defer" ? setDeferOpen(true) : void runAction(action)} />
             ) : undefined}