fix(e7): CI-Gate-Vorbereitung — ruff über app/ von 105 auf 0 Findings bereinigt; 8 echte F821-NameError-Produktionsbugs behoben (external_api stream_chat-Call-Signatur an stream_chat_comm angepasst, agent_runner uuid vor lokalem Import, automation/plugin UserTenant-Import, tasks delete-audit user_id, workflows/engine timedelta, unified_search/contracts Any); py311-kompatibles StepHandler-Alias statt type-Statement; E402/F841 bereinigt; Verifikation 85/89 grün (4 Failures = bekannter Vorbestand BUG-099)

app/plugins/builtins/automation/agent_comm.py

@@ -55,7 +55,8 @@ async def send_agent_message(
 
     # 2. Create a kommunikation message in a dedicated agent room
     try:
-        from app.plugins.builtins.kommunikation.contracts import CommConversation as Room, CommMessage as Message
+        from app.plugins.builtins.kommunikation.contracts import CommConversation as Room
+        from app.plugins.builtins.kommunikation.contracts import CommMessage as Message
 
         # Find or create the agent-to-agent room
         room_name = f"agent:{from_agent_id}:{target_agent.id}"

app/plugins/builtins/automation/agent_routes.py

@@ -619,6 +619,7 @@ async def stream_agent_run(
     in real-time as the agent processes.
     """
     from fastapi.responses import StreamingResponse
+
     from app.ai.agent_stream import stream_react_loop
     from app.plugins.builtins.ai_assistant.contracts import get_tool_registry
 

app/plugins/builtins/automation/agent_runner.py

@@ -11,6 +11,7 @@ Safety features:
 from __future__ import annotations
 
 import logging
+import uuid
 from datetime import UTC, datetime
 from typing import Any
 
@@ -37,12 +38,12 @@ async def run_agent(
     3. Infinite loop: same tool 5x consecutively (handled in ReAct loop)
     4. Budget limit: cumulative cost_usd
     """
+    from app.plugins.builtins.ai_assistant.contracts import get_tool_registry
     from app.plugins.builtins.automation.models import (
         AgentDefinition,
         AgentRun,
         AgentRunStep,
     )
-    from app.plugins.builtins.ai_assistant.contracts import get_tool_registry
 
     factory = get_session_factory()
 
@@ -167,7 +168,7 @@ async def run_agent(
         perm_ctx = await resolve_agent_permissions(
             db=db,
             tenant_id=agent.tenant_id,
-            user_id=agent.created_by or uuid_mod.uuid4(),
+            user_id=agent.created_by or uuid.uuid4(),
             agent_definition=agent,
         )
 

app/plugins/builtins/automation/plugin.py

@@ -248,17 +248,23 @@ class AutomationPlugin(BasePlugin):
             logger.exception("Failed to register own cron jobs")
         # Register pre-built agents in DB (if not already present)
         try:
-            from app.plugins.builtins.automation.models import AgentDefinition
-            from app.plugins.builtins.automation.prebuilt.email_triage_agent import create_email_triage_agent
-            from app.plugins.builtins.automation.prebuilt.contact_enrichment_agent import create_contact_enrichment_agent
-            from app.plugins.builtins.automation.prebuilt.follow_up_agent import create_follow_up_agent
-            from app.plugins.builtins.automation.prebuilt.report_agent import create_report_agent
             from sqlalchemy import select as sa_select
 
             # Get system tenant + admin user for seeding (ARCH-043:
             # deterministic slug lookup instead of arbitrary first row)
             from app.core.db import get_system_tenant
-            from app.models.user import User
+            from app.models.user import User, UserTenant
+            from app.plugins.builtins.automation.models import AgentDefinition
+            from app.plugins.builtins.automation.prebuilt.contact_enrichment_agent import (
+                create_contact_enrichment_agent,
+            )
+            from app.plugins.builtins.automation.prebuilt.email_triage_agent import (
+                create_email_triage_agent,
+            )
+            from app.plugins.builtins.automation.prebuilt.follow_up_agent import (
+                create_follow_up_agent,
+            )
+            from app.plugins.builtins.automation.prebuilt.report_agent import create_report_agent
 
             tenant = await get_system_tenant(db)
             if tenant:
@@ -298,15 +304,14 @@ class AutomationPlugin(BasePlugin):
     def _register_workflow_agent_tools(self) -> None:
         """Register I-AW agent tools for starting and inspecting workflows."""
         import uuid
-        from typing import Any
 
         from app.ai.tool_registry import get_tool_registry
         registry = get_tool_registry()
 
         async def _start_workflow_handler(arguments: dict[str, Any], context: dict[str, Any]) -> dict[str, Any]:
             """Start a workflow by ID."""
-            from app.services.workflow_service import create_instance
             from app.core.db import get_worker_session_factory
+            from app.services.workflow_service import create_instance
             workflow_id = arguments.get("workflow_id", "")
             tenant_id = context.get("tenant_id")
             user_id = context.get("user_id")
@@ -342,8 +347,9 @@ class AutomationPlugin(BasePlugin):
         async def _check_workflow_status_handler(arguments: dict[str, Any], context: dict[str, Any]) -> dict[str, Any]:
             """Check the status of a workflow instance."""
             from sqlalchemy import select
-            from app.models.workflow import WorkflowInstance
+
             from app.core.db import get_worker_session_factory
+            from app.models.workflow import WorkflowInstance
             instance_id = arguments.get("instance_id", "")
             tenant_id = context.get("tenant_id")
             if not instance_id or not tenant_id:

app/plugins/builtins/automation/prebuilt/contact_enrichment_agent.py

@@ -3,7 +3,9 @@
 Enriches contact data by searching for related information.
 """
 from __future__ import annotations
+
 import uuid
+
 from app.plugins.builtins.automation.models import AgentDefinition
 
 CONTACT_ENRICHMENT_SYSTEM_PROMPT = """You are a Contact Enrichment Agent for a CRM system.

app/plugins/builtins/automation/prebuilt/email_triage_agent.py

@@ -3,7 +3,9 @@
 Sorts and prioritizes incoming emails automatically.
 """
 from __future__ import annotations
+
 import uuid
+
 from app.plugins.builtins.automation.models import AgentDefinition
 
 EMAIL_TRIAGE_SYSTEM_PROMPT = """You are an E-Mail Triage Agent for a CRM system.

app/plugins/builtins/automation/prebuilt/follow_up_agent.py

@@ -3,7 +3,9 @@
 Reminds about and creates follow-up tasks for contacts.
 """
 from __future__ import annotations
+
 import uuid
+
 from app.plugins.builtins.automation.models import AgentDefinition
 
 FOLLOW_UP_SYSTEM_PROMPT = """You are a Follow-up Agent for a CRM system.

app/plugins/builtins/automation/prebuilt/report_agent.py

@@ -3,7 +3,9 @@
 Generates reports from CRM data using search and API tools.
 """
 from __future__ import annotations
+
 import uuid
+
 from app.plugins.builtins.automation.models import AgentDefinition
 
 REPORT_SYSTEM_PROMPT = """You are a Report Agent for a CRM system.

app/plugins/builtins/automation/tests/test_automation.py

@@ -7,7 +7,12 @@ PGUUID/JSONB column types.
 
 from __future__ import annotations
 
+# Register ALL plugin models so create_all can resolve cross-plugin FKs
+# (e.g. entity_attachments.dms_file_id -> files) — same pattern as
+# scripts/sync_plugin_schema.py.
+import importlib
 import os
+import pkgutil
 import uuid
 from collections.abc import AsyncGenerator
 from datetime import UTC, datetime, timedelta
@@ -17,17 +22,10 @@ import pytest_asyncio
 from sqlalchemy import text
 from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker, create_async_engine
 
-from app.core.db import Base
 import app.models  # noqa: F401  — registers core models
 import app.models.outbox  # noqa: F401  — event_outbox is NOT re-exported by app.models
-
-# Register ALL plugin models so create_all can resolve cross-plugin FKs
-# (e.g. entity_attachments.dms_file_id -> files) — same pattern as
-# scripts/sync_plugin_schema.py.
-import importlib
-import pkgutil
-
 import app.plugins.builtins as _builtins_pkg
+from app.core.db import Base
 
 for _importer, _modname, _ispkg in pkgutil.iter_modules(_builtins_pkg.__path__):
     if not _ispkg:
@@ -39,11 +37,11 @@ for _importer, _modname, _ispkg in pkgutil.iter_modules(_builtins_pkg.__path__):
     except Exception:  # pragma: no cover - defensive
         pass
 
-from app.plugins.builtins.automation.models import (
+from app.plugins.builtins.automation.models import (  # noqa: E402 — after dynamic plugin-model discovery
     AgentRun,
     AutomationRun,
 )
-from app.plugins.builtins.automation.services import (
+from app.plugins.builtins.automation.services import (  # noqa: E402 — after dynamic plugin-model discovery
     AgentService,
     AutomationService,
     CronJobService,