Files
leocrm/app/plugins/builtins/ai_proactive/contracts.py
T
Agent Zero 98eb1d0d89
Check Cross-Plugin Imports / check (push) Has been cancelled
feat: Plugin-System Umbau — 6 Phasen komplett abgeschlossen
Phase 1: Contracts konsequent nutzen
- 12 neue contracts.py erstellt (alle 19 Plugins haben jetzt contracts)
- 4 bestehende contracts.py an zentrale ContractRegistry angepasst
- Alle 19 Plugins haben on_deactivate mit Contract-Unregister
- 0 echte problematische INTER-Plugin Imports

Phase 2: Hooks/Filters-System
- app/core/hooks.py (HookRegistry mit actions + filters)
- 15 Hook-Punkte in Core-Services (contact, auth, mail, calendar, user, dms)
- BasePlugin.on_deactivate meldet alle Hooks ab

Phase 3: Plugin-Isolation
- scripts/check_cross_plugin_imports.py (Linting-Regel)
- .github/workflows/check-cross-plugin-imports.yml (CI/CD)
- .pre-commit-cross-plugin.yaml (Pre-commit Hook)
- 155 Dateien geprueft, 0 Verstoesse

Phase 4: Plugin-Versioning
- app/plugins/semver.py (SemVer mit Parse, Compare, Pre-release)
- migration_runner.py erweitert: run_migration_down, rollback_to_version
- manifest.py: min_app_version Feld
- registry.py: App-Version-Compatibility-Check bei Installation
- GET /api/v1/plugins/updates Endpoint

Phase 5: Marketplace-Vorbereitung
- app/plugins/signature.py (Ed25519 Signatur-Validierung)
- app/plugins/quarantine.py (Plugin-Quarantine mit Validierung)
- app/models/plugin_allowlist.py + Migration 0046
- manifest.py: author, license, homepage, icon, screenshots, changelog, marketplace_tags, price
- registry.py: discover_external(), discover_all()
- POST /api/v1/plugins/install-marketplace (deaktiviert)

Phase 6: Manifest-Anpassung
- manifest.py: 12 neue Felder + SemVer/Hook-Name Validierung
- MANIFEST_SCHEMA_DOC aktualisiert
- Alle 19 Plugin-Manifeste aktualisiert
- Frontend PluginUiManifest Typ erweitert

Zusaetzliche Bug-Fixes:
- test_sample-Modul erstellt
- conftest.py Deadlock-Prevention
- SESSION_COOKIE_SECURE=true
- dump.rdb aus Git entfernt + .gitignore
- backup.py datetime.utcnow -> func.now()
- system_settings.py JSONB-Import nach oben
- tax.py Mapped[float] -> Mapped[Decimal]
- notification.py type_key-Laengen vereinheitlicht

Tests: 91 neue Tests, alle bestanden
2026-07-26 23:15:34 +02:00

81 lines
2.1 KiB
Python

"""Public contract for the ai_proactive plugin.
Exposes models, services, and job functions that other builtins plugins may need.
"""
from __future__ import annotations
from app.plugins.builtins.contracts import get_contract_registry
from app.plugins.builtins.ai_proactive.models import (
ContextLog,
ProactiveSettings,
ProactiveSuggestion,
)
from app.plugins.builtins.ai_proactive.services import (
get_active_suggestions,
get_sse_queue,
get_stats,
get_user_settings,
handle_context_change,
mark_dismissed,
push_suggestion,
)
from app.plugins.builtins.ai_proactive.context_tools import (
register_context_tools,
)
from app.plugins.builtins.ai_proactive.jobs import (
deep_analysis,
heartbeat,
)
class AiProactiveContract:
"""Public API surface for the ai_proactive plugin."""
contract_name = "ai_proactive"
# ─── models ───
ProactiveSuggestion = ProactiveSuggestion
ContextLog = ContextLog
ProactiveSettings = ProactiveSettings
# ─── services ───
handle_context_change = staticmethod(handle_context_change)
get_active_suggestions = staticmethod(get_active_suggestions)
get_sse_queue = staticmethod(get_sse_queue)
get_stats = staticmethod(get_stats)
get_user_settings = staticmethod(get_user_settings)
mark_dismissed = staticmethod(mark_dismissed)
push_suggestion = staticmethod(push_suggestion)
# ─── context_tools ───
register_context_tools = staticmethod(register_context_tools)
# ─── jobs ───
deep_analysis = staticmethod(deep_analysis)
heartbeat = staticmethod(heartbeat)
# ─── self-registration ───
_contract = AiProactiveContract()
get_contract_registry().register("ai_proactive", _contract)
__all__ = [
"AiProactiveContract",
"ProactiveSuggestion",
"ContextLog",
"ProactiveSettings",
"handle_context_change",
"get_active_suggestions",
"get_sse_queue",
"get_stats",
"get_user_settings",
"mark_dismissed",
"push_suggestion",
"register_context_tools",
"deep_analysis",
"heartbeat",
]