admina-framework 0.9.0__tar.gz → 0.9.2__tar.gz

{admina_framework-0.9.0/admina_framework.egg-info → admina_framework-0.9.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: admina-framework
-Version: 0.9.0
+Version: 0.9.2
 Summary: Admina — governed AI development framework
 Author-email: Stefano Noferi <info@admina.org>
 Maintainer-email: Stefano Noferi <info@admina.org>
@@ -43,10 +43,10 @@ Requires-Dist: boto3<2,>=1.34; extra == "proxy"
 Requires-Dist: minio<8,>=7.2; extra == "proxy"
 Requires-Dist: clickhouse-connect<1,>=0.7; extra == "proxy"
 Requires-Dist: typer<1,>=0.9; extra == "proxy"
+Requires-Dist: numpy<2,>=1.24; extra == "proxy"
+Requires-Dist: scikit-learn<2,>=1.3; extra == "proxy"
 Provides-Extra: nlp
 Requires-Dist: spacy<4,>=3.8; extra == "nlp"
-Requires-Dist: scikit-learn<2,>=1.3; extra == "nlp"
-Requires-Dist: numpy<2,>=1.24; extra == "nlp"
 Provides-Extra: telemetry
 Requires-Dist: opentelemetry-api<2,>=1.20; extra == "telemetry"
 Requires-Dist: opentelemetry-sdk<2,>=1.20; extra == "telemetry"

{admina_framework-0.9.0 → admina_framework-0.9.2}/admina/__init__.py

@@ -23,7 +23,7 @@ from __future__ import annotations
 
 from admina.sdk import ComplianceKit, GovernedAgent, GovernedData, GovernedModel
 
-__version__ = "0.9.0"
+__version__ = "0.9.2"
 
 __all__ = [
     "__version__",

{admina_framework-0.9.0 → admina_framework-0.9.2}/admina/dashboard/static/index.html

@@ -932,36 +932,43 @@ function dashboard() {
 
     // ── Fetch all data ─────────────────────────────────
     async refresh() {
-      try {
-        const [scoreRes, compRes, sovRes, statsRes, feedRes, infraRes, modelsRes, oisgRes] = await Promise.all([
-          fetch('/api/dashboard/score').then(r => r.json()),
-          fetch('/api/dashboard/compliance').then(r => r.json()),
-          fetch('/api/dashboard/sovereignty').then(r => r.json()),
-          fetch('/api/stats').then(r => r.json()),
-          fetch('/api/dashboard/feed?limit=50').then(r => r.json()),
-          fetch('/api/dashboard/infra').then(r => r.json()),
-          fetch('/api/dashboard/models').then(r => r.json()),
-          fetch('/api/dashboard/oisg').then(r => r.json()).catch(() => ({})),
-        ]);
-
-        this.score = scoreRes;
-        this.complianceData = compRes;
-        this.sovereignty = sovRes;
-        this.stats = statsRes;
-        this.infraData = infraRes;
-        this.modelData = modelsRes;
-        this.oisg = oisgRes;
-        this.healthy = true;
-        this.lastUpdate = new Date().toLocaleTimeString();
-
-        // Seed the feed with historical events if WS hasn't provided any yet
-        if (this.feedEvents.length === 0 && feedRes.events && feedRes.events.length > 0) {
-          this.feedEvents = feedRes.events.slice(0, 50).map(e => this._formatFeedEvent(e));
-        }
-      } catch (err) {
-        console.error('Dashboard refresh failed:', err);
-        this.healthy = false;
-        this.lastUpdate = 'error';
+      // allSettled so one failing endpoint never blanks the whole dashboard.
+      const okJson = async (url) => {
+        const r = await fetch(url);
+        if (!r.ok) throw new Error(`${url} -> ${r.status}`);
+        return r.json();
+      };
+      const results = await Promise.allSettled([
+        okJson('/api/dashboard/score'),
+        okJson('/api/dashboard/compliance'),
+        okJson('/api/dashboard/sovereignty'),
+        okJson('/api/stats'),
+        okJson('/api/dashboard/feed?limit=50'),
+        okJson('/api/dashboard/infra'),
+        okJson('/api/dashboard/models'),
+        okJson('/api/dashboard/oisg'),
+      ]);
+      const [scoreRes, compRes, sovRes, statsRes, feedRes, infraRes, modelsRes, oisgRes] =
+        results.map(r => r.status === 'fulfilled' ? r.value : null);
+
+      if (scoreRes) this.score = scoreRes;
+      if (compRes) this.complianceData = compRes;
+      if (sovRes) this.sovereignty = sovRes;
+      if (statsRes) this.stats = statsRes;
+      if (infraRes) this.infraData = infraRes;
+      if (modelsRes) this.modelData = modelsRes;
+      if (oisgRes) this.oisg = oisgRes;
+
+      const failed = results.filter(r => r.status === 'rejected');
+      if (failed.length) {
+        failed.forEach(r => console.warn('[Admina] endpoint failed:', r.reason));
+      }
+      this.healthy = failed.length === 0;
+      this.lastUpdate = new Date().toLocaleTimeString();
+
+      // Seed the feed with historical events if WS hasn't provided any yet
+      if (this.feedEvents.length === 0 && feedRes?.events?.length > 0) {
+        this.feedEvents = feedRes.events.slice(0, 50).map(e => this._formatFeedEvent(e));
       }
     },
 

{admina_framework-0.9.0 → admina_framework-0.9.2}/admina/domains/data_sovereignty/pii.py

@@ -21,7 +21,12 @@ import logging
 import os
 import re
 
-import spacy
+# spaCy is part of the [nlp] extra. When absent, PIIRedactor falls back
+# to regex-only mode (still covers EMAIL/PHONE/SSN/IBAN/IP/credit-card/EU IDs).
+try:
+    import spacy as _spacy
+except ImportError:
+    _spacy = None  # type: ignore[assignment]
 
 logger = logging.getLogger("admina.pii_redactor")
 
@@ -152,12 +157,24 @@ class PIIRedactor:
     def __init__(self, config=None):
         # Resolve NLP model: config.ner_model > ADMINA_SPACY_MODEL env var > default
         model_name = getattr(config, "ner_model", None) or SPACY_MODEL
-        try:
-            self.nlp = spacy.load(model_name)
-            logger.info("[OK] spaCy model loaded: %s", model_name)
-        except OSError:
-            logger.warning("[WARN] spaCy model '%s' not found, using regex-only mode", model_name)
+        if _spacy is None:
+            logger.info(
+                "spaCy not installed — PII redaction running in regex-only mode "
+                "(install admina-framework[nlp] for NER-based detection)"
+            )
             self.nlp = None
+        else:
+            try:
+                self.nlp = _spacy.load(model_name)
+                logger.info("[OK] spaCy model loaded: %s", model_name)
+            except OSError:
+                logger.warning(
+                    "spaCy model '%s' not found — using regex-only mode "
+                    "(run: python -m spacy download %s)",
+                    model_name,
+                    model_name,
+                )
+                self.nlp = None
 
         # Build active categories: start from PII_CATEGORIES defaults, then
         # disable any category not listed in config.categories (if provided).

{admina_framework-0.9.0 → admina_framework-0.9.2}/admina/plugins/registry.py

@@ -284,6 +284,13 @@ class PluginRegistry:
             mod = importlib.util.module_from_spec(spec)
             sys.modules[mod_name] = mod
             spec.loader.exec_module(mod)
+        except ModuleNotFoundError as exc:
+            logger.warning(
+                "Skipping plugin %s — optional dependency %r not installed",
+                py_file.stem,
+                exc.name or "?",
+            )
+            return 0
         except (ImportError, AttributeError, RuntimeError):
             logger.warning("Failed to import plugin file %s", py_file, exc_info=True)
             return 0
@@ -294,6 +301,13 @@ class PluginRegistry:
         """Import a module by dotted path and register all plugin classes."""
         try:
             mod = importlib.import_module(mod_path)
+        except ModuleNotFoundError as exc:
+            logger.warning(
+                "Skipping plugin module %r — optional dependency %r not installed",
+                mod_path,
+                exc.name or "?",
+            )
+            return 0
         except ImportError:
             logger.warning("Failed to import plugin module %r", mod_path, exc_info=True)
             return 0

{admina_framework-0.9.0 → admina_framework-0.9.2}/admina/proxy/api/dashboard.py

@@ -450,9 +450,13 @@ def create_dashboard_endpoints(
 
         # Upstream MCP
         http = get_http_client() if get_http_client else None
-        if http is not None:
-            upstream = get_settings().UPSTREAM_MCP_URL
+        upstream = get_settings().UPSTREAM_MCP_URL if get_settings else ""
+        if http is None or not upstream.startswith(("http://", "https://")):
+            services["upstream_mcp"] = {"status": "not_configured"}
+        else:
             try:
+                import httpx
+
                 t0 = time.perf_counter()
                 resp = await http.get(f"{upstream}/health", timeout=3.0)
                 latency = round((time.perf_counter() - t0) * 1000, 2)
@@ -461,13 +465,11 @@ def create_dashboard_endpoints(
                     "latency_ms": latency,
                     "url": upstream,
                 }
-            except (OSError, RuntimeError):
+            except (OSError, RuntimeError, httpx.HTTPError):
                 services["upstream_mcp"] = {
                     "status": "unreachable",
                     "url": upstream,
                 }
-        else:
-            services["upstream_mcp"] = {"status": "not_configured"}
 
         healthy_count = sum(1 for s in services.values() if s.get("status") == "healthy")
         return {

{admina_framework-0.9.0 → admina_framework-0.9.2/admina_framework.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: admina-framework
-Version: 0.9.0
+Version: 0.9.2
 Summary: Admina — governed AI development framework
 Author-email: Stefano Noferi <info@admina.org>
 Maintainer-email: Stefano Noferi <info@admina.org>
@@ -43,10 +43,10 @@ Requires-Dist: boto3<2,>=1.34; extra == "proxy"
 Requires-Dist: minio<8,>=7.2; extra == "proxy"
 Requires-Dist: clickhouse-connect<1,>=0.7; extra == "proxy"
 Requires-Dist: typer<1,>=0.9; extra == "proxy"
+Requires-Dist: numpy<2,>=1.24; extra == "proxy"
+Requires-Dist: scikit-learn<2,>=1.3; extra == "proxy"
 Provides-Extra: nlp
 Requires-Dist: spacy<4,>=3.8; extra == "nlp"
-Requires-Dist: scikit-learn<2,>=1.3; extra == "nlp"
-Requires-Dist: numpy<2,>=1.24; extra == "nlp"
 Provides-Extra: telemetry
 Requires-Dist: opentelemetry-api<2,>=1.20; extra == "telemetry"
 Requires-Dist: opentelemetry-sdk<2,>=1.20; extra == "telemetry"

{admina_framework-0.9.0 → admina_framework-0.9.2}/pyproject.toml

@@ -19,7 +19,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "admina-framework"
-version = "0.9.0"
+version = "0.9.2"
 description = "Admina — governed AI development framework"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -80,6 +80,9 @@ proxy = [
     "minio>=7.2,<8",
     "clickhouse-connect>=0.7,<1",
     "typer>=0.9,<1",
+    # Required by the LoopBreaker (core proxy guardrail — not an NLP add-on).
+    "numpy>=1.24,<2",
+    "scikit-learn>=1.3,<2",
 ]
 nlp = [
     # spacy 3.7.x ships an old blis (0.7.11) that fails to build on Python 3.13
@@ -92,8 +95,6 @@ nlp = [
     # `admina-framework[nlp]`, run:
     #   python -m spacy download en_core_web_sm
     # The PIIRedactor logs a clear error if the model is missing.
-    "scikit-learn>=1.3,<2",
-    "numpy>=1.24,<2",
 ]
 telemetry = [
     "opentelemetry-api>=1.20,<2",

{admina_framework-0.9.0 → admina_framework-0.9.2}/tests/test_domains.py

@@ -295,6 +295,23 @@ class TestEngineBridge:
         assert hasattr(pii, "redact")
         assert hasattr(pii, "get_stats")
 
+    def test_pii_factory_without_spacy_installed(self, monkeypatch):
+        """Regression: admina dev must boot even when spaCy is not installed.
+
+        Simulates a user who ran `pip install admina-framework[proxy]` without
+        the [nlp] extra. The PII bridge must fall back to regex-only mode
+        instead of crashing the proxy lifespan with ModuleNotFoundError.
+        """
+        from admina.domains.data_sovereignty import pii as pii_mod
+
+        monkeypatch.setattr(pii_mod, "_spacy", None)
+
+        redactor = pii_mod.PIIRedactor()
+        assert redactor.nlp is None
+        r = redactor.redact("Contact john@example.com")
+        assert "john@example.com" not in r["redacted_text"]
+        assert r["count"] >= 1
+
     def test_loop_breaker_factory(self):
         from admina.proxy.engine_bridge import get_loop_breaker
 

{admina_framework-0.9.0 → admina_framework-0.9.2}/admina_framework.egg-info/requires.txt

@@ -8,8 +8,6 @@ admina-framework[nlp,proxy,telemetry]
 
 [nlp]
 spacy<4,>=3.8
-scikit-learn<2,>=1.3
-numpy<2,>=1.24
 
 [proxy]
 fastapi<1,>=0.104
@@ -23,6 +21,8 @@ boto3<2,>=1.34
 minio<8,>=7.2
 clickhouse-connect<1,>=0.7
 typer<1,>=0.9
+numpy<2,>=1.24
+scikit-learn<2,>=1.3
 
 [telemetry]
 opentelemetry-api<2,>=1.20