xcorecli 1.1.0__tar.gz → 2.0.0__tar.gz

{xcorecli-1.1.0 → xcorecli-2.0.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.5
 Name: xcorecli
-Version: 1.1.0
-Summary: CLI for xcore — configuration, plugins, deployment
+Version: 2.0.0
+Summary: CLI for xcore — configuration, plugins, monitoring
 Requires-Python: >=3.12
 Requires-Dist: alembic>=1.18.0
 Requires-Dist: httpx>=0.27

{xcorecli-1.1.0 → xcorecli-2.0.0}/docs/index.md

@@ -9,7 +9,6 @@
 
 - **Project Initialization**: Seamlessly scaffold new projects and manage `integration.yaml`.
 - **Plugin Lifecycle**: Full control over installing, signing, and updating plugins.
-- **Production Deploy**: Deploy plugins to remote servers via SSH with pre/post hooks.
 - **Real-time Monitoring**: Integrated dashboard for service health and resource usage.
 - **Worker Orchestration**: Manage Celery/XWorker processes with ease.
 - **Security & Sandboxing**: Resource isolation and AST-based whitelisting for plugins.
@@ -30,5 +29,11 @@ make install
 
 - [Installation Guide](getting-started/install.md)
 - [Authentication Setup](getting-started/auth.md)
-- [Deploy to Production](deploy/index.md)
 - [Core Commands Reference](reference.md)
+
+!!! info "Production deployment"
+    Deploying plugin bundles to remote servers is no longer part of
+    `xcorecli` — it's fully handled by the standalone
+    [`xcore-agent`](https://github.com/traoreera/xcore-agent) deployment
+    agent (Hub artifact fetch, signature verification, install/rollback,
+    systemd/Docker/Kubernetes supervisors, CI/CD watch loop).

{xcorecli-1.1.0 → xcorecli-2.0.0}/docs/reference.md

@@ -21,32 +21,11 @@ A comprehensive list of all commands available in `xcorecli`.
 - `manager services reload`: Reconnect a service.
 - `manager services unload`: Shutdown a service.
 
-## `deploy`  Production Deployment
-
-- `deploy init`: Generate a `xcore-deploy.yaml` template file.
-- `deploy list`: Show targets, plugins, extensions, and hooks declared in the config.
-- `deploy <target>`: Deploy integration.yaml + extensions + plugins to a remote server.
-- `deploy status <target>`: Show plugin state on a remote server via the XCore API.
-
-**Key options for `deploy <target>`:**
-
-| Option | Description |
-|---|---|
-| `--plugin <name>` | Deploy only one plugin (skips extensions + integration) |
-| `--dry-run` | Simulate without sending anything |
-| `--no-reload` | Transfer files without triggering reload/restart |
-| `--file <path>` | Use an alternate config file |
-
-**Deploy order:** `integration.yaml` → extensions (services) → plugins
-
-**Sources:** each plugin/extension accepts `source: ./local/path` OR `repo: https://github.com/org/repo` (public), with optional `token: "${GITHUB_TOKEN}"` for private repos or `git@github.com:...` SSH URLs.
-
-**Hook levels:**
-
-| Level | Keys | When |
-|---|---|---|
-| Global | `hooks.pre_deploy` / `hooks.post_deploy` | Once per full deploy run |
-| Per-plugin/extension | `hooks.pre_deploy` / `post_deploy` | Before/after each item |
+!!! info "Production deployment moved"
+    `deploy` (init/list/status, SSH transfer, pre/post hooks) is no
+    longer part of `xcorecli` — it's fully replaced by the standalone
+    [`xcore-agent`](https://github.com/traoreera/xcore-agent) deployment
+    agent.
 
 ---
 

{xcorecli-1.1.0 → xcorecli-2.0.0}/mkdocs.yml

@@ -67,8 +67,6 @@ nav:
     - Marketplace: plugin/marketplace.md
     - Security: plugin/security.md
     - Updates: plugin/update.md
-  - Deploy:
-    - Overview: deploy/index.md
   - Sandbox: sandbox/index.md
   - Worker:
     - Overview: worker/index.md

{xcorecli-1.1.0 → xcorecli-2.0.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "xcorecli"
-version = "1.1.0"
-description = "CLI for xcore — configuration, plugins, deployment"
+version = "2.0.0"
+description = "CLI for xcore — configuration, plugins, monitoring"
 readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [

{xcorecli-1.1.0 → xcorecli-2.0.0}/uv.lock

@@ -773,7 +773,7 @@ wheels = [
 
 [[package]]
 name = "xcorecli"
-version = "1.1.0"
+version = "2.0.0"
 source = { editable = "." }
 dependencies = [
     { name = "alembic" },

{xcorecli-1.1.0 → xcorecli-2.0.0}/xcli/main.py

@@ -13,7 +13,6 @@ _console = Console()
 from xcli.init.manager import _DB_URLS, create_project
 from xcli.init.upgrade import run_upgrade as _run_upgrade
 from xcli.config.cli import app as config_app
-from xcli.deploy.cli import app as deploy_app
 from xcli.manager.cli import app as manager_app
 from xcli.migrations.cli import app as migrations_app
 from xcli.plugin.cli import app as plugin_app
@@ -150,7 +149,6 @@ def services() -> None:
 # ── sub-apps ──────────────────────────────────────────────────
 
 app.add_typer(config_app,  name="config")
-app.add_typer(deploy_app,  name="deploy")
 app.add_typer(plugin_app,  name="plugin")
 app.add_typer(sandbox_app, name="sandbox")
 app.add_typer(worker_app,  name="worker")

{xcorecli-1.1.0 → xcorecli-2.0.0}/xcli/manager/cli.py

@@ -138,6 +138,57 @@ def _build_resources_table() -> Table:
         except (psutil.NoSuchProcess, psutil.AccessDenied):
             pass
 
+    # Plugins en mode "trusted"/"sandboxed(threaded)" tournent DANS le
+    # process API principal (pas de sous-process dédié) — donc pas de PID
+    # à eux. Plutôt que d'afficher des tirets, on retombe sur le process
+    # API (retrouvé via le PID file écrit par `xcli manager start`, ou à
+    # défaut par scan cmdline) et on l'affiche comme ressource *partagée*.
+    main_proc: psutil.Process | None = None
+    try:
+        from xcli.worker.worker import PID_API, _is_running, _read_pid
+
+        main_pid = _read_pid(PID_API)
+        if main_pid and _is_running(main_pid):
+            main_proc = psutil.Process(main_pid)
+    except Exception:
+        main_proc = None
+
+    if main_proc is None:
+        # Pas de PID file (démarrage en foreground sans --detach, ou
+        # process lancé hors xcli) — on cherche le process uvicorn qui
+        # sert l'app, en excluant les sandbox workers déjà identifiés.
+        sandboxed_pids = {p.pid for p in sandbox_pids.values()}
+        for proc in psutil.process_iter(["pid", "cmdline"]):
+            if proc.pid in sandboxed_pids:
+                continue
+            try:
+                cmd = proc.info["cmdline"] or []
+                if any("uvicorn" in str(c) for c in cmd):
+                    main_proc = proc
+                    break
+            except (psutil.NoSuchProcess, psutil.AccessDenied):
+                pass
+
+    main_cpu_str = main_mem_str = main_conn_str = "—"
+    main_pid_str = "—"
+    if main_proc is not None:
+        try:
+            main_pid_str = str(main_proc.pid)
+            cpu = main_proc.cpu_percent(interval=0.05)
+            cpu_color = "red" if cpu > 80 else ("yellow" if cpu > 40 else "green")
+            main_cpu_str = f"[{cpu_color}]{cpu:.1f}[/{cpu_color}]"
+
+            mem = main_proc.memory_info().rss / 1024**2
+            mem_color = "red" if mem > 400 else ("yellow" if mem > 200 else "magenta")
+            main_mem_str = f"[{mem_color}]{mem:.1f}[/{mem_color}]"
+
+            try:
+                main_conn_str = str(len(main_proc.net_connections()))
+            except (psutil.AccessDenied, AttributeError):
+                main_conn_str = "?"
+        except (psutil.NoSuchProcess, psutil.AccessDenied):
+            main_proc = None
+
     table = Table(title=f"Plugin Resources  [dim]{plugins_root}[/dim]", show_lines=True)
     table.add_column("Plugin", style="cyan", no_wrap=True)
     table.add_column("Mode", justify="center")
@@ -196,9 +247,25 @@ def _build_resources_table() -> Table:
                 state_str = "[green]running[/green]" if state == "running" else f"[yellow]{state}[/yellow]"
             except (psutil.NoSuchProcess, psutil.AccessDenied):
                 state_str = "[red]gone[/red]"
+        elif main_proc is not None:
+            # Plugin en process partagé (trusted / non-sandboxé) : on
+            # affiche les métriques du process API, avec un marqueur "~"
+            # pour signaler que c'est une valeur partagée entre plugins,
+            # pas exclusive à celui-ci.
+            pid_str = f"~{main_pid_str}"
+            cpu_str = main_cpu_str
+            mem_str = main_mem_str
+            conn_str = main_conn_str
+            state_str = "[cyan]in-process[/cyan] [dim](partagé)[/dim]"
 
         table.add_row(name, mode, pid_str, cpu_str, mem_str, disk_str, conn_str, state_str)
 
+    if main_proc is not None and any(name not in sandbox_pids for name in plugin_names):
+        table.caption = (
+            "[dim]~PID = process API partagé entre plugins \"in-process (partagé)\" — "
+            "CPU/Mem/Net Conn reflètent le process entier, pas ce plugin seul.[/dim]"
+        )
+
     return table
 
 
@@ -595,12 +662,19 @@ def start(
 
     console.print(f"[dim]→ uvicorn {app_path} --host {resolved_host} --port {resolved_port}[/dim]")
     console.print("[dim]Ctrl+C to stop[/dim]\n")
+    PID_DIR.mkdir(parents=True, exist_ok=True)
     try:
         proc = subprocess.Popen(cmd)
+        # Écrit le PID même en foreground : `xcli manager resources`/`top`
+        # dans un autre terminal en a besoin pour retrouver le process API
+        # (plugins "trusted" partagent ce process, pas de PID dédié).
+        _write_pid(PID_API, proc.pid)
         proc.wait()
     except KeyboardInterrupt:
         proc.terminate()
         proc.wait()
+    finally:
+        PID_API.unlink(missing_ok=True)
 
 
 @app.command("stop")

xcorecli-1.1.0/docs/deploy/index.md

@@ -1,406 +0,0 @@
-# Deploy — Déploiement en production
-
-Le module `deploy` permet de déployer des plugins, extensions (services), fichiers de configuration (.env, certificats…) et le fichier `integration.yaml` vers des serveurs distants via SSH/SFTP. Il supporte les sources **locales** et les **repos GitHub** (publics et privés), avec un système de hooks pre/post.
-
-## Quickstart
-
-```bash
-# 1. Scan automatique du projet (détecte plugins, extensions, integration.yaml)
-xcli deploy generate
-
-# 2. Éditer xcore-deploy.yaml (targets, tweaks)
-
-# 3. Simuler sans rien envoyer
-xcli deploy run production --dry-run
-
-# 4. Déployer
-xcli deploy run production
-```
-
----
-
-## Structure complète de `xcore-deploy.yaml`
-
-```yaml
-version: "1"
-
-# ── Serveurs ─────────────────────────────────────────────────────────────────
-targets:
-  production:
-    host: prod.monapp.com
-    port: 22
-    user: deploy
-    ssh_key: ~/.ssh/id_ed25519
-    xcore_url: https://api.monapp.com
-    xcore_token: "${XCORE_ADMIN_TOKEN}"
-    plugins_root: /opt/xcore/app/plugins
-    extensions_root: /opt/xcore/app/extensions
-
-  staging:
-    host: staging.monapp.com
-    user: deploy
-    ssh_key: ~/.ssh/id_ed25519
-    xcore_url: https://staging.monapp.com
-    xcore_token: "${XCORE_STAGING_TOKEN}"
-    plugins_root: /opt/xcore/app/plugins
-
-# ── Hooks globaux ─────────────────────────────────────────────────────────────
-hooks:
-  pre_deploy:
-    - cmd: "uv run xcli plugin security validate --save"
-    - cmd: "uv run pytest tests/ -x -q"
-      ignore_errors: false
-
-  post_deploy:
-    - cmd: "uv run xcli deploy status production"
-      ignore_errors: true
-
-# ── Config XCore (integration.yaml) ──────────────────────────────────────────
-integration:
-  source: ./integration.yaml
-  remote_path: /opt/xcore/integration.yaml
-  restart_xcore: true
-
-# ── Fichiers (config, .env, certificats) ──────────────────────────────────────
-# Copiés vers le serveur avant les extensions et plugins.
-files:
-  - source: ./.env
-    dest: /opt/xcore/.env
-    # only: [production]
-
-  - source: ./conf/private.pem
-    dest: /opt/xcore/conf/private.pem
-    only: [production]
-
-  - source: ./conf/public.pem
-    dest: /opt/xcore/conf/public.pem
-
-# ── Extensions (services) ─────────────────────────────────────────────────────
-extensions:
-  - name: mail
-    source: ./extensions/mail
-    restart: true
-    only: [production]
-
-  - name: pubsub
-    repo: https://github.com/org/xcore-pubsub
-    ref: v1.0.0
-    restart: true
-
-# ── Plugins ───────────────────────────────────────────────────────────────────
-plugins:
-  - name: auth
-    source: ./app/auth
-    sign: true
-    reload: true
-
-  - name: billing
-    repo: https://github.com/org/billing-plugin
-    ref: main
-    sign: true
-    reload: true
-
-  - name: pdf-generator
-    source: ./app/pdf-generator
-    reload: true
-    only: [production]
-    hooks:
-      pre_deploy:
-        - cmd: "uv run xcli plugin security validate ./app/pdf-generator"
-      post_deploy:
-        - cmd: "echo 'pdf-generator déployé'"
-          ignore_errors: true
-```
-
----
-
-## Section `files:` — Copie de fichiers
-
-Les fichiers déclarés dans `files:` sont copiés vers le serveur **avant** les extensions et plugins. Utile pour `.env`, certificats, fichiers de config, etc.
-
-```yaml
-files:
-  - source: ./.env
-    dest: /opt/xcore/.env
-  - source: ./conf/private.pem
-    dest: /opt/xcore/conf/private.pem
-    only: [production]
-  - source: ./config/prod.yaml
-    dest: /opt/xcore/config/prod.yaml
-```
-
-| Champ | Description |
-|---|---|
-| `source` | Chemin local du fichier (relatif à la racine du projet) |
-| `dest` | Chemin distant de destination |
-| `only` | (optionnel) Restreindre à certains targets |
-
----
-
-## Sources : local vs GitHub
-
-Chaque plugin et extension accepte soit `source:` (chemin local), soit `repo:` (dépôt Git).
-
-### Source locale
-
-```yaml
-plugins:
-  - name: mon-plugin
-    source: ./app/mon-plugin
-```
-
-### GitHub — repo public
-
-```yaml
-plugins:
-  - name: mon-plugin
-    repo: https://github.com/org/mon-plugin
-    ref: v2.1.0
-```
-
-### GitHub — repo privé via token
-
-```yaml
-plugins:
-  - name: mon-plugin
-    repo: https://github.com/org/mon-plugin-prive
-    ref: main
-    token: "${GITHUB_TOKEN}"
-```
-
-### GitHub — repo privé via SSH
-
-```yaml
-plugins:
-  - name: mon-plugin
-    repo: git@github.com:org/mon-plugin-prive.git
-    ref: main
-    # utilise ssh_key du target
-```
-
-### Plugin dans un sous-dossier du repo
-
-```yaml
-plugins:
-  - name: mon-plugin
-    repo: https://github.com/org/monorepo
-    ref: main
-    subdirectory: packages/mon-plugin
-```
-
-!!! note "Clone automatique"
-    xcli fait un `git clone --depth 1 --branch <ref>` dans un dossier temporaire, puis emballe et transfère le code. Le clone est supprimé après le déploiement.
-
----
-
-## Variables d'environnement
-
-Les valeurs `${VAR}` ou `{VAR}` dans le YAML sont interpolées depuis l'environnement système.
-
-```bash
-export XCORE_ADMIN_TOKEN="mon-token-secret"
-export XCORE_STAGING_TOKEN="staging-token"
-export GITHUB_TOKEN="ghp_..."
-export PROD_HOST="prod.monapp.com"
-```
-
----
-
-## Ordre d'exécution complet
-
-```
-hooks.pre_deploy (global)
-│
-├─ integration.yaml (si défini)
-│   → sftp integration.yaml
-│   → POST /config/reload  (ou restart service)
-│
-├─ Fichiers (section files:)
-│   → sftp chaque fichier
-│
-├─ Pour chaque extension :
-│   extension.hooks.pre_deploy
-│   → archive tar.gz
-│   → sftp + extraction
-│   → POST /services/{name}/restart
-│   extension.hooks.post_deploy
-│
-├─ Pour chaque plugin :
-│   plugin.hooks.pre_deploy
-│   → signature HMAC       (si sign: true)
-│   → archive tar.gz
-│   → sftp + extraction
-│   → POST /plugins/{name}/reload
-│   plugin.hooks.post_deploy
-│
-hooks.post_deploy (global)
-└─ Rapport tableau final
-```
-
----
-
-## Hooks
-
-### Niveau global
-
-Définis sous `hooks:` à la racine.
-
-| Moment | Quand |
-|---|---|
-| `hooks.pre_deploy` | Avant integration.yaml, fichiers, extensions et plugins |
-| `hooks.post_deploy` | Après tous les plugins |
-
-### Niveau plugin / extension
-
-Définis sous `plugins[].hooks` ou `extensions[].hooks`.
-
-| Moment | Quand |
-|---|---|
-| `pre_deploy` | Avant l'archivage |
-| `post_deploy` | Après le hot-reload / restart |
-
-### Options d'un hook
-
-```yaml
-hooks:
-  pre_deploy:
-    - cmd: "ma-commande --option valeur"
-      cwd: "./sous-dossier"     # répertoire d'exécution (défaut : racine projet)
-      ignore_errors: true       # continue même si exit code != 0 (défaut : false)
-```
-
-!!! warning "Hooks bloquants"
-    Par défaut (`ignore_errors: false`), un hook qui échoue **annule le déploiement**. Utilise `ignore_errors: true` pour les commandes non-critiques (notifications, rapports...).
-
----
-
-## Commandes
-
-### `xcli deploy generate`
-
-Scanne le projet et génère `xcore-deploy.yaml` automatiquement.
-
-Détecte les plugins (dossiers avec `plugin.yaml`), les extensions (`__init__.py`) et `integration.yaml`. Si le fichier existe déjà, les **targets et hooks sont conservés**.
-
-```bash
-xcli deploy generate
-xcli deploy generate --output deploy/prod.yaml
-xcli deploy generate --plugins-dir ./custom-plugins --dry-run
-```
-
-| Option | Description |
-|---|---|
-| `--output`, `-o` | Fichier de sortie (défaut: `xcore-deploy.yaml`) |
-| `--plugins-dir`, `-p` | Répertoire des plugins (défaut: `./app`) |
-| `--extensions-dir`, `-e` | Répertoire des extensions (défaut: `./extensions`) |
-| `--dry-run` | Affiche le résultat sans écrire le fichier |
-
----
-
-### `xcli deploy init`
-
-Génère un fichier `xcore-deploy.yaml` d'exemple complet.
-
-```bash
-xcli deploy init
-xcli deploy init --output deploy/prod.yaml
-```
-
----
-
-### `xcli deploy list`
-
-Liste les targets, plugins, extensions, fichiers et hooks déclarés.
-
-```bash
-xcli deploy list
-xcli deploy list --file deploy/prod.yaml
-```
-
----
-
-### `xcli deploy run <target>`
-
-Déploie l'intégralité (integration.yaml + fichiers + extensions + plugins) vers un target.
-
-```bash
-xcli deploy run production
-xcli deploy run staging
-```
-
-**Options :**
-
-| Option | Description |
-|---|---|
-| `--plugin <nom>` | Déploie **uniquement** ce plugin (skip extensions, fichiers et integration) |
-| `--dry-run` | Simule sans envoyer ni exécuter de commandes réelles |
-| `--no-reload` | Transfère les fichiers sans déclencher reload/restart |
-| `--file <chemin>` | Fichier de configuration alternatif |
-
-```bash
-# Déployer un seul plugin (skip extensions + fichiers + integration)
-xcli deploy run production --plugin auth
-
-# Simuler le déploiement complet
-xcli deploy run production --dry-run
-
-# Transférer sans redémarrer
-xcli deploy run production --no-reload
-
-# Fichier alternatif
-xcli deploy run production --file deploy/prod.yaml
-```
-
----
-
-### `xcli deploy copy <target> <source> <dest>`
-
-Copie un fichier vers un serveur distant via SFTP (sans passer par le déploiement complet).
-
-```bash
-xcli deploy copy production .env /opt/xcore/.env
-xcli deploy copy staging config.yaml /opt/xcore/config.yaml --dry-run
-xcli deploy copy production docker-compose.yml /opt/xcore/ --file deploy/prod.yaml
-```
-
----
-
-### `xcli deploy status <target>`
-
-Affiche l'état des plugins sur le serveur via l'API XCore.
-
-```bash
-xcli deploy status production
-xcli deploy status staging --file deploy/prod.yaml
-```
-
----
-
-## Dépendances requises
-
-```bash
-pip install paramiko   # SSH/SFTP
-pip install httpx      # Appels API XCore (reload/restart)
-# git doit être disponible dans le PATH pour les sources repo
-```
-
----
-
-## Exemples de hooks courants
-
-```yaml
-hooks:
-  pre_deploy:
-    - cmd: "uv run xcli plugin security validate --save"
-    - cmd: "uv run xcli plugin security validate --check-breaking"
-    - cmd: "uv run pytest tests/ -x -q"
-      ignore_errors: false
-
-  post_deploy:
-    - cmd: "uv run xcli deploy status production"
-    - cmd: >
-        curl -s -X POST https://hooks.slack.com/services/XXX
-        -H 'Content-type: application/json'
-        -d '{"text": "✅ Déploiement production terminé"}'
-      ignore_errors: true
-```