feat(B-HOOK): Lifecycle Hooks + Outbox Events — 55 neue Hooks, 10 Domain Events

B-HOOK-CORE: Company Hooks (6: before/after create/update/delete)
B-HOOK-MAIL: Mail Hooks (5: after_receive, before/after_delete, before/after_move)
B-HOOK-DMS: DMS Hooks (10: after_upload, before/after_update/delete/restore, folder CRUD)
B-HOOK-CAL: Calendar Hooks (4: before/after update/delete)
B-HOOK-TASK: Task Hooks (6: before/after create/update/delete)
B-HOOK-COMM: Communication Hooks (8: conversation create, message/edit/delete)
B-HOOK-AI: Agent Hooks (2: before/after_run)
B-HOOK-WF: Workflow Hooks (4: before/after_start, after_complete/cancel)
B-HOOK-TAG: Tag Hooks (8: create/assign/unassign/delete)
B-HOOK-SEARCH: Search Filters (2: before/after_search)

B-EVT-OUTBOX: 10 Domain Events (task.completed, file.created/deleted/restored, mail.received, workflow.started/completed/cancelled, agent.run_started/completed)

B-HOOK-TEST: 79 Tests in test_lifecycle_hooks.py — alle grün
B-HOOK-DOC: Plugin-Dev-Guide Kapitel 8 aktualisiert (Hook-Liste + Outbox Event-Liste)

app/plugins/builtins/mail/services.py

@@ -824,6 +824,14 @@ async def imap_sync_folder(
                 'from_address': from_addr,
             })
 
+            # Lifecycle hook: mail.after_receive
+            from app.core.hooks import do_action
+            await do_action("mail.after_receive", {'mail_id': str(mail.id), 'tenant_id': str(tenant_id), 'account_id': str(account.id), 'folder_id': str(folder.id), 'subject': subject, 'from_address': from_addr}, db=db, tenant_id=tenant_id)
+
+            # Outbox event: mail.received
+            from app.core.outbox import enqueue_outbox_event
+            await enqueue_outbox_event(db, tenant_id, 'mail.received', {'mail_id': str(mail.id), 'tenant_id': str(tenant_id), 'account_id': str(account.id), 'folder_id': str(folder.id), 'subject': subject, 'from_address': from_addr}, aggregate_type='mail', aggregate_id=mail.id)
+
             # Save attachments
             for att_data in attachments:
                 try:
@@ -2343,6 +2351,10 @@ async def imap_delete_mail(
         logger.warning("imap_delete_mail: mail %s has no imap_uid or message_id, cannot sync", mail_id)
         return
 
+    # Lifecycle hook: mail.before_delete
+    from app.core.hooks import do_action
+    await do_action("mail.before_delete", mail_id=str(mail.id), tenant_id=str(tenant_id), permanent=permanent, db=db)
+
     # Find Trash folder on IMAP server (only needed for non-permanent delete)
     trash_folder_name = None
     if not permanent:
@@ -2409,6 +2421,10 @@ async def imap_delete_mail(
         await client.expunge()
         logger.info("imap_delete_mail: moved mail %s (UID %s) to Trash via COPY+DELETE", mail_id, uid_str)
 
+        # Lifecycle hook: mail.after_delete
+        from app.core.hooks import do_action
+        await do_action("mail.after_delete", mail_id=str(mail.id), tenant_id=str(tenant_id), permanent=permanent, db=db)
+
     except Exception as exc:
         logger.warning("imap_delete_mail: failed for mail %s: %s", mail_id, exc)
         raise
@@ -2487,6 +2503,10 @@ async def imap_move_mail(
         logger.warning("imap_move_mail: mail %s has no imap_uid or message_id, cannot sync", mail_id)
         return
 
+    # Lifecycle hook: mail.before_move
+    from app.core.hooks import do_action
+    await do_action("mail.before_move", mail_id=str(mail.id), tenant_id=str(tenant_id), source_folder_id=str(source_folder.id), target_folder_id=str(target_folder.id), db=db)
+
     password = await get_account_password(account)
     client = None
 
@@ -2532,6 +2552,10 @@ async def imap_move_mail(
 
         logger.info("imap_move_mail: moved mail %s (UID %s) via COPY+DELETE", mail_id, uid_str)
 
+        # Lifecycle hook: mail.after_move
+        from app.core.hooks import do_action
+        await do_action("mail.after_move", mail_id=str(mail.id), tenant_id=str(tenant_id), source_folder_id=str(source_folder.id), target_folder_id=str(target_folder.id), db=db)
+
     except Exception as exc:
         logger.warning("imap_move_mail: failed for mail %s: %s", mail_id, exc)
         raise