agentic-ops 0.1.0__tar.gz → 0.1.2__tar.gz

{agentic_ops-0.1.0 → agentic_ops-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agentic-ops
-Version: 0.1.0
+Version: 0.1.2
 Summary: A generic, plug-and-play Agentic Control Plane for MLOps Governance
 License: MIT
 License-File: LICENSE
@@ -12,6 +12,7 @@ Requires-Dist: hypothesis>=6.0.0
 Requires-Dist: instructor>=1.0.0
 Requires-Dist: kubernetes>=29.0.0
 Requires-Dist: litellm>=1.0.0
+Requires-Dist: mcp>=2.3.0
 Requires-Dist: prefect>=2.0.0
 Requires-Dist: prometheus-client>=0.20.0
 Requires-Dist: pydantic>=2.0.0
@@ -29,6 +30,8 @@ Description-Content-Type: text/markdown
 
 # Agentic-Ops Control Plane
 
+[![PyPI - Version](https://img.shields.io/pypi/v/agentic-ops?color=blue&logo=pypi&logoColor=white)](https://pypi.org/project/agentic-ops/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/agentic-ops)](https://pypi.org/project/agentic-ops/)
 [![M8ven Trust](https://m8ven.ai/badge/mcp/nolll77-agentic-ops-1ogfsr?v=ccffd1d26d212de101328dba6fea5547)](https://m8ven.ai/mcp/nolll77-agentic-ops-1ogfsr?s=readme)
 ![Status](https://img.shields.io/badge/Status-Production%20Hardened-success)
 ![Security](https://img.shields.io/badge/Security-Red%20Teamed-critical)
@@ -60,6 +63,7 @@ To demonstrate this platform-agnostic design in real production conditions, `Age
 1. **Live Serverless Auto-Wake Production Instance (`Render` + `Tailscale` + `cron-job.org`)**:
    - **Live Control Plane Status**: **[`https://agentic-ops-5ebv.onrender.com/`](https://agentic-ops-5ebv.onrender.com/)**
    - **Live Interactive SRE Web Console (`/console`)**: **[`https://agentic-ops-5ebv.onrender.com/console`](https://agentic-ops-5ebv.onrender.com/console)**
+   - **Live Interactive Web Chat Copilot (`/chat`)**: **[`https://agentic-ops-5ebv.onrender.com/chat`](https://agentic-ops-5ebv.onrender.com/chat)**
    - **Live `MCP` (`Model Context Protocol`) Manifest (`/mcp/manifest`)**: **[`https://agentic-ops-5ebv.onrender.com/mcp/manifest`](https://agentic-ops-5ebv.onrender.com/mcp/manifest)** *(Full guide: **[`docs/MCP_SERVER_GUIDE.md`](docs/MCP_SERVER_GUIDE.md)**)*
    - **Live Tailscale Mesh Status (`100.85.198.81`)**: **[`https://agentic-ops-5ebv.onrender.com/api/tailscale/status`](https://agentic-ops-5ebv.onrender.com/api/tailscale/status)**
    - **Live Read-Only Pull Snapshot (`jakatt/cac_mlops`)**: **[`https://agentic-ops-5ebv.onrender.com/api/cac/snapshot`](https://agentic-ops-5ebv.onrender.com/api/cac/snapshot)**
@@ -402,6 +406,7 @@ To allow `Agentic-Ops` to run continuously on a free-tier PaaS (`Render`, `Huggi
 | :--- | :--- | :--- | :--- |
 | **Root Auto-Wake & Daemon Status** | **[`https://agentic-ops-5ebv.onrender.com/`](https://agentic-ops-5ebv.onrender.com/)** | `GET` | **Primary Auto-Wake URL**. Visiting this URL in a browser or calling it via `fetch()` from an external frontend (`Vercel`) wakes the container automatically if asleep and returns the live status of local `Redis` (`127.0.0.1:6379`) and `Tailscale SOCKS5` (`127.0.0.1:1055`). |
 | **Interactive SRE Web Terminal (`/console`)** | **[`https://agentic-ops-5ebv.onrender.com/console`](https://agentic-ops-5ebv.onrender.com/console)** | `GET` | **Zero-Cost SSH Shell Replacement**. Dark-mode browser terminal providing 1-click execution of `pytest` suites, `trust_ledger list`, `tailscale status` (with automatic PII redaction), `tailscale netcheck`, and `redis-cli PING`. |
+| **Interactive SRE Web Chat Copilot (`/chat`)** | **[`https://agentic-ops-5ebv.onrender.com/chat`](https://agentic-ops-5ebv.onrender.com/chat)** | `GET` | **Natural Language SRE Copilot**. Dark-mode conversational UI to query telemetry, models drift, WORM ledger security, and MAS topology via `POST /api/chat`. |
 | **Interactive `Swagger UI` API Console (`/docs`)** | **[`https://agentic-ops-5ebv.onrender.com/docs`](https://agentic-ops-5ebv.onrender.com/docs)** | `GET` | Interactive `OpenAPI` interface (`Try it out` -> `Execute`) for all endpoints and diagnostic commands. |
 | **Whitelisted Diagnostic Runner** | **[`https://agentic-ops-5ebv.onrender.com/api/diagnostics/pytest_cac_connector`](https://agentic-ops-5ebv.onrender.com/api/diagnostics/pytest_cac_connector)** | `GET` | Executes a whitelisted diagnostic command inside the container (`pytest_cac_connector`, `pytest_security`, `pytest_all`, `trust_ledger_list`, `tailscale_status`, `tailscale_netcheck`, `tailscale_logs`, `redis_ping`, `system_info`). |
 | **Keep-Alive Liveness Probe** | **[`https://agentic-ops-5ebv.onrender.com/healthz`](https://agentic-ops-5ebv.onrender.com/healthz)** | `GET` | Lightweight health check returning `{"status": "ok"}`. Polled every `10 minutes` by `cron-job.org` to prevent the `15-minute` free-tier inactivity spin-down. |
@@ -1437,7 +1442,25 @@ Applying the repository's **Radical Honesty** rule, `Agentic-Ops` intentionally
 
 ---
 
-## Installation & E2E Validation Tests
+## Installation & Quickstart
+
+### Option A: Install from PyPI (Recommended for Production & Clusters)
+
+```bash
+# Standard installation via pip
+pip install agentic-ops
+
+# Or using uv (ultra-fast dependency resolver)
+uv pip install agentic-ops
+
+# Start the full Control Plane (FastAPI REST API, SRE Console /console, Chat /chat, MCP Server /sse)
+agentic-start --port 8000 --host 0.0.0.0
+
+# Run SRE Trust Ledger diagnostics
+agentic-ops audit
+```
+
+### Option B: Local Source Development & Full Test Suite
 
 ```bash
 # 1. Environment setup
@@ -1445,13 +1468,13 @@ git clone https://github.com/nolll77/agentic-ops.git
 cd agentic-ops-core
 uv venv .venv
 source .venv/bin/activate
-uv pip install -e .
+uv pip install -e ".[dev]"
 uv pip install 'httpx[socks]'
 
-# 2. Run the E2E Security, Scenarios, CAC Connector & MCP Gateway Test Suite
-PYTHONPATH=. pytest tests/ -v
+# 2. Run the E2E Security, Scenarios, CAC Connector & MCP Gateway Test Suite (127 tests)
+pytest tests/ -v
 # > Verifies WORM immutability, Fail-Closed governance,
-# > non-bypassable Orchestrator state transitions, 13 CacPullCollector tests, and 12 MCP Gateway tests.
+# > non-bypassable Orchestrator state transitions, 13 CacPullCollector tests, and 24 MCP Gateway tests.
 
 # 3. Launch the Trust Ledger Audit CLI or the STDIO MCP Server
 python -m agentic_ops.cli.trust_ledger list
@@ -1484,6 +1507,8 @@ python -m agentic_ops.entrypoints.mcp_server
     Exhaustive architectural breakdown of the 5 cascading resilience and safety fallback layers in `Agentic-Ops`: Cognitive Multi-LLM failover, FinOps Circuit Breaker, Specialist routing fallback, Policy Engine fail-closed enforcement, and Remote VPS/Tailscale partition locks. Includes complete code mapping keys, trigger conditions, fallback states, and the **Provider Independence & Disaster Recovery Strategy** detailing the 4 lines of defense (zero-code env switches, 100% sovereign off-cloud Ollama over Tailscale, granular per-role splitting, and deterministic 0-token safety net) if OpenRouter cuts access or changes policies.
 11. **[Multi-Agent System (MAS) Agent Selection & Default Routing Architecture (`docs/MAS_AGENT_ROUTING_AND_DEFAULTS_GUIDE.md`)](docs/MAS_AGENT_ROUTING_AND_DEFAULTS_GUIDE.md)**:
     In-depth guide to the 5 specialized agent roles (`DataSpecialist`, `ModelSpecialist`, `InfraSpecialist`, `RemediationAgent`, `WebChatCopilot`), taxonomic routing logic in `_get_specialist()`, anti-bias judicial separation between investigation and remediation, and the rationale behind `DataSpecialist` as the universal platform default. Includes the exhaustive breakdown of non-cognitive components operating with **zero LLMs (0-token, pure deterministic Python)** under the Zero-Trust security model, as well as the interactive **Live MAS Topology & Agent Inspector** embedded directly in both the Web Console (`/console`) and Web Chat (`/chat`) backed by `GET /api/mas/topology`.
+12. **[PyPI Release & Distribution Engineering Guide (`docs/PYPI_RELEASE_AND_DISTRIBUTION_GUIDE.md`)](docs/PYPI_RELEASE_AND_DISTRIBUTION_GUIDE.md)**:
+    Comprehensive guide to public package distribution on PyPI: software supply chain security, zero-static-secrets architecture using OpenID Connect (OIDC Trusted Publishing), SLSA provenance attestations, installation and CLI consumption options, and release lifecycle runbooks for maintainers.
 
 
 

{agentic_ops-0.1.0 → agentic_ops-0.1.2}/README.md

@@ -1,5 +1,7 @@
 # Agentic-Ops Control Plane
 
+[![PyPI - Version](https://img.shields.io/pypi/v/agentic-ops?color=blue&logo=pypi&logoColor=white)](https://pypi.org/project/agentic-ops/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/agentic-ops)](https://pypi.org/project/agentic-ops/)
 [![M8ven Trust](https://m8ven.ai/badge/mcp/nolll77-agentic-ops-1ogfsr?v=ccffd1d26d212de101328dba6fea5547)](https://m8ven.ai/mcp/nolll77-agentic-ops-1ogfsr?s=readme)
 ![Status](https://img.shields.io/badge/Status-Production%20Hardened-success)
 ![Security](https://img.shields.io/badge/Security-Red%20Teamed-critical)
@@ -31,6 +33,7 @@ To demonstrate this platform-agnostic design in real production conditions, `Age
 1. **Live Serverless Auto-Wake Production Instance (`Render` + `Tailscale` + `cron-job.org`)**:
    - **Live Control Plane Status**: **[`https://agentic-ops-5ebv.onrender.com/`](https://agentic-ops-5ebv.onrender.com/)**
    - **Live Interactive SRE Web Console (`/console`)**: **[`https://agentic-ops-5ebv.onrender.com/console`](https://agentic-ops-5ebv.onrender.com/console)**
+   - **Live Interactive Web Chat Copilot (`/chat`)**: **[`https://agentic-ops-5ebv.onrender.com/chat`](https://agentic-ops-5ebv.onrender.com/chat)**
    - **Live `MCP` (`Model Context Protocol`) Manifest (`/mcp/manifest`)**: **[`https://agentic-ops-5ebv.onrender.com/mcp/manifest`](https://agentic-ops-5ebv.onrender.com/mcp/manifest)** *(Full guide: **[`docs/MCP_SERVER_GUIDE.md`](docs/MCP_SERVER_GUIDE.md)**)*
    - **Live Tailscale Mesh Status (`100.85.198.81`)**: **[`https://agentic-ops-5ebv.onrender.com/api/tailscale/status`](https://agentic-ops-5ebv.onrender.com/api/tailscale/status)**
    - **Live Read-Only Pull Snapshot (`jakatt/cac_mlops`)**: **[`https://agentic-ops-5ebv.onrender.com/api/cac/snapshot`](https://agentic-ops-5ebv.onrender.com/api/cac/snapshot)**
@@ -373,6 +376,7 @@ To allow `Agentic-Ops` to run continuously on a free-tier PaaS (`Render`, `Huggi
 | :--- | :--- | :--- | :--- |
 | **Root Auto-Wake & Daemon Status** | **[`https://agentic-ops-5ebv.onrender.com/`](https://agentic-ops-5ebv.onrender.com/)** | `GET` | **Primary Auto-Wake URL**. Visiting this URL in a browser or calling it via `fetch()` from an external frontend (`Vercel`) wakes the container automatically if asleep and returns the live status of local `Redis` (`127.0.0.1:6379`) and `Tailscale SOCKS5` (`127.0.0.1:1055`). |
 | **Interactive SRE Web Terminal (`/console`)** | **[`https://agentic-ops-5ebv.onrender.com/console`](https://agentic-ops-5ebv.onrender.com/console)** | `GET` | **Zero-Cost SSH Shell Replacement**. Dark-mode browser terminal providing 1-click execution of `pytest` suites, `trust_ledger list`, `tailscale status` (with automatic PII redaction), `tailscale netcheck`, and `redis-cli PING`. |
+| **Interactive SRE Web Chat Copilot (`/chat`)** | **[`https://agentic-ops-5ebv.onrender.com/chat`](https://agentic-ops-5ebv.onrender.com/chat)** | `GET` | **Natural Language SRE Copilot**. Dark-mode conversational UI to query telemetry, models drift, WORM ledger security, and MAS topology via `POST /api/chat`. |
 | **Interactive `Swagger UI` API Console (`/docs`)** | **[`https://agentic-ops-5ebv.onrender.com/docs`](https://agentic-ops-5ebv.onrender.com/docs)** | `GET` | Interactive `OpenAPI` interface (`Try it out` -> `Execute`) for all endpoints and diagnostic commands. |
 | **Whitelisted Diagnostic Runner** | **[`https://agentic-ops-5ebv.onrender.com/api/diagnostics/pytest_cac_connector`](https://agentic-ops-5ebv.onrender.com/api/diagnostics/pytest_cac_connector)** | `GET` | Executes a whitelisted diagnostic command inside the container (`pytest_cac_connector`, `pytest_security`, `pytest_all`, `trust_ledger_list`, `tailscale_status`, `tailscale_netcheck`, `tailscale_logs`, `redis_ping`, `system_info`). |
 | **Keep-Alive Liveness Probe** | **[`https://agentic-ops-5ebv.onrender.com/healthz`](https://agentic-ops-5ebv.onrender.com/healthz)** | `GET` | Lightweight health check returning `{"status": "ok"}`. Polled every `10 minutes` by `cron-job.org` to prevent the `15-minute` free-tier inactivity spin-down. |
@@ -1408,7 +1412,25 @@ Applying the repository's **Radical Honesty** rule, `Agentic-Ops` intentionally
 
 ---
 
-## Installation & E2E Validation Tests
+## Installation & Quickstart
+
+### Option A: Install from PyPI (Recommended for Production & Clusters)
+
+```bash
+# Standard installation via pip
+pip install agentic-ops
+
+# Or using uv (ultra-fast dependency resolver)
+uv pip install agentic-ops
+
+# Start the full Control Plane (FastAPI REST API, SRE Console /console, Chat /chat, MCP Server /sse)
+agentic-start --port 8000 --host 0.0.0.0
+
+# Run SRE Trust Ledger diagnostics
+agentic-ops audit
+```
+
+### Option B: Local Source Development & Full Test Suite
 
 ```bash
 # 1. Environment setup
@@ -1416,13 +1438,13 @@ git clone https://github.com/nolll77/agentic-ops.git
 cd agentic-ops-core
 uv venv .venv
 source .venv/bin/activate
-uv pip install -e .
+uv pip install -e ".[dev]"
 uv pip install 'httpx[socks]'
 
-# 2. Run the E2E Security, Scenarios, CAC Connector & MCP Gateway Test Suite
-PYTHONPATH=. pytest tests/ -v
+# 2. Run the E2E Security, Scenarios, CAC Connector & MCP Gateway Test Suite (127 tests)
+pytest tests/ -v
 # > Verifies WORM immutability, Fail-Closed governance,
-# > non-bypassable Orchestrator state transitions, 13 CacPullCollector tests, and 12 MCP Gateway tests.
+# > non-bypassable Orchestrator state transitions, 13 CacPullCollector tests, and 24 MCP Gateway tests.
 
 # 3. Launch the Trust Ledger Audit CLI or the STDIO MCP Server
 python -m agentic_ops.cli.trust_ledger list
@@ -1455,6 +1477,8 @@ python -m agentic_ops.entrypoints.mcp_server
     Exhaustive architectural breakdown of the 5 cascading resilience and safety fallback layers in `Agentic-Ops`: Cognitive Multi-LLM failover, FinOps Circuit Breaker, Specialist routing fallback, Policy Engine fail-closed enforcement, and Remote VPS/Tailscale partition locks. Includes complete code mapping keys, trigger conditions, fallback states, and the **Provider Independence & Disaster Recovery Strategy** detailing the 4 lines of defense (zero-code env switches, 100% sovereign off-cloud Ollama over Tailscale, granular per-role splitting, and deterministic 0-token safety net) if OpenRouter cuts access or changes policies.
 11. **[Multi-Agent System (MAS) Agent Selection & Default Routing Architecture (`docs/MAS_AGENT_ROUTING_AND_DEFAULTS_GUIDE.md`)](docs/MAS_AGENT_ROUTING_AND_DEFAULTS_GUIDE.md)**:
     In-depth guide to the 5 specialized agent roles (`DataSpecialist`, `ModelSpecialist`, `InfraSpecialist`, `RemediationAgent`, `WebChatCopilot`), taxonomic routing logic in `_get_specialist()`, anti-bias judicial separation between investigation and remediation, and the rationale behind `DataSpecialist` as the universal platform default. Includes the exhaustive breakdown of non-cognitive components operating with **zero LLMs (0-token, pure deterministic Python)** under the Zero-Trust security model, as well as the interactive **Live MAS Topology & Agent Inspector** embedded directly in both the Web Console (`/console`) and Web Chat (`/chat`) backed by `GET /api/mas/topology`.
+12. **[PyPI Release & Distribution Engineering Guide (`docs/PYPI_RELEASE_AND_DISTRIBUTION_GUIDE.md`)](docs/PYPI_RELEASE_AND_DISTRIBUTION_GUIDE.md)**:
+    Comprehensive guide to public package distribution on PyPI: software supply chain security, zero-static-secrets architecture using OpenID Connect (OIDC Trusted Publishing), SLSA provenance attestations, installation and CLI consumption options, and release lifecycle runbooks for maintainers.
 
 
 

{agentic_ops-0.1.0 → agentic_ops-0.1.2}/README_FR.md

@@ -1,5 +1,7 @@
 # Agentic-Ops Control Plane
 
+[![PyPI - Version](https://img.shields.io/pypi/v/agentic-ops?color=blue&logo=pypi&logoColor=white)](https://pypi.org/project/agentic-ops/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/agentic-ops)](https://pypi.org/project/agentic-ops/)
 [![M8ven Trust](https://m8ven.ai/badge/mcp/nolll77-agentic-ops-1ogfsr?v=ccffd1d26d212de101328dba6fea5547)](https://m8ven.ai/mcp/nolll77-agentic-ops-1ogfsr?s=readme)
 ![Status](https://img.shields.io/badge/Status-Production%20Hardened-success)
 ![Security](https://img.shields.io/badge/Security-Red%20Teamed-critical)
@@ -31,6 +33,7 @@ Pour démontrer concrètement cette architecture agnostique en conditions réell
 1. **Instance de Production Serverless Auto-Wake en Ligne (`Render` + `Tailscale` + `cron-job.org`)** :
    - **Statut du Control Plane en direct** : **[`https://agentic-ops-5ebv.onrender.com/`](https://agentic-ops-5ebv.onrender.com/)**
    - **Terminal Web SRE Interactif (`/console`)** : **[`https://agentic-ops-5ebv.onrender.com/console`](https://agentic-ops-5ebv.onrender.com/console)**
+   - **Copilote Web Chat SRE en direct (`/chat`)** : **[`https://agentic-ops-5ebv.onrender.com/chat`](https://agentic-ops-5ebv.onrender.com/chat)**
    - **Manifeste `MCP` (`Model Context Protocol`) en direct (`/mcp/manifest`)** : **[`https://agentic-ops-5ebv.onrender.com/mcp/manifest`](https://agentic-ops-5ebv.onrender.com/mcp/manifest)** *(Guide complet : **[`docs/MCP_SERVER_GUIDE.md`](docs/MCP_SERVER_GUIDE.md)**)*
    - **Statut du Tunnel Maillé Tailscale (`100.85.198.81`)** : **[`https://agentic-ops-5ebv.onrender.com/api/tailscale/status`](https://agentic-ops-5ebv.onrender.com/api/tailscale/status)**
    - **Collecte Pull Lecture Seule en direct (`jakatt/cac_mlops`)** : **[`https://agentic-ops-5ebv.onrender.com/api/cac/snapshot`](https://agentic-ops-5ebv.onrender.com/api/cac/snapshot)**
@@ -373,6 +376,7 @@ Pour permettre à `Agentic-Ops` de tourner en continu sur un PaaS gratuit (`Rend
 | :--- | :--- | :--- | :--- |
 | **Route Racine Auto-Wake & Statut des Démons** | **[`https://agentic-ops-5ebv.onrender.com/`](https://agentic-ops-5ebv.onrender.com/)** | `GET` | **URL Principale d'Auto-Wake**. Visiter cette URL dans un navigateur ou l'appeler via `fetch()` depuis un frontend externe (`Vercel`) réveille automatiquement le conteneur s'il est en veille et renvoie l'état en direct de `Redis` (`127.0.0.1:6379`) et du proxy `Tailscale SOCKS5` (`127.0.0.1:1055`). |
 | **Terminal Web SRE Interactif (`/console`)** | **[`https://agentic-ops-5ebv.onrender.com/console`](https://agentic-ops-5ebv.onrender.com/console)** | `GET` | **Remplacement Gratuit du Shell SSH**. Terminal web Dark-Mode permettant d'exécuter en 1 clic les suites `pytest`, `trust_ledger list`, `tailscale status` (avec anonymisation PII automatique), `tailscale netcheck` et `redis-cli PING`. |
+| **Copilote Web Chat SRE en direct (`/chat`)** | **[`https://agentic-ops-5ebv.onrender.com/chat`](https://agentic-ops-5ebv.onrender.com/chat)** | `GET` | **Copilote SRE en Langage Naturel**. Interface conversationnelle Dark-Mode pour interroger la télémétrie, la dérive des modèles, la sécurité du ledger WORM et la topologie MAS via `POST /api/chat`. |
 | **Console API Interactive `Swagger UI` (`/docs`)** | **[`https://agentic-ops-5ebv.onrender.com/docs`](https://agentic-ops-5ebv.onrender.com/docs)** | `GET` | Interface `OpenAPI` interactive (`Try it out` -> `Execute`) pour tester toutes les routes et commandes de diagnostic. |
 | **Exécuteur de Commandes de Diagnostic** | **[`https://agentic-ops-5ebv.onrender.com/api/diagnostics/pytest_cac_connector`](https://agentic-ops-5ebv.onrender.com/api/diagnostics/pytest_cac_connector)** | `GET` | Exécute une commande de diagnostic autorisée dans le conteneur (`pytest_cac_connector`, `pytest_security`, `pytest_all`, `trust_ledger_list`, `tailscale_status`, `tailscale_netcheck`, `tailscale_logs`, `redis_ping`, `system_info`). |
 | **Sonde de Vie `Keep-Alive` (`Liveness Probe`)** | **[`https://agentic-ops-5ebv.onrender.com/healthz`](https://agentic-ops-5ebv.onrender.com/healthz)** | `GET` | Route ultra-légère renvoyant `{"status": "ok"}`. Interrogée toutes les `10 minutes` par `cron-job.org` pour empêcher la mise en veille au bout de `15 minutes` d'inactivité du plan gratuit. |
@@ -1408,7 +1412,25 @@ En application stricte de la règle d'**Honnêteté Radicale** du projet, `Agent
 
 ---
 
-## Installation & Tests (E2E Validation)
+## Installation & Prise en Main Rapide
+
+### Option A : Installation depuis PyPI (Recommandé pour la Production & Clusters)
+
+```bash
+# Installation standard via pip
+pip install agentic-ops
+
+# Ou via uv (gestionnaire de paquets ultra-rapide)
+uv pip install agentic-ops
+
+# Démarrer le Control Plane complet (API REST FastAPI, Console SRE /console, Chat /chat, Serveur MCP /sse)
+agentic-start --port 8000 --host 0.0.0.0
+
+# Exécuter l'audit d'intégrité du Trust Ledger
+agentic-ops audit
+```
+
+### Option B : Développement Local depuis les Sources & Suite de Tests Complète
 
 ```bash
 # 1. Préparation de l'environnement
@@ -1416,13 +1438,13 @@ git clone https://github.com/nolll77/agentic-ops.git
 cd agentic-ops-core
 uv venv .venv
 source .venv/bin/activate
-uv pip install -e .
+uv pip install -e ".[dev]"
 uv pip install 'httpx[socks]'
 
-# 2. Exécuter l'Intégration Continue E2E (Sécurité, Scénarios, Connecteur CAC & Passerelle MCP)
-PYTHONPATH=. pytest tests/ -v
+# 2. Exécuter la suite complète de 127 tests (Sécurité, Scénarios, Connecteur CAC & Passerelle MCP)
+pytest tests/ -v
 # > Vérifie l'immutabilité WORM, le Fail-Closed de la Gouvernance,
-# > l'incapacité de contournement de l'Orchestrateur, les 13 tests de CacPullCollector et les 12 tests MCP.
+# > l'incapacité de contournement de l'Orchestrateur, les 13 tests de CacPullCollector et les 24 tests MCP.
 
 # 3. Lancer la TUI d'Audit du Trust Ledger ou le Serveur MCP STDIO
 python -m agentic_ops.cli.trust_ledger list
@@ -1455,6 +1477,8 @@ python -m agentic_ops.entrypoints.mcp_server
     Dissection architecturale exhaustive des 5 niveaux de repli (fallbacks) en cascade garantissant la résilience et la sécurité du Control Plane : Bascule cognitive multi-LLM, Circuit Breaker FinOps, Aiguillage des Spécialistes, Fail-Closed du Moteur de Règles et Verrouillage Réseau VPS/Tailscale. Inclut toutes les clés de mapping de configuration, déclencheurs, états de repli, ainsi que la **Stratégie d'Indépendance Fournisseur & Plan de Continuité** détaillant la défense en 4 lignes (bascule zero-code d'env var, sanctuaire souverain 100% hors-cloud via Ollama/Tailscale, isolation fine par agent, et filet de sécurité déterministe à 0-token) en cas de coupure des accès ou changement de politique d'OpenRouter.
 11. **[Architecture de Sélection des Agents & Routage par Défaut du MAS (`docs/MAS_AGENT_ROUTING_AND_DEFAULTS_GUIDE.md`)](docs/MAS_AGENT_ROUTING_AND_DEFAULTS_GUIDE.md)** :
     Guide exhaustif sur les 5 rôles d'agents spécialisés (`DataSpecialist`, `ModelSpecialist`, `InfraSpecialist`, `RemediationAgent`, `WebChatCopilot`), la logique de routage taxonomique dans `_get_specialist()`, la séparation judiciaire anti-biais entre diagnostic et remédiation, et les justifications opérationnelles établissant `DataSpecialist` comme repli universel de la plateforme. Inclut la dissection architecturale des composants non-cognitifs (`CircuitBreakerFallback`, `ActionExecutor`, `CacPullCollector`, `SlackWebhookAgent`, 8 `AgentTools` et `MCPServerGateway`) fonctionnant avec **zéro LLM (0-token, Python déterministe pur)** selon le modèle de sécurité Zero-Trust, ainsi que l'encart d'inspection interactif **Topologie MAS & LLMs Live** intégré nativement dans la Console Web (`/console`) et le Chat Web (`/chat`) alimenté par l'endpoint `GET /api/mas/topology`.
+12. **[Guide d'Ingénierie de Distribution PyPI & Release (`docs/PYPI_RELEASE_AND_DISTRIBUTION_GUIDE.md`)](docs/PYPI_RELEASE_AND_DISTRIBUTION_GUIDE.md)** :
+    Guide exhaustif sur la distribution publique du package sur PyPI : sécurisation de la chaîne d'approvisionnement logicielle, architecture sans secret statique via OpenID Connect (OIDC Trusted Publishing), attestations numériques SLSA, modes d'installation et d'exécution CLI, et runbooks de release pour les mainteneurs.
 
 
 

{agentic_ops-0.1.0 → agentic_ops-0.1.2}/agentic_ops/adapters/llm_provider_registry.py

@@ -495,16 +495,85 @@ class LLMProviderRegistry:
                 "latency_ms": latency_ms,
             }
         except Exception as exc:
+            t_elapsed = round((time.monotonic() - t0) * 1000, 1)
+            offline_answer = _get_offline_sre_answer(message)
+            if offline_answer:
+                return {
+                    "status": "ok",
+                    "answer": offline_answer,
+                    "action_type": "KNOWLEDGE_LOOKUP",
+                    "confidence_score": 1.0,
+                    "rationale": "Réponse déterministe servie depuis la base de connaissances SRE intégrée (mode dégradé Zero-Token).",
+                    "provider": "agentic_ops_builtin",
+                    "model": "deterministic_sre_knowledge_base",
+                    "latency_ms": t_elapsed,
+                }
+
+            key_env = os.environ.get("OPENROUTER_API_KEY", "")
+            key_hint = "" if key_env else " (La variable OPENROUTER_API_KEY est absente de l'environnement)."
             return {
                 "status": "error",
                 "error": str(exc),
-                "answer": f"Erreur de communication avec le fournisseur LLM ({exc}).",
+                "answer": (
+                    f"Incident Fournisseur LLM : {exc}.{key_hint} "
+                    "Vérifiez vos clés d'API (OPENROUTER_API_KEY, etc.) ou posez une question sur les concepts clés du Control Plane "
+                    "(Circuit Breaker, WORM Ledger, Slack HITL, Dérive Evidently, Fail-Closed)."
+                ),
                 "provider": os.environ.get("LLM_PROVIDER", "openrouter"),
                 "model": os.environ.get("LLM_MODEL", "unknown"),
-                "latency_ms": None,
+                "latency_ms": t_elapsed,
             }
 
 
+def _get_offline_sre_answer(message: str) -> str | None:
+    msg = message.lower()
+    if any(k in msg for k in ["circuit breaker", "saturation", "quota", "coupe-circuit"]):
+        return (
+            "**[Mode Dégradé SRE — Base Déterministe In-Memory]**\n\n"
+            "Le **Circuit Breaker** (FinOps & SecOps) protège le cluster contre les tempêtes de requêtes, "
+            "les boucles infinies d'agents et l'explosion des coûts d'API LLM :\n\n"
+            "• **Seuil de déclenchement** : au-delà de 50 requêtes/heure ou en cas de défaillances 5xx en chaîne, "
+            "le coupe-circuit bascule immédiatement en état `TRIPPED`.\n"
+            "• **Gouvernance Fail-Closed** : dès l'activation du coupe-circuit, tout appel vers les modèles probabilistes "
+            "est coupé. Le système injecte le diagnostic figé `CIRCUIT_BREAKER_FALLBACK` et restreint les actions possibles "
+            "à l'opération non-mutante `CREATE_ISSUE` (ouverture d'un ticket GitHub d'alerte, 0 token consommé, 0 mutation en production)."
+        )
+    if any(k in msg for k in ["worm", "trust ledger", "ledger", "immuab", "tamper", "audit trail"]):
+        return (
+            "**[Mode Dégradé SRE — Base Déterministe In-Memory]**\n\n"
+            "Le **WORM Trust Ledger** (*Write Once, Read Many*) garantit l'immuabilité cryptographique et la non-répudiation "
+            "de chaque intervention autonome sur le cluster MLOps :\n\n"
+            "• **Chaînage cryptographique** : chaque épisode résolu est scellé par double signature `SHA-256` et `HMAC-SHA512` "
+            "enchaînée sur l'état du bloc précédent (arbre de Merkle).\n"
+            "• **Traçabilité forensique** : le registre consigne l'empreinte exacte du signal d'alerte, les faits système observés, "
+            "le diagnostic de l'agent, l'approbation humaine Slack et la commande exécutée.\n"
+            "• **Détection d'altération** : la commande `agentic-ops audit` recalcule l'intégrité de la chaîne. Toute modification "
+            "post-mortem ou suppression d'entrée déclenche immédiatement une alerte de falsification (*Tampering Alert*)."
+        )
+    if any(k in msg for k in ["drift", "evidently", "dérive"]):
+        return (
+            "**[Mode Dégradé SRE — Base Déterministe In-Memory]**\n\n"
+            "La surveillance du **Data Drift** et du **Model Staleness** est opérée en continu via les connecteurs Evidently et Pandera :\n\n"
+            "• **Détection statistique** : calcul des distances de Wasserstein et tests de Kolmogorov-Smirnov sur les distributions d'entrées.\n"
+            "• **Routage spécialisé** : toute dérive avérée est acheminée vers le `DataSpecialist` pour discriminer une dérive ponctuelle de covariables d'une dérive de concept réelle exigeant un réentraînement."
+        )
+    if any(k in msg for k in ["slack", "hitl", "approbation", "quorum"]):
+        return (
+            "**[Mode Dégradé SRE — Base Déterministe In-Memory]**\n\n"
+            "Le protocole **Slack HITL** (*Human-in-the-Loop*) constitue le garde-fou obligatoire pour toute action à impact matériel (*Mutating Actions*) :\n\n"
+            "• **Sécurité cryptographique** : chaque interaction est validée par signature `HMAC-SHA256` (`X-Slack-Signature`) et fenêtre anti-rejeu (< 300s).\n"
+            "• **Concurrence distribuée** : les approbations concurrentes sont arbitrées par verrou atomique `SQLite BEGIN IMMEDIATE` pour éliminer tout risque de double exécution (Race Condition)."
+        )
+    if any(k in msg for k in ["fail-closed", "zero-trust", "politique", "policy"]):
+        return (
+            "**[Mode Dégradé SRE — Base Déterministe In-Memory]**\n\n"
+            "Le principe **Fail-Closed** stipule qu'en l'absence de règle explicite autorisant une action (`ALLOW`), "
+            "ou lors d'une défaillance réseau / partition Tailscale, le `PolicyEngine` applique par défaut le statut `DENY`.\n\n"
+            "Aucune action mutante ne peut être exécutée sans autorisation déterministe préalable."
+        )
+    return None
+
+
 def _set_env_if_missing(key: str, value: str) -> None:
     if key not in os.environ and value:
         os.environ[key] = value

{agentic_ops-0.1.0 → agentic_ops-0.1.2}/agentic_ops/cli/main.py

@@ -18,7 +18,7 @@ from agentic_ops.adapters.cac_pull_collector import CacPullCollector
 app = FastAPI(
     title="Agentic-Ops Control Plane",
     description="Deterministic SRE & MLOps Governance Control Plane (Auto-Wake Ready + Web Console + MCP Gateway)",
-    version="0.1.0",
+    version="0.1.2",
 )
 
 # CORS enabled so a Vercel frontend or external dashboard can wake the container via fetch()

{agentic_ops-0.1.0 → agentic_ops-0.1.2}/agentic_ops/entrypoints/mcp_server.py

@@ -59,7 +59,7 @@ SCENARIOS_DATA_DIR = REPO_ROOT / "tests" / "scenarios" / "data"
 MCP_PROTOCOL_VERSION = "2024-11-05"
 SERVER_INFO = {
     "name": "agentic-ops-mcp-gateway",
-    "version": "0.1.0",
+    "version": "0.1.2",
     "description": (
         "Deterministic MLOps & SRE Governance Control Plane MCP Server "
         "(8 Tools, 5 Knowledge Resources, 20 Starter Prompts)"

agentic_ops-0.1.2/docs/PYPI_RELEASE_AND_DISTRIBUTION_GUIDE.md

@@ -0,0 +1,228 @@
+# Guide d'Ingénierie : Distribution PyPI, OIDC Trusted Publishing & Release Engineering
+
+Ce document formalise l'architecture de distribution publique du package `agentic-ops`, la chaîne de sécurité logicielle OIDC (*OpenID Connect Trusted Publishing*) et les runbooks de publication pour les mainteneurs et exploitants.
+
+```text
++--------------------------------------------------------------------------------------------------+
+| AGENTIC-OPS — CHAÎNE D'APPROVISIONNEMENT LOGICIELLE & DISTRIBUTION PYPI (OIDC / SLSA)             |
++--------------------------------------------------------------------------------------------------+
+|                                                                                                  |
+| [Developpeur / Maintainer]                                                                       |
+|        │                                                                                         |
+|        ├──► 1. Bump version `pyproject.toml`                                                     |
+|        ├──► 2. Synchronisation `uv lock`                                                         |
+|        └──► 3. Git Tag / Workflow Dispatch (`origin/main`)                                       |
+|                    │                                                                             |
+|                    ▼                                                                             |
+| [GitHub Actions Runner (ubuntu-latest)]                                                          |
+|        │                                                                                         |
+|        ├──► `actions/checkout@v4`                                                                |
+|        ├──► `astral-sh/setup-uv@v5` (Installation ultra-rapide)                                  |
+|        ├──► `uv build` ──► Generation des artefacts purs :                                      |
+|        │                    ├── `dist/agentic_ops-X.Y.Z.tar.gz` (sdist)                          |
+|        │                    └── `dist/agentic_ops-X.Y.Z-py3-none-any.whl` (wheel)                |
+|        │                                                                                         |
+|        ├──► Demande de JIT Token OIDC (Permission `id-token: write`)                             |
+|        │           │                                                                             |
+|        │           ▼                                                                             |
+|        │    [GitHub OIDC Provider]                                                               |
+|        │           │                                                                             |
+|        │           ├── JWT éphémère (claims: repo, workflow, environment `pypi`)                 |
+|        │           ▼                                                                             |
+|        │    [PyPI Trusted Publisher Engine]                                                      |
+|        │           │                                                                             |
+|        │           ├── Validation cryptographique des claims (sans mot de passe ni API token)    |
+|        │           └── Délivrance d'un token PyPI éphémère à portée restreinte (< 15 min)        |
+|        │                                                                                         |
+|        └──► `pypa/gh-action-pypi-publish@release/v1`                                             |
+|                    │                                                                             |
+|                    ├── Upload sdist & wheel                                                      |
+|                    └── Signature & Attestation numérique SLSA de provenance                     |
+|                                                                                                  |
+|                    ▼                                                                             |
+| [Registre Officiel PyPI : https://pypi.org/project/agentic-ops/]                                 |
+|        │                                                                                         |
+|        ▼                                                                                         |
+| [Utilisateurs Finaux / Clusters MLOps Mondiaux]                                                  |
+|        │                                                                                         |
+|        ├──► `pip install agentic-ops`                                                            |
+|        └──► `agentic-start --port 8000`                                                          |
+|                                                                                                  |
++--------------------------------------------------------------------------------------------------+
+```
+
+---
+
+## 1. Identité & Disponibilité du Package
+
+* **Nom Officiel** : `agentic-ops`
+* **URL du Registre** : [https://pypi.org/project/agentic-ops/](https://pypi.org/project/agentic-ops/)
+* **Version Active** : `0.1.2`
+* **Licence** : `MIT`
+* **Régistre Simple (Index)** : `https://pypi.org/simple/agentic-ops/`
+* **Compatibilité Runtimes** : `Python >= 3.10` (testé et validé unitairement sur 3.10, 3.11, 3.12).
+* **Empreinte** : Package agnostique pur Python (`py3-none-any.whl`), sans dépendance binaire compilée C/Rust non-portable.
+
+---
+
+## 2. Modes d'Installation & Consommation
+
+### A. Installation via Gestionnaires de Paquets Standards
+
+Tout utilisateur ou pipeline CI/CD peut installer la distribution officielle :
+
+```bash
+# Via pip standard
+pip install agentic-ops
+
+# Via uv (recommandé pour les déploiements rapides)
+uv pip install agentic-ops
+
+# Via poetry
+poetry add agentic-ops
+```
+
+### B. Point d'Entrée CLI (Console & Serveur SRE)
+
+Le package enregistre automatiquement l'exécutable système `agentic-ops` et l'alias de démarrage :
+
+```bash
+# Lancement de la plateforme complète (FastAPI, Console /console, Chat /chat, MCP /sse)
+agentic-start --port 8000 --host 0.0.0.0
+
+# Inspection des vitaux et de l'intégrité du Ledger WORM
+agentic-ops audit
+```
+
+### C. Importation Modulaire en Bibliothèque Python
+
+```python
+from agentic_ops.adapters.llm_provider_registry import LLMProviderRegistry
+from agentic_ops.core.orchestrator import Orchestrator
+from agentic_ops.core.remediation_agent import RemediationAgent
+
+# Résolution automatique de la topologie multi-LLM par rôle
+remediation_adapter = LLMProviderRegistry.build_adapter_for_role("remediation")
+orchestrator = Orchestrator(llm=remediation_adapter)
+```
+
+---
+
+## 3. Sécurité de la Chaîne d'Approvisionnement (Trusted Publishing / OIDC)
+
+### A. Problématique des Secrets Statiques
+
+Historiquement, la publication de packages Python reposait sur des tokens d'API longue durée stockés dans les variables `ACTIONS_SECRETS` de GitHub. Ces secrets présentaient des risques majeurs :
+1. **Fuite accidentelle** lors de l'exécution d'actions tierces ou de modifications de logs.
+2. **Absence d'expiration** facilitant l'injection de dépendances corrompues (*Software Supply Chain Attack*).
+3. **Périmètre excessif** accordant des droits d'écriture sur l'ensemble des dépôts du compte mainteneur.
+
+### B. Standard OIDC (OpenID Connect)
+
+`agentic-ops` implémente le standard moderne **Trusted Publishing** promu par la *Python Software Foundation* (PSF) :
+* Aucun mot de passe ni token statique n'est configuré dans GitHub Secrets.
+* Lors de chaque exécution du workflow `.github/workflows/publish.yml`, GitHub Actions génère un jeton cryptographique OIDC signé (`id-token: write`).
+* PyPI valide l'empreinte cryptographique émise par GitHub, certifiant que l'appel provient exclusivement :
+  * Du dépôt : `nolll77/agentic-ops`
+  * Du workflow : `.github/workflows/publish.yml`
+  * De l'environnement : `pypi`
+* PyPI délivre un token éphémère d'une durée de vie inférieure à 15 minutes, restreint au téléversement de la version courante.
+* Des attestations numériques de provenance SLSA (*Supply-chain Levels for Software Artifacts*) sont automatiquement générées et associées à la release.
+
+---
+
+## 4. Spécification du Workflow CI/CD (`publish.yml`)
+
+Le workflow de déploiement continu est défini dans [`.github/workflows/publish.yml`](file:///Users/nolll/Documents/car_acc/agentic-ops-core/.github/workflows/publish.yml) :
+
+```yaml
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  pypi-publish:
+    name: Upload release to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/agentic-ops
+    permissions:
+      id-token: write  # Requis pour l'échange de jeton OIDC avec PyPI
+      contents: read
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.11"
+
+    - name: Build package
+      run: |
+        uv build
+
+    - name: Publish package distributions to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+```
+
+---
+
+## 5. Runbook Opérationnel : Publier une Nouvelle Version
+
+Pour incrémenter et publier une nouvelle version d'`agentic-ops` (ex: `0.1.1` ou `0.2.0`) :
+
+1. **Incrémenter la version dans `pyproject.toml`** :
+   ```toml
+   [project]
+   name = "agentic-ops"
+   version = "0.1.1"
+   ```
+
+2. **Mettre à jour le fichier de verrouillage** :
+   ```bash
+   uv lock
+   ```
+
+3. **Valider localement le build et la suite de tests** :
+   ```bash
+   pytest tests/
+   uv build
+   ```
+
+4. **Commiter et pousser vers GitHub** :
+   ```bash
+   git add pyproject.toml uv.lock
+   git commit -m "chore(release): bump version to 0.1.1"
+   git push origin main
+   ```
+
+5. **Déclencher le déploiement PyPI** :
+   * **Option 1 (Automatique via GitHub Release)** : Créer une Release GitHub avec le tag `v0.1.1`.
+   * **Option 2 (Manuelle via CLI)** :
+     ```bash
+     gh workflow run publish.yml
+     ```
+
+6. **Vérification post-déploiement** :
+   ```bash
+   python3 -m pip index versions agentic-ops
+   ```
+
+---
+
+## 6. Matrice d'Honnêteté Radicale : Théorie vs. Réalité du Projet
+
+| Dimension | Théorie Idéale MLOps | Réalité de Déploiement `agentic-ops` | Justification SRE & Arbitrage |
+| :--- | :--- | :--- | :--- |
+| **Authentification PyPI** | OIDC Trusted Publishing certifié sans secret | **100% Conforme** (OIDC GitHub/PyPI actif) | Élimine les failles de fuite de tokens statiques dans GitHub Secrets. |
+| **Génération de Build** | Compilation conteneurisée hermétique multi-arch | `uv build` local et runner standard `ubuntu-latest` | Suffisant et ultra-véloce car le package est un wheel pur Python (`none-any`). |
+| **Déclenchement Release** | Tag sémantique `vX.Y.Z` déclenchant une pipeline CD | Supporte à la fois `release: [published]` et `workflow_dispatch` | Permet le déploiement sur événement officiel ou à la demande par le mainteneur. |
+| **Vérification d'Index** | Monitoring temps réel des miroirs mondiaux pip | Test direct HTTP sur l'API JSON PyPI et commande `pip index` | Retour d'état immédiat sous 30 secondes sans complexité superflue. |

{agentic_ops-0.1.0 → agentic_ops-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentic-ops"
-version = "0.1.0"
+version = "0.1.2"
 description = "A generic, plug-and-play Agentic Control Plane for MLOps Governance"
 readme = "README.md"
 license = { text = "MIT" }
@@ -20,7 +20,8 @@ dependencies = [
     "pytest>=8.0.0",
     "pytest-mock>=3.12.0",
     "hypothesis>=6.0.0",
-    "fakeredis>=2.20.0"
+    "fakeredis>=2.20.0",
+    "mcp>=2.3.0",
 ]
 
 [project.optional-dependencies]