magicbox-dk 0.0.2.dev1__tar.gz → 1.0.0__tar.gz

magicbox_dk-1.0.0/.bumpversion.toml

@@ -0,0 +1,39 @@
+# bump-my-version configuration
+# Semantic Versioning : major.minor.patch — https://semver.org
+# Docs : https://callowayproject.github.io/bump-my-version/
+
+[tool.bumpversion]
+current_version = "1.0.0"
+
+allow_dirty = false                 # Require a clean working tree
+commit = true                  # Auto-commit the version bump
+tag = true                  # Auto-create the git tag
+sign_tags = true                 # GPG-sign the tag (git tag -s, uses user.signingkey)
+tag_name = "v{new_version}"      # e.g. v0.0.5
+
+# Plain major.minor.patch — no pre-release / build metadata.
+parse = '(?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)'
+serialize = ["{major}.{minor}.{patch}"]
+
+# --- Files kept in sync on every bump ------------------------------------
+
+# pyproject.toml : [project] version. (The bump-my-version config lives in
+# this separate file, so [project].version is NOT touched natively — this
+# explicit block matches the single unambiguous line.)
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+search = 'version = "{current_version}"'
+replace = 'version = "{new_version}"'
+
+# uv.lock : the editable magicbox-dk package entry.
+[[tool.bumpversion.files]]
+filename = "uv.lock"
+regex = true
+search = 'name = "magicbox-dk"\nversion = "{current_version}"'
+replace = 'name = "magicbox-dk"\nversion = "{new_version}"'
+
+# Usage:
+#   bump-my-version bump patch   # 0.0.4 -> 0.0.5
+#   bump-my-version bump minor   # 0.0.4 -> 0.1.0
+#   bump-my-version bump major   # 0.0.4 -> 1.0.0
+#   bump-my-version show-bump    # preview the next versions

{magicbox_dk-0.0.2.dev1 → magicbox_dk-1.0.0}/CLAUDE.md

@@ -42,7 +42,8 @@ The CLI is organized in thematic sub-packages — no flat catch-all. Each packag
   `INFRA_PORTS`/`INFRA_SCHEMES`/`INFRA_PATH_SUFFIXES`) AND user-configurable
   values (instance fields : `ports` — **uniquement** `frontend_host` (port hôte unique partagé Chainlit/Horizon) +
   `archetype_pool_start`/`_end` ;
-  `timeouts`, `docker`, `start`, `service_repos`, `env`, `surrealdb_logins`,
+  `timeouts`, `docker`, `start`, `logs` (champs affichés par `dk logs` — modèle `LogDisplay`, tous `True` par défaut ;
+  conteneur + message toujours affichés), `service_repos`, `env`, `surrealdb_logins`,
   `s3_accounts`). Type aliases `Mode`, `InfraMode`, `Section` and base class `_Strict` are exported here. Models `SurrealdbLogin` and `S3Account`
   (credentials profiles shared across profiles) live here too. `Settings.load(yaml_path)` / `Settings.save(yaml_path)` round-trip a snapshot of
   configurable fields to `<config_root>/settings.yaml`.
@@ -77,10 +78,12 @@ secrets, nettoyage des PID sur signaux.
 Point d'entrée : `from cli.runner import docker, git` (singletons).
 
 - `cli/runner/base.py` — `Cmd` (ABC) + `CmdError` + `CmdResult`.
-  `_run(args, *, timeout, check, capture, cwd, on_progress, progress_re)` avec 4 modes
+  `_run(args, *, timeout, check, capture, cwd, on_progress, progress_re, on_output, on_interrupt, on_line)` avec 4 modes
   de capture : `query` (capture stdout+stderr ; echo en debug), `drain` (thread drainer anti-deadlock), `pty` (
   pseudo-TTY pour la progression BuildKit,
-  POSIX ; fallback `drain` sur Windows), `inherit` (sortie directe, interactif).
+  POSIX ; fallback `drain` sur Windows), `inherit` (sortie directe, interactif). `on_line` (mode `drain`) : callback
+  **par ligne** au fil de l'eau, **sans** accumulation (mémoire bornée pour un flux non borné, ex. `logs --follow`
+  reformaté par `LogPrettifier`) ; préserve `drain` même en debug.
 - `cli/runner/binaries.py` — `resolve_binary(tool)` (candidats absolus par OS → `shutil.which` fallback, cache) +
   `sanitized_path(binary)`. Auto-détection
   seule (pas d'override settings).
@@ -118,7 +121,7 @@ Point d'entrée : `from cli.runner import docker, git` (singletons).
   schéma non autorisé). Primitives validées
   (`status_porcelain`, `head_branch`, `rev_list_counts`…, `clone`/`fetch`/`checkout`/`pull_ff`) **et** orchestration UI
   repliée depuis l'ancien `git_ops`
-  (`sync_repo`/`pull_repo`/`repo_status` + `RepoStatus`/`report_repo_statuses`). Consommé par `dk prepare`/`update`/
+  (`sync_repo`/`pull_repo`/`repo_status` + `RepoStatus`/`report_repo_statuses`). Consommé par `dk prepare`/`pull`/
   `start`.
 
 ### `cli/core/` — runtime state
@@ -176,7 +179,22 @@ All models inherit from `cli.settings._Strict` (one shared base with `extra="for
   `project_built_images`/`compose_config_images`/`container_restart_counts` (parsing des sorties docker), health
   snapshot, `wait_until_healthy`,
   `report_compose_failure` (masque les secrets via `cli.runner.redaction`), `compute_compose_env`/`compose_env_context`,
-  `follow_logs`/`dump_logs`.
+  `follow_logs`/`dump_logs` (branchent la surcouche `LogPrettifier` par défaut ; `raw=True` = sortie docker brute).
+- `cli/compose/logfmt.py` — `LogPrettifier` : **surcouche d'affichage** des logs Compose. Réassemble le JSON structuré
+  multi-lignes **par conteneur** (dé-multiplexage via les préfixes `<name> |` de `docker compose logs` ; parse en
+  `json.loads(strict=False)` — les tracebacks du champ `exception` ont de **vrais retours à la ligne**, JSON
+  techniquement
+  invalide). Le **nom du conteneur est toujours en tête** (façon `docker`), **padé à une largeur commune** (plafonnée) →
+  le `│` séparateur tombe à la **même colonne pour tous les conteneurs** et se répète en tête des lignes de
+  continuation.
+  Ligne principale (`conteneur │ heure · niveau · source sdk/module · module · fichier:ligne · fonction · extra` — méta
+  primaire ET secondaire), puis ligne(s) message **en gras** (JSON embarqué → indenté) et traceback (`│` de
+  continuation).
+  Le non-JSON (infra, watcher hot reload `dk-reload`/entrypoint en dev) est rendu au même format `conteneur │ texte`.
+  Colore par niveau ET par conteneur (couleur stable). Les champs (sauf conteneur/message) sont pilotés par
+  `settings.logs` (`LogDisplay`) — `dk settings → Logs`. Laisse passer le non-JSON (infra) en brut. Stateful : une
+  instance par flux, `feed(ligne)` branché sur le `on_line` du runner (cf. `Docker.compose_logs`), `flush()` en fin de
+  flux.
 - `cli/compose/network.py` — ports + allocators (`find_free_port`, `port_is_free`, `allocate_api_port`, `allocate_archetype_port`), Docker naming (
   `docker_safe_name`, `container_name`), Pydantic `Network`/`ServiceAddress`, `build_network`, `address_env_vars`, `reserved_var_names`,
   `write_network_yaml`/`read_network_yaml`. Constants from `Settings.ports`, the CLI-managed infra ClassVars (
@@ -205,7 +223,8 @@ the top of each menu :
 - `cli/editors/env.py` — `run_env_editor` (the `<entry>.yml` editor — 4 sections, secret masking, Jinja resolution
   preview, network
   read-only). Keyboard shortcuts a/g/i/d/D/r/?/h/b/Esc preserved.
-- `cli/editors/settings.py` — `SettingsEditor(ctx).run()` covers Env globales, Start defaults, Ports, Timeouts, Docker, Infra. All editable via menus,
+- `cli/editors/settings.py` — `SettingsEditor(ctx).run()` covers Env globales, Start defaults, Logs (champs affichés par
+  `dk logs`), Ports, Timeouts, Docker, Infra. All editable via menus,
   persisted via `ctx.save_settings()`.
 - `cli/editors/_state.py` — internal helpers shared by editors (`_PendingEnv`, `_fmt_value`, diff utilities).
 
@@ -238,16 +257,16 @@ class DeleteCommand(BaseCommand):
 `cli` est **l'unique méthode publique** : elle construit l'instance depuis la CLI
 et déclenche `_dispatch()` (le cycle de vie partagé). `BaseCommand` fournit un
 **`cli` par défaut** (classmethod `cls()._dispatch()`) : une commande **sans
-argument** (`version`, `dashboard`, `settings`) ne redéfinit pas `cli`, elle
+argument** (`dashboard`, `settings`) ne redéfinit pas `cli`, elle
 hérite du défaut (on passe `help=` au montage pour garder une description
-distincte : `app.command("version", help="…")(VersionCommand.cli)`). Toute
+distincte : `app.command("dashboard", help="…")(DashboardCommand.cli)`). Toute
 commande avec arguments/options **redéfinit** `cli` en `@staticmethod` typée.
 
 - `cli/commands/_base.py` — `BaseCommand` (ABC). Cycle de vie via attributs de
   classe surchargeables : `requires_profile` (bootstrap vs bootstrap_no_profile),
   `require_existing`, `require_prepared`, `requires_init` (False ⇒ pas de
   `require_initialized`, ex. `init`/`dashboard`/`doctor`), `loads_context`
-  (False ⇒ aucun contexte, ex. `version`). `_dispatch()` fait le préambule +
+  (False ⇒ aucun contexte, ex. `update`). `_dispatch()` fait le préambule +
   `run()`, et enveloppe `run()` d'une **frontière `CmdError`** (échec d'une
   commande externe `check=True` → panneau d'erreur, sortie déjà masquée).
   Helpers : `fail(msg, code=, cause=)`, `confirm(msg, yes=)`,
@@ -293,12 +312,14 @@ Verbs (with aliases) :
 | `list, ls`                  | List profiles (`--json` supported).                                                        |
 | `show, info [profile]`      | Compact profile config view (`--json` supported).                                          |
 | `status, stats, ps`         | Container state, section by section.                                                       |
-| `logs [service]`            | `docker compose logs`.                                                                     |
+| `logs [service]`            | `docker compose logs` reformatés/colorés (JSON structuré → 2 lignes) ; `--raw` = brut.     |
 | `shell, exec <service>`     | `docker exec -it` into a container of the active profile.                                  |
-| `update [name...]`          | `git pull --ff-only` on clones of the active profile.                                      |
+| `pull, sync [name...]`      | `git pull --ff-only` on clones of the active profile.                                      |
 | `validate [profile]`        | Validate YAML (Pydantic), no side effects.                                                 |
 | `doctor`                    | Check Docker, Compose, git, user structure.                                                |
-| `version`                   | Print Magicbox version.                                                                    |
+| `update [--check]`          | Update the CLI itself (`magicbox-dk`) from PyPI.                                           |
+
+The root `dk --version` (`-V`) prints the current CLI version and exits (there is no `version` sub-command).
 
 The entrypoint `dk = "cli.main:app"` is declared in `pyproject.toml`.
 

{magicbox_dk-0.0.2.dev1 → magicbox_dk-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: magicbox-dk
-Version: 0.0.2.dev1
+Version: 1.0.0
 Summary: Magicbox for help DigitalKin developpers.
 Author-email: Alexandre TRESALLET <a.tresall@digitalkin.ai>
 License-Expression: MIT
@@ -41,6 +41,7 @@ stack — le tout stocké hors du repo, dans le dossier de config standard de vo
 - [Settings, globals & credentials](#settings-globals--credentials)
 - [Multi-profils](#multi-profils)
 - [Auth git](#auth-git)
+- [Versioning & release](#versioning--release)
 - [Dépannage](#dépannage)
 - [License](#license)
 
@@ -304,6 +305,66 @@ Magicbox délègue l'authentification au système : configurez votre credential
 
 ---
 
+## Versioning & release
+
+Le versionnage suit **PEP 440** : `major.minor.patch` avec un pré-release `.devN` optionnel,
+piloté par [`bump-my-version`](https://github.com/callowayproject/bump-my-version) (config dans
+`.bumpversion.toml`). Chaque `bump` met à jour `pyproject.toml` **et** `uv.lock`, puis **commit +
+tag** automatiquement (`commit = true`, `tag = true`).
+
+> Le binaire Homebrew de `bump-my-version` peut être cassé (interpréteur Python obsolète) —
+> préfixe les commandes par `uv run` pour utiliser celui du venv.
+
+**Règle d'or** : un `.devN` est toujours un pré-release de la **prochaine** version pas encore
+sortie (`0.0.2.dev1 < 0.0.2`). La base `major.minor.patch` ne fait que **monter** — on ne colle
+jamais un `.dev` sur une version déjà publiée.
+
+### Les cas
+
+| Cas                                           | Commande                           | Exemple                     |
+|-----------------------------------------------|------------------------------------|-----------------------------|
+| **Ouvrir un cycle dev** (depuis une finale)   | `bump patch` \| `minor` \| `major` | `0.0.1` → `0.0.2.dev1`      |
+| **Itérer en dev**                             | `bump dev`                         | `0.0.2.dev1` → `0.0.2.dev2` |
+| **Passer d'une dev à la release** (finaliser) | `bump --new-version X.Y.Z`         | `0.0.2.dev2` → `0.0.2`      |
+
+> `bump dev` depuis une **finale** échoue (`value 0 is lower than the first value 1`) : c'est voulu
+> (`first_value = 1`). Depuis une finale, on ouvre le cycle avec `patch`/`minor`/`major`, jamais `dev`.
+> Et « finaliser » (retirer le `.dev`) se fait avec `--new-version`, car un compteur `.dev` ne peut
+> pas redescendre à 0 tout seul.
+
+### Procédure complète (pour chaque version)
+
+```bash
+# 1. bump : édite pyproject.toml + uv.lock, commit + tag automatiques
+uv run bump-my-version bump patch          # 0.0.1 → 0.0.2.dev1
+
+# 2. pousse le commit ET son tag
+git push --follow-tags origin main
+
+# 3. crée la GitHub Release → déclenche la publication (.github/workflows/release.yml)
+gh release create v0.0.2.dev1 --prerelease --generate-notes   # --prerelease pour un .dev
+```
+
+Exemple d'un cycle complet `0.0.1 → 0.0.2` :
+
+```bash
+uv run bump-my-version bump patch            # 0.0.1 → 0.0.2.dev1
+git push --follow-tags origin main
+gh release create v0.0.2.dev1 --prerelease --generate-notes
+
+uv run bump-my-version bump dev              # 0.0.2.dev1 → 0.0.2.dev2
+git push --follow-tags origin main
+gh release create v0.0.2.dev2 --prerelease --generate-notes
+
+uv run bump-my-version bump --new-version 0.0.2   # finalise : 0.0.2.dev2 → 0.0.2
+git push --follow-tags origin main
+gh release create v0.0.2 --generate-notes    # release finale (sans --prerelease)
+```
+
+`bump-my-version show-bump` affiche à tout moment les transitions possibles depuis la version courante.
+
+---
+
 ## Dépannage
 
 | Symptôme                      | Remède                                                                       |

{magicbox_dk-0.0.2.dev1 → magicbox_dk-1.0.0}/README.md

@@ -24,6 +24,7 @@ stack — le tout stocké hors du repo, dans le dossier de config standard de vo
 - [Settings, globals & credentials](#settings-globals--credentials)
 - [Multi-profils](#multi-profils)
 - [Auth git](#auth-git)
+- [Versioning & release](#versioning--release)
 - [Dépannage](#dépannage)
 - [License](#license)
 
@@ -287,6 +288,66 @@ Magicbox délègue l'authentification au système : configurez votre credential
 
 ---
 
+## Versioning & release
+
+Le versionnage suit **PEP 440** : `major.minor.patch` avec un pré-release `.devN` optionnel,
+piloté par [`bump-my-version`](https://github.com/callowayproject/bump-my-version) (config dans
+`.bumpversion.toml`). Chaque `bump` met à jour `pyproject.toml` **et** `uv.lock`, puis **commit +
+tag** automatiquement (`commit = true`, `tag = true`).
+
+> Le binaire Homebrew de `bump-my-version` peut être cassé (interpréteur Python obsolète) —
+> préfixe les commandes par `uv run` pour utiliser celui du venv.
+
+**Règle d'or** : un `.devN` est toujours un pré-release de la **prochaine** version pas encore
+sortie (`0.0.2.dev1 < 0.0.2`). La base `major.minor.patch` ne fait que **monter** — on ne colle
+jamais un `.dev` sur une version déjà publiée.
+
+### Les cas
+
+| Cas                                           | Commande                           | Exemple                     |
+|-----------------------------------------------|------------------------------------|-----------------------------|
+| **Ouvrir un cycle dev** (depuis une finale)   | `bump patch` \| `minor` \| `major` | `0.0.1` → `0.0.2.dev1`      |
+| **Itérer en dev**                             | `bump dev`                         | `0.0.2.dev1` → `0.0.2.dev2` |
+| **Passer d'une dev à la release** (finaliser) | `bump --new-version X.Y.Z`         | `0.0.2.dev2` → `0.0.2`      |
+
+> `bump dev` depuis une **finale** échoue (`value 0 is lower than the first value 1`) : c'est voulu
+> (`first_value = 1`). Depuis une finale, on ouvre le cycle avec `patch`/`minor`/`major`, jamais `dev`.
+> Et « finaliser » (retirer le `.dev`) se fait avec `--new-version`, car un compteur `.dev` ne peut
+> pas redescendre à 0 tout seul.
+
+### Procédure complète (pour chaque version)
+
+```bash
+# 1. bump : édite pyproject.toml + uv.lock, commit + tag automatiques
+uv run bump-my-version bump patch          # 0.0.1 → 0.0.2.dev1
+
+# 2. pousse le commit ET son tag
+git push --follow-tags origin main
+
+# 3. crée la GitHub Release → déclenche la publication (.github/workflows/release.yml)
+gh release create v0.0.2.dev1 --prerelease --generate-notes   # --prerelease pour un .dev
+```
+
+Exemple d'un cycle complet `0.0.1 → 0.0.2` :
+
+```bash
+uv run bump-my-version bump patch            # 0.0.1 → 0.0.2.dev1
+git push --follow-tags origin main
+gh release create v0.0.2.dev1 --prerelease --generate-notes
+
+uv run bump-my-version bump dev              # 0.0.2.dev1 → 0.0.2.dev2
+git push --follow-tags origin main
+gh release create v0.0.2.dev2 --prerelease --generate-notes
+
+uv run bump-my-version bump --new-version 0.0.2   # finalise : 0.0.2.dev2 → 0.0.2
+git push --follow-tags origin main
+gh release create v0.0.2 --generate-notes    # release finale (sans --prerelease)
+```
+
+`bump-my-version show-bump` affiche à tout moment les transitions possibles depuis la version courante.
+
+---
+
 ## Dépannage
 
 | Symptôme                      | Remède                                                                       |

{magicbox_dk-0.0.2.dev1 → magicbox_dk-1.0.0}/cli/commands/_base.py

@@ -21,6 +21,7 @@ est délégué à :class:`cli.ui.StepReporter` exposé via ``self.steps``.
 from __future__ import annotations
 
 import itertools
+import sys
 import threading
 import time
 from abc import ABC, abstractmethod
@@ -32,6 +33,7 @@ from typing import Annotated, Any, NoReturn, TypeVar
 import questionary
 import typer
 
+from cli import version_check
 from cli.core.cmd import bootstrap, bootstrap_no_profile, resolve_target
 from cli.core.context import MagicboxContext
 from cli.debug import dlog, set_debug, set_verbose
@@ -77,6 +79,10 @@ class BaseCommand(ABC):
     #: commandes « profil courant » (``start``/``edit``/``prepare``…) gardent
     #: ``False`` (défaut → profil actif, pas de prompt).
     picks_profile: bool = False
+    #: ``True`` ⇒ affiche (sur stderr, TTY uniquement) une ligne d'info si une
+    #: version plus récente est publiée sur PyPI. Désactivé sur ``version`` (qui
+    #: l'affiche à sa façon) et ``update`` (c'est déjà la mise à jour du CLI).
+    notifies_upgrade: bool = True
 
     def __init__(
             self, profile: str | None = None, *,
@@ -119,6 +125,13 @@ class BaseCommand(ABC):
         # Verbose déroule le détail des étapes (cf. ``-v/--verbose``) — posé avant
         # tout pour couvrir aussi le préambule. ``set_debug`` est géré par bootstrap.
         set_verbose(self.verbose)
+        # Vérif de version : uniquement en terminal interactif (jamais en
+        # script/CI/pipe). Le rafraîchissement du cache est lancé en tâche de
+        # fond ici (max de temps pour finir pendant `run`) ; la notice, lue au
+        # cache, est affichée après un `run` réussi.
+        notify_upgrade = self.notifies_upgrade and sys.stderr.isatty()
+        if notify_upgrade:
+            version_check.trigger_background_refresh()
         if self.requires_profile:
             self.ctx, self.profile_id = bootstrap(
                 self.profile_name,
@@ -140,6 +153,10 @@ class BaseCommand(ABC):
 
         try:
             self.run()
+            if notify_upgrade:
+                notice = version_check.notice_if_outdated()
+                if notice:
+                    typer.secho(notice, fg=typer.colors.YELLOW, err=True)
         except CmdError as exc:
             # Échec d'une commande externe en mode ``check=True`` (git/docker).
             # ``exc.output`` est déjà masqué des secrets par le runner.
@@ -151,7 +168,13 @@ class BaseCommand(ABC):
             # sous-process encore vivants, puis on indique CLAIREMENT ce qui s'est
             # passé (l'utilisateur ne doit pas se demander si ça tourne en fond).
             process.terminate_all(grace=2.0)
-            self.steps.panel_warn("Interrompu", self._interrupt_note())
+            # Le terminal a échoté ``^C`` à la position du curseur : on efface la
+            # ligne courante (retour chariot + clear) avant le panneau, sinon son
+            # cadre est décalé de 2 colonnes (TTY uniquement).
+            if sys.stdout.isatty():
+                sys.stdout.write("\r\033[K")
+                sys.stdout.flush()
+            self._render_interrupt()
             raise typer.Exit(code=130) from None
 
     @abstractmethod
@@ -169,6 +192,15 @@ class BaseCommand(ABC):
         """
         return None
 
+    def _render_interrupt(self) -> None:
+        """Panneau affiché sur Ctrl+C. Par défaut : ``⚠ Interrompu`` (jaune) + note.
+
+        Surchargeable pour changer le ton (titre / couleur / détail). Ex. ``dk
+        logs`` où Ctrl+C est la fermeture **volontaire** du flux : un panneau
+        neutre sans note suffit (cf. ``LogsCommand._render_interrupt``).
+        """
+        self.steps.panel_warn("Interrompu", self._interrupt_note())
+
     def resolve_target(self) -> str:
         """Résout le profil ciblé pour une commande à résolution manuelle.
 

{magicbox_dk-0.0.2.dev1 → magicbox_dk-1.0.0}/cli/commands/dashboard.py

@@ -14,9 +14,9 @@ import typer
 import yaml
 
 from cli.commands._base import BaseCommand
-from cli.commands.version import package_version
 from cli.core.context import MagicboxContext
 from cli.ui import GREY_FG, Report, short_home_path
+from cli.version_check import current_version
 
 # Sous-commandes mises en avant dans le mémo de démarrage (verbe → résumé).
 QUICK_COMMANDS: tuple[tuple[str, str], ...] = (
@@ -42,7 +42,7 @@ class DashboardCommand(BaseCommand):
         # ── En-tête : titre + description ─────────────────────────────────── #
         r.blank()
         title = typer.style("Magicbox", fg=typer.colors.CYAN, bold=True)
-        ver = typer.style(f"v{package_version()}", fg=GREY_FG)
+        ver = typer.style(f"v{current_version()}", fg=GREY_FG)
         typer.echo(f"  {title}  ·  {ver}")
         r.detail(
             "Orchestrateur d'environnements de dev pour les services & archetypes DigitalKin.",

{magicbox_dk-0.0.2.dev1 → magicbox_dk-1.0.0}/cli/commands/logs.py

@@ -35,14 +35,18 @@ class LogsCommand(BaseCommand):
             services: list[str] | None = None,
             follow: bool = True,
             tail: int = 0,
+            raw: bool = False,
             debug: bool = False,
     ) -> None:
         super().__init__(profile, profile_id=profile_id, debug=debug)
         self.services = list(services or [])
         self.follow = follow
         self.tail = tail
+        self.raw = raw
 
     def run(self) -> None:
+        from cli.compose.logfmt import LogPrettifier
+
         profile = load_profile(self.ctx, self.profile_id)
 
         # Rien fourni en argument : sur un terminal interactif, on ouvre un
@@ -55,18 +59,33 @@ class LogsCommand(BaseCommand):
                 typer.echo("Annulé.")
                 return
 
+        # Surcouche lisible par défaut ; ``--raw`` rend la sortie docker brute.
+        # Les champs affichés suivent ``settings.logs`` (dk settings → Logs).
+        prettifier = None if self.raw else LogPrettifier(self.ctx.settings.logs)
+        on_line = prettifier.feed if prettifier is not None else None
+
         project = self.ctx.compose_project(self.profile_id)
         files, profiles = compose_args_for(
             profile, self.ctx.paths.profile_overrides_dir(self.profile_id),
         )
         compose_env = compute_compose_env(self.ctx, profile, self.profile_id)
-        with compose_env_context(compose_env):
-            docker.compose_logs(
-                project, files, profiles,
-                follow=self.follow,
-                tail=self.tail if self.tail > 0 else None,
-                services=services or None,
-            )
+        try:
+            with compose_env_context(compose_env):
+                docker.compose_logs(
+                    project, files, profiles,
+                    follow=self.follow,
+                    tail=self.tail if self.tail > 0 else None,
+                    services=services or None,
+                    on_line=on_line,
+                )
+        finally:
+            if prettifier is not None:
+                prettifier.flush()
+
+    def _render_interrupt(self) -> None:
+        # Ctrl+C sur `dk logs` = fermeture volontaire du flux, pas un incident :
+        # panneau neutre « Interrompu » sans description (couleur ≠ jaune d'alerte).
+        self.steps.panel_info("Interrompu")
 
     @staticmethod
     def cli(
@@ -95,12 +114,19 @@ class LogsCommand(BaseCommand):
                 int,
                 typer.Option("--tail", "-n", help="Lignes depuis la fin."),
             ] = 0,
+            raw: Annotated[
+                bool,
+                typer.Option("--raw", help="Sortie docker brute (désactive la mise en forme lisible)."),
+            ] = False,
             debug: Annotated[
                 bool,
                 typer.Option("--debug", "-d", help="Logs détaillés."),
             ] = False,
     ) -> None:
-        """Suit les logs Compose du profil.
+        """Suit les logs Compose du profil, reformatés pour la lisibilité.
+
+        Les logs JSON structurés des modules sont recomposés en deux lignes
+        (méta colorée + message) ; ``--raw`` rend la sortie docker brute.
 
         ``dk logs`` sans argument ouvre un menu multi-sélection des services
         (ou « Tous ») sur un terminal interactif. ``dk logs back node-service-provider``
@@ -108,7 +134,7 @@ class LogsCommand(BaseCommand):
         """
         LogsCommand(
             profile_name, profile_id=profile_id, services=services, follow=follow,
-            tail=tail, debug=debug,
+            tail=tail, raw=raw, debug=debug,
         )._dispatch()