feat(B-TRIG): Trigger-Kern konsolidiert — generischer Dispatcher, UI-Event-Typ, 4 Trigger-Typen

B-TRIG-GEN: app/core/trigger_dispatcher.py (NEU) — generischer Event→Automation Dispatcher
- Wildcard EventBus Subscribe → matcht AutomationDefinition mit trigger_type=event
- Keine hardcodierte Event-Liste mehr — alle Outbox Events können Automations triggern
- Registriert in main.py lifespan + worker.py on_startup

B-TRIG-UI: UI-Event Trigger-Typ
- trigger_type Pattern um „ui" erweitert (event/schedule/manual/ui)
- UI-Events laufen ephemeral über EventBus → TriggerDispatcher → run_automation
- UI-Events NIEMALS in Outbox (is_ui_event() Guard)

B-TRIG-CRON: Cron/Heartbeat verifiziert — bestehender Pfad funktioniert
B-TRIG-MAN: Manual-Trigger verifiziert — bestehender Pfad funktioniert

B-TRIG-TEST: 10 Tests in test_trigger_core.py — alle grün
- Domain Event, UI Event (ephemeral), Cron, Manual, alle nutzen selben Execution-Kern
B-TRIG-DOC: Plugin-Dev-Guide Kapitel 10 mit Implementierungsdetails erweitert

app/core/trigger_dispatcher.py

@@ -0,0 +1,227 @@
+"""Trigger dispatcher — routes events to matching automation definitions.
+
+This module provides the **generic** bridge between the EventBus and the
+automation execution engine.  It replaces the previous hard-coded event
+handler stubs (``on_contact_created`` etc.) with a single wildcard
+subscriber that queries the database for matching
+``AutomationDefinition`` rows and dispatches them through the common
+``run_automation`` execution core.
+
+Two event categories are supported:
+
+1. **Domain events** (durable, via Outbox → Worker → EventBus)
+   - trigger_type = ``"event"``
+   - trigger_config = ``{"event_name": "contact.created"}``
+   - Any event published to the EventBus (either directly or via the
+     outbox processor) can trigger an automation.
+
+2. **UI events** (ephemeral, via WebSocket → EventBus only)
+   - trigger_type = ``"ui"``
+   - trigger_config = ``{"event_name": "ui.contact_selected"}``
+   - UI events are **never** written to the outbox.  They flow directly
+     from the frontend WebSocket handler through the EventBus to this
+     dispatcher.
+
+All four trigger types (event, ui, schedule, manual) converge on the
+same ``run_automation`` execution engine, ensuring consistent condition
+evaluation, action execution, and run logging.
+"""
+
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING, Any
+
+from sqlalchemy import select
+
+if TYPE_CHECKING:
+    from app.core.event_bus import EventBus
+
+logger = logging.getLogger(__name__)
+
+# Prefix that distinguishes ephemeral UI events from domain events.
+# UI events must NEVER be enqueued into the transactional outbox.
+_UI_EVENT_PREFIX = "ui."
+
+
+class TriggerDispatcher:
+    """Generic event-to-automation dispatcher.
+
+    Subscribes to the ``*`` wildcard on the EventBus so that **every**
+    event — domain or UI — is evaluated for matching automations.
+
+    The dispatcher is stateless after construction; it queries the
+    database on each event to find matching ``AutomationDefinition``
+    rows.  This is intentionally generic: no hard-coded event list is
+    maintained, and any registered outbox event can trigger an
+    automation.
+    """
+
+    def __init__(self, event_bus: EventBus) -> None:
+        self._event_bus = event_bus
+        self._handler: Any = None
+
+    def register(self) -> None:
+        """Subscribe the wildcard handler on the event bus."""
+        self._handler = self._on_event
+        self._event_bus.subscribe("*", self._handler)
+        logger.info("TriggerDispatcher registered — listening to all events")
+
+    def unregister(self) -> None:
+        """Unsubscribe from the event bus (idempotent)."""
+        if self._handler is not None:
+            self._event_bus.unsubscribe("*", self._handler)
+            self._handler = None
+
+    async def _on_event(self, payload: dict[str, Any]) -> None:
+        """Wildcard handler invoked for every EventBus event.
+
+        Determines the event name from the payload envelope, classifies
+        it as domain or UI, queries matching automation definitions, and
+        dispatches each through ``run_automation``.
+        """
+        event_name: str = payload.get("event_name", "")
+        if not event_name:
+            logger.debug("TriggerDispatcher: event without event_name, skipping")
+            return
+
+        is_ui_event = event_name.startswith(_UI_EVENT_PREFIX)
+        trigger_type = "ui" if is_ui_event else "event"
+
+        logger.debug(
+            "TriggerDispatcher: evaluating event '%s' (trigger_type=%s)",
+            event_name,
+            trigger_type,
+        )
+
+        try:
+            await self._dispatch_matching_automations(
+                event_name=event_name,
+                trigger_type=trigger_type,
+                payload=payload,
+            )
+        except Exception:
+            logger.exception(
+                "TriggerDispatcher: error dispatching event '%s'", event_name
+            )
+
+    async def _dispatch_matching_automations(
+        self,
+        event_name: str,
+        trigger_type: str,
+        payload: dict[str, Any],
+    ) -> None:
+        """Query DB for active automations matching *event_name* and dispatch."""
+        from app.core.db import get_session_factory
+        from app.plugins.builtins.automation.models import AutomationDefinition
+
+        factory = get_session_factory()
+        tenant_id = payload.get("tenant_id")
+
+        async with factory() as db:
+            query = (
+                select(AutomationDefinition)
+                .where(AutomationDefinition.is_active.is_(True))
+                .where(AutomationDefinition.trigger_type == trigger_type)
+            )
+            if tenant_id is not None:
+                query = query.where(
+                    AutomationDefinition.tenant_id == tenant_id
+                )
+
+            result = await db.execute(query)
+            automations = list(result.scalars().all())
+
+        if not automations:
+            logger.debug(
+                "TriggerDispatcher: no active automations for event '%s' (type=%s)",
+                event_name,
+                trigger_type,
+            )
+            return
+
+        for automation in automations:
+            config = automation.trigger_config or {}
+            configured_event = config.get("event_name", "")
+            if configured_event != event_name:
+                continue
+
+            logger.info(
+                "TriggerDispatcher: dispatching automation '%s' (%s) for event '%s'",
+                automation.name,
+                automation.id,
+                event_name,
+            )
+
+            await self._enqueue_automation(
+                automation_id=str(automation.id),
+                trigger_type=trigger_type,
+                trigger_data=payload,
+            )
+
+    async def _enqueue_automation(
+        self,
+        automation_id: str,
+        trigger_type: str,
+        trigger_data: dict[str, Any],
+    ) -> None:
+        """Dispatch automation through the common execution core.
+
+        Uses ``run_automation`` directly (in-process) for low latency.
+        For production workloads with back-pressure, the caller may
+        alternatively enqueue via ``enqueue_job``.
+        """
+        from app.plugins.builtins.automation.execution_engine import run_automation
+
+        try:
+            await run_automation(
+                ctx={},
+                automation_id=automation_id,
+                trigger_type=trigger_type,
+                trigger_data=trigger_data,
+            )
+        except Exception:
+            logger.exception(
+                "TriggerDispatcher: run_automation failed for automation_id=%s",
+                automation_id,
+            )
+
+
+# ── Module-level helpers ─────────────────────────────────────────────────────
+
+_dispatcher: TriggerDispatcher | None = None
+
+
+def get_trigger_dispatcher() -> TriggerDispatcher | None:
+    """Return the singleton dispatcher, or ``None`` if not registered."""
+    return _dispatcher
+
+
+def register_trigger_dispatcher(event_bus: EventBus) -> TriggerDispatcher:
+    """Create and register the trigger dispatcher on *event_bus*.
+
+    Safe to call multiple times — subsequent calls are no-ops.
+    """
+    global _dispatcher
+    if _dispatcher is not None:
+        logger.debug("TriggerDispatcher already registered")
+        return _dispatcher
+    _dispatcher = TriggerDispatcher(event_bus)
+    _dispatcher.register()
+    return _dispatcher
+
+
+def unregister_trigger_dispatcher() -> None:
+    """Unregister and discard the singleton dispatcher."""
+    global _dispatcher
+    if _dispatcher is not None:
+        _dispatcher.unregister()
+        _dispatcher = None
+
+
+def is_ui_event(event_name: str) -> bool:
+    """Return ``True`` if *event_name* is an ephemeral UI event.
+
+    UI events must never be written to the transactional outbox.
+    """
+    return event_name.startswith(_UI_EVENT_PREFIX)

app/core/worker.py

@@ -159,6 +159,11 @@ async def on_startup(ctx: dict[str, Any]) -> None:
     register_webhook_event_handlers(event_bus)
     logger.info("Worker: webhook event handlers registered")
 
+    # Register trigger dispatcher — generic event→automation bridge
+    from app.core.trigger_dispatcher import register_trigger_dispatcher
+    register_trigger_dispatcher(event_bus)
+    logger.info("Worker: trigger dispatcher registered")
+
     # Register search providers (normally done by app startup)
     try:
         from app.plugins.builtins.unified_search.provider_registry import auto_register_providers

app/main.py

@@ -275,6 +275,11 @@ async def lifespan(app: FastAPI):
     register_webhook_event_handlers(event_bus)
     logger.info("Webhook event handlers registered")
 
+    # Register trigger dispatcher — generic event→automation bridge
+    from app.core.trigger_dispatcher import register_trigger_dispatcher
+    register_trigger_dispatcher(event_bus)
+    logger.info("Trigger dispatcher registered")
+
     # Register field definitions from active plugins only
     from app.core.permission_registry import get_permission_registry
     for name in active_plugin_names:

app/plugins/builtins/automation/schemas.py

@@ -71,7 +71,7 @@ class AutomationDefinitionCreate(BaseModel):
 
     name: str = Field(..., min_length=1, max_length=120)
     description: str = Field(default="", max_length=500)
-    trigger_type: str = Field(default="manual", pattern="^(event|schedule|manual)$")
+    trigger_type: str = Field(default="manual", pattern="^(event|schedule|manual|ui)$")
     trigger_config: dict[str, Any] = Field(default_factory=dict)
     conditions: list[dict[str, Any]] = Field(default_factory=list)
     actions: list[dict[str, Any]] = Field(default_factory=list)
@@ -84,7 +84,7 @@ class AutomationDefinitionUpdate(BaseModel):
 
     name: str | None = Field(None, max_length=120)
     description: str | None = Field(None, max_length=500)
-    trigger_type: str | None = Field(None, pattern="^(event|schedule|manual)$")
+    trigger_type: str | None = Field(None, pattern="^(event|schedule|manual|ui)$")
     trigger_config: dict[str, Any] | None = None
     conditions: list[dict[str, Any]] | None = None
     actions: list[dict[str, Any]] | None = None