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

{magicbox_dk-0.0.2.dev1 → magicbox_dk-0.0.3}/.bumpversion.toml

@@ -3,11 +3,11 @@
 # https://peps.python.org/pep-0440/
 
 [tool.bumpversion]
-current_version = "0.0.2.dev1"
+current_version = "0.0.3"
 
 allow_dirty = false # Require clean working directory
-commit = false # Don't auto-commit (let user control git)
-tag = true
+commit = true  # Auto-commit the version bump
+tag = true     # Auto-create the git tag (v{new_version})
 sign_tags = false # Don't sign tags
 
 # major.minor.patch with an optional `.devN` pre-release.

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

@@ -118,7 +118,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
@@ -238,16 +238,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=)`,
@@ -295,10 +295,12 @@ Verbs (with aliases) :
 | `status, stats, ps`         | Container state, section by section.                                                       |
 | `logs [service]`            | `docker compose logs`.                                                                     |
 | `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-0.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: magicbox-dk
-Version: 0.0.2.dev1
+Version: 0.0.3
 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-0.0.3}/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-0.0.3}/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.

{magicbox_dk-0.0.2.dev1 → magicbox_dk-0.0.3}/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-0.0.3}/cli/commands/prepare.py

@@ -46,7 +46,9 @@ from cli.compose import (
     generate_horizon_compose,
     generate_node_compose,
     generate_nsp_compose,
+    plan_build,
     report_compose_failure,
+    save_manifest,
 )
 from cli.compose.network import (
     AllocatedPorts,
@@ -272,6 +274,7 @@ class PrepareCommand(StepCommand):
         self.project = self.ctx.compose_project(self.profile_id)
         self.repos_dir = self.ctx.profile_repos_dir(self.profile_id)
         self.overrides_dir = self.ctx.profile_overrides_dir(self.profile_id)
+        self.manifest_path = self.ctx.profile_build_manifest(self.profile_id)
         self.env_dir = self.ctx.profile_env_dir(self.profile_id)
         self.network_path = self.ctx.profile_network_yaml(self.profile_id)
         self.settings_ports = self.ctx.settings.ports
@@ -290,6 +293,7 @@ class PrepareCommand(StepCommand):
         self.infra_vars: dict[str, str] = {}
         self.build_failed = False
         self.build_result: Any = None
+        self.build_plan: Any = None  # cli.compose.BuildPlan | None (rempli au build)
 
         self.steps.section(f"Profil : {self.ctx.profile_name(self.profile_id)}")
 
@@ -816,11 +820,36 @@ class PrepareCommand(StepCommand):
     def prebuild_images(self) -> None:
         files, profiles = compose_args_for(self.profile, self.overrides_dir)
         build_env = compute_compose_env(self.ctx, self.profile, self.profile_id)
+        # Rebuild incrémental : on ne (re)construit que les images dont un input
+        # de build a changé (build args, HEAD du dépôt, Dockerfile, image
+        # absente, contexte dev dirty). Cf. `cli.compose.build_state`. Le calcul
+        # du plan lit `docker compose config` → sous le même env que le build.
+        with compose_env_context(build_env):
+            plan = plan_build(
+                self.project, files, profiles, self.manifest_path, force=self.force,
+            )
+        self.build_plan = plan
+
+        if plan.nothing_to_do:
+            # Toutes les images sont à jour : aucun `docker compose build` lancé.
+            self.steps.set_activity("images à jour — aucun rebuild")
+            return
+
+        if plan.degraded:
+            # Config compose illisible : repli sûr = tout reconstruire.
+            services: list[str] = []
+        else:
+            services = plan.to_build
+            self.steps.set_activity(
+                f"reconstruction de {len(services)} image(s) : {', '.join(services)}",
+            )
+
         # Le viewer affiche la progression BuildKit + un rappel de touche, et
         # permet d'expand/collapse la sortie Docker complète (touche ``o``/espace).
         with compose_env_context(build_env), _BuildOutputViewer(self.steps) as viewer:
             result = docker.compose_build(
                 self.project, files, profiles,
+                services=services,
                 no_cache=self.force,
                 on_progress=viewer.feed_progress,
                 on_output=viewer.feed_output,
@@ -831,6 +860,10 @@ class PrepareCommand(StepCommand):
             # l'échec et ``finish()`` affiche l'extrait borné hors panneau.
             self.build_failed = True
             self.build_result = result
+        elif not plan.degraded:
+            # Build réussi : on fige les signatures courantes (celles des services
+            # skippés matchent déjà, celles des reconstruits sont désormais à jour).
+            save_manifest(self.manifest_path, plan.signatures)
 
     # ── Panneau final ────────────────────────────────────────────────────── #
 
@@ -848,7 +881,25 @@ class PrepareCommand(StepCommand):
                 "`dk start` re-tentera le build au démarrage",
             )
         else:
-            self.steps.panel_ok(f"Profil « {label} » préparé", "Étape suivante : dk start")
+            detail = "\n".join(
+                d for d in ("Étape suivante : dk start", self._build_summary()) if d
+            )
+            self.steps.panel_ok(f"Profil « {label} » préparé", detail)
+
+    def _build_summary(self) -> str | None:
+        """Résumé du rebuild incrémental (images reconstruites vs à jour)."""
+        plan = self.build_plan
+        if plan is None or self.no_build:
+            return None
+        if plan.degraded:
+            return "Build : plan incrémental indisponible — toutes les images (re)construites."
+        if not plan.to_build:
+            return f"Build : {len(plan.skipped)} image(s) déjà à jour — aucun rebuild."
+        built = ", ".join(plan.to_build)
+        line = f"Build : {len(plan.to_build)} image(s) reconstruite(s) ({built})"
+        if plan.skipped:
+            line += f" · {len(plan.skipped)} à jour (skip)"
+        return line
 
     # ── Helpers (tout dans la classe) ────────────────────────────────────── #
 

magicbox_dk-0.0.2.dev1/cli/commands/update.py → magicbox_dk-0.0.3/cli/commands/pull.py

@@ -1,4 +1,4 @@
-"""dk update — git pull --ff-only sur les clones du profil actif."""
+"""dk pull — git pull --ff-only sur les clones du profil actif."""
 
 from __future__ import annotations
 
@@ -15,7 +15,7 @@ from cli.models.profile import runnable_entries
 from cli.runner import git
 
 
-class UpdateCommand(StepCommand):
+class PullCommand(StepCommand):
     """git pull --ff-only sur les clones du profil actif.
 
     Chaque clone est mis à jour comme une étape numérotée ``[i/N] <repo>`` sous
@@ -23,7 +23,7 @@ class UpdateCommand(StepCommand):
     est capturé en mode collapse, déroulé en verbose/non-TTY.
     """
 
-    command_label = "Mise à jour en cours"
+    command_label = "Récupération des dépôts (git pull)"
 
     def __init__(
             self, names: list[str] | None = None, *,
@@ -93,4 +93,4 @@ class UpdateCommand(StepCommand):
             ] = False,
     ) -> None:
         """git pull --ff-only sur les clones du profil actif."""
-        UpdateCommand(names, debug=debug, verbose=verbose)._dispatch()
+        PullCommand(names, debug=debug, verbose=verbose)._dispatch()

{magicbox_dk-0.0.2.dev1 → magicbox_dk-0.0.3}/cli/commands/start.py

@@ -435,10 +435,11 @@ class StartCommand(StepCommand):
         la progression (lancement puis état par service) alimente le panneau Live
         de la commande (``set_activity`` / ``set_detail``).
         """
-        # Budget santé = valeur LIVE des settings (``timeouts.health_wait_s``),
-        # décompté **dès le lancement** des conteneurs (``started_at`` ici, avant
-        # le ``compose up``) — pas à partir du moment où le front devient healthy.
-        # Ainsi le décompte affiché en phase 2 est déjà « pris en cours de route ».
+        # Budget santé = valeur LIVE des settings (``timeouts.health_wait_s``).
+        # ``started_at`` (avant le ``compose up``) ancre le **plafond global**
+        # tant que le frontend n'est pas healthy. Le **décompte de skip** affiché
+        # en phase 2 est, lui, ré-ancré à l'instant où le front devient healthy et
+        # part donc de ``health_wait_s`` plein (cf. ``wait_until_healthy``).
         started_at = time.monotonic()
         health_timeout = self.ctx.settings.timeouts.health_wait_s
         if is_debug():

magicbox_dk-0.0.3/cli/commands/update.py

@@ -0,0 +1,140 @@
+"""dk update — met à jour le package ``magicbox-dk`` depuis PyPI."""
+
+from __future__ import annotations
+
+import json
+import shutil
+import subprocess
+import sys
+from importlib.metadata import distribution
+from typing import Annotated
+
+import typer
+
+from cli.commands._base import BaseCommand
+from cli.ui import spinner
+from cli.version_check import PACKAGE, current_version, fetch_latest
+
+
+def _is_editable_install() -> bool:
+    """Vrai si ``magicbox-dk`` est installé en mode éditable (``pip install -e``).
+
+    On lit ``direct_url.json`` (PEP 610) de la distribution : les installs
+    éditables portent ``dir_info.editable = true``. Sert à **refuser** l'upgrade
+    dans un checkout de dev — sinon un ``pip install --upgrade`` remplacerait le
+    lien éditable par la release PyPI et casserait l'environnement de travail.
+    """
+    try:
+        raw = distribution(PACKAGE).read_text("direct_url.json")
+        if not raw:
+            return False
+        return bool(json.loads(raw).get("dir_info", {}).get("editable"))
+    except (OSError, ValueError, ImportError):
+        return False
+
+
+def _upgrade_argv() -> tuple[list[str], str]:
+    """``(argv, méthode)`` pour mettre à jour selon le mode d'installation.
+
+    Détecte pipx / uv-tool via le préfixe d'environnement (ces gestionnaires
+    isolent le CLI dans un venv dédié où ``pip install`` ne conviendrait pas) ;
+    sinon retombe sur ``python -m pip install --upgrade`` de l'interpréteur
+    courant (cas pip / venv classique).
+    """
+    prefix = sys.prefix.replace("\\", "/").lower()
+    pipx = shutil.which("pipx")
+    if "/pipx/" in prefix and pipx:
+        return [pipx, "upgrade", PACKAGE], "pipx"
+    uv = shutil.which("uv")
+    if "/uv/tools/" in prefix and uv:
+        return [uv, "tool", "upgrade", PACKAGE], "uv tool"
+    return [sys.executable, "-m", "pip", "install", "--upgrade", PACKAGE], "pip"
+
+
+class UpdateCommand(BaseCommand):
+    """Met à jour Magicbox vers la dernière version publiée sur PyPI."""
+
+    requires_profile = False
+    requires_init = False
+    loads_context = False
+    notifies_upgrade = False  # c'est déjà la commande de mise à jour
+
+    def __init__(self, *, check: bool = False, debug: bool = False) -> None:
+        super().__init__(debug=debug)
+        self.check = check
+
+    def run(self) -> None:
+        current = current_version()
+        self.steps.section(f"Magicbox {current}")
+
+        with spinner("Recherche d'une version plus récente sur PyPI…"):
+            latest = fetch_latest()
+        if latest is None:
+            self.steps.warn("Impossible de contacter PyPI — réessaie plus tard.")
+            return
+
+        if not self._is_newer(current, latest):
+            self.steps.ok(f"déjà à jour (dernière version : {latest})")
+            return
+
+        self.steps.info(f"version {latest} disponible (installée : {current})")
+        if self.check:
+            self.steps.info("lance `dk update` (sans `--check`) pour l'installer")
+            return
+
+        if _is_editable_install():
+            self.steps.warn(
+                "Installation éditable (dépôt de dev) détectée — upgrade désactivé "
+                "pour ne pas écraser ton checkout.",
+                "Mets à jour via `git pull` dans le dépôt.",
+            )
+            return
+
+        argv, method = _upgrade_argv()
+        self.steps.info(f"mise à jour via {method}…")
+        # Sortie de l'installeur héritée directement (progression pip/uv en direct).
+        result = subprocess.run(argv, check=False)  # noqa: S603 (argv construit en interne)
+        if result.returncode == 0:
+            self.steps.panel_ok(
+                f"Magicbox mis à jour vers {latest}",
+                "relance une commande `dk` pour utiliser la nouvelle version",
+            )
+        else:
+            self.fail(
+                f"Échec de la mise à jour (code {result.returncode}). "
+                f"Essaie manuellement : {' '.join(argv)}",
+            )
+
+    @staticmethod
+    def _is_newer(current: str, latest: str) -> bool:
+        """Vrai si ``latest`` est strictement plus récent que ``current`` (PEP 440).
+
+        Sans ``packaging`` ou avec une version courante non standard (``dev`` /
+        install source), on renvoie ``True`` par défaut : l'utilisateur a lancé
+        ``dk update`` explicitement, on ne le bloque pas sur une comparaison
+        impossible (le garde-fou install-éditable protège déjà le cas dev).
+        """
+        if current == latest:
+            return False
+        try:
+            from packaging.version import InvalidVersion, Version
+        except ImportError:
+            return True
+        try:
+            return Version(latest) > Version(current)
+        except InvalidVersion:
+            return True
+
+    @staticmethod
+    def cli(
+            check: Annotated[
+                bool,
+                typer.Option("--check", help="Vérifie seulement (sans installer) s'il y a une mise à jour."),
+            ] = False,
+            debug: Annotated[
+                bool,
+                typer.Option("--debug", "-d", help="Logs détaillés."),
+            ] = False,
+    ) -> None:
+        """Met à jour Magicbox vers la dernière version publiée sur PyPI."""
+        UpdateCommand(check=check, debug=debug)._dispatch()

{magicbox_dk-0.0.2.dev1 → magicbox_dk-0.0.3}/cli/compose/__init__.py

@@ -23,6 +23,12 @@ le port pré-alloué par ``dk prepare`` : ils ne consultent plus les endpoints.
 
 from __future__ import annotations
 
+# ── Rebuild incrémental des images ──────────────────────────────────────────── #
+from cli.compose.build_state import (
+    BuildPlan,
+    plan_build,
+    save_manifest,
+)
 # ── Builder (génération d'overrides) ────────────────────────────────────────── #
 from cli.compose.builder import (
     generate_back_compose,
@@ -63,6 +69,7 @@ from cli.compose.runtime import (
 )
 
 __all__ = [
+    "BuildPlan",
     "RESTART_LIMIT",
     "allocate_back_port",
     "allocate_back_worker_port",
@@ -88,8 +95,10 @@ __all__ = [
     "generate_nsp_compose",
     "magicbox_container_publishing",
     "magicbox_orphan_resources",
+    "plan_build",
     "project_built_images",
     "report_compose_failure",
     "running_compose_projects",
+    "save_manifest",
     "wait_until_healthy",
 ]