arclith-cli 0.20.0__tar.gz → 0.22.0__tar.gz

{arclith_cli-0.20.0 → arclith_cli-0.22.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: arclith-cli
-Version: 0.20.0
+Version: 0.22.0
 Summary: CLI scaffolding tool for arclith — hexagonal architecture framework
 Author-email: Killian KOPP <killiankopp@gmail.com>
 License:                                  Apache License
@@ -186,7 +186,7 @@ License:                                  Apache License
 License-File: LICENSE
 Keywords: arclith,cli,ddd,hexagonal-architecture,scaffold
 Requires-Python: >=3.13
-Requires-Dist: arclith>=0.23.0
+Requires-Dist: arclith>=0.25.0
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: typer>=0.15.0
@@ -194,7 +194,9 @@ Description-Content-Type: text/markdown
 
 # arclith-cli
 
-`arclith-cli` génère instantanément un projet Python en architecture hexagonale prêt à démarrer, en téléchargeant le template officiel `_sample` depuis GitHub et en remplaçant l'entité de démo `Ingredient` par le nom de votre choix. Tout type de projet peut être scaffoldé — service REST, agent IA, API MCP — avec les ports, le nom de projet et le backend de persistance configurés d'emblée.
+`arclith-cli` construit un projet Python hexagonal par étapes. `init` pose uniquement le socle
+installable ; chaque adapter, transport et dépendance optionnelle est ensuite ajouté explicitement.
+`new` reste disponible pour générer un projet depuis le template officiel `_sample`.
 
 ## Installation
 
@@ -204,6 +206,8 @@ uv tool install "git+https://github.com/karned-rekipe/arclith.git#subdirectory=c
 
 ## Commandes
 
+Exécuter `arclith-cli` sans argument affiche cette liste de commandes et termine sans erreur.
+
 ### `init` — Initialiser un projet minimal
 
 Crée un projet Arclith vide de métier, avec le layout canonique `src/<package>/...`, une
@@ -221,6 +225,39 @@ arclith-cli init todo-list-service --dir ~/projects
 
 Cette commande ne crée aucune entité, aucun CRUD et aucun endpoint métier. Elle sert quand on veut
 construire le projet étape par étape avec `add-entity`, `add-usecase`, puis `add-adapter`.
+Elle ne crée pas non plus FastAPI ou FastMCP et n'installe aucun de leurs extras.
+
+#### Pourquoi `src/<package>/...` ?
+
+`src/` est la racine des imports du projet installé ; `<package>` est le namespace propre au
+service. Les couches restent donc importées comme `todo_service.domain` ou
+`todo_service.application`, au lieu de créer des packages Python globaux et génériques nommés
+`domain`, `application` et `adapters`. Cette structure évite les collisions, empêche les tests
+d'importer accidentellement le dépôt courant à la place du package installé et suit le `src layout`
+standard de l'écosystème Python.
+
+#### Parcours complet vers une API
+
+```bash
+arclith-cli init todo-api
+cd todo-api
+arclith-cli add-entity Todo
+arclith-cli add-usecase CreateTodo --entity Todo
+
+# Choisir explicitement la persistance et le transport utilisés.
+arclith-cli add-adapter --capability repository --adapter memory --entity Todo --yes
+arclith-cli add-adapter --capability api --adapter fastapi --yes
+
+# Après avoir défini les champs et implémenté CreateTodoUseCase.execute :
+arclith-cli expose-usecase create-todo --via fastapi --feature todos \
+  --path /v1/todos --method POST --status-code 201
+uv sync
+MODE=api uv run python main.py
+```
+
+Le registre de binding généré reste à appeler depuis le composition root avec l'instance typée du
+use case ; le CLI ne devine pas ses dépendances métier. Voir le
+[guide des bindings](https://karned-rekipe.github.io/arclith/deep-dives/use-case-bindings/).
 
 ---
 
@@ -252,7 +289,10 @@ template est régénéré côté CLI pour appliquer le contrat `runtime/docker-i
 
 ### `add-entity` — Ajouter une entité métier
 
-Crée uniquement le fichier minimal d'une entité dans `src/<package>/domain/models/`.
+Crée un squelette minimal et guidé dans `src/<package>/domain/models/`. Le fichier
+signale où déclarer les champs et invariants, rappelle les champs déjà fournis par
+`Entity` et renvoie vers les guides Arclith et Pydantic. L'exemple `Field(...)`
+reste commenté, donc aucun import inutilisé n'est ajouté.
 
 ```bash
 cd my-recipe-service
@@ -265,21 +305,41 @@ Fichier généré :
 src/<package>/domain/models/shopping_item.py
 ```
 
-La commande ne génère aucun CRUD, aucun port repository, aucun adapter et aucun endpoint. Elle pose seulement le point d'ancrage du modèle métier ; le développeur complète ensuite les champs et invariants de l'entité.
+La commande ne génère aucun CRUD, aucun port repository, aucun adapter et aucun
+endpoint. Elle pose seulement le point d'ancrage du modèle métier ; le
+développeur complète ensuite les champs et invariants de l'entité.
 
 ---
 
 ### `add-usecase` — Ajouter un cas d'usage
 
-Crée le port inbound minimal dans `src/<package>/domain/ports/inbound/`, puis le fichier minimal du
-cas d'usage dans `src/<package>/application/use_cases/`.
+Crée un port inbound guidé dans `src/<package>/domain/ports/inbound/`, puis le
+cas d'usage dans `src/<package>/application/use_cases/`. Sans option de liaison,
+la commande interactive propose les entités détectées par analyse AST, la
+création d'une nouvelle entité ou un cas d'usage transverse.
 
 ```bash
 cd my-recipe-service
+
+# Mode interactif : choisir une entité détectée, en créer une ou rester transverse
 arclith-cli add-usecase PlanShoppingList
-arclith-cli add-usecase find-by-name
+
+# Modes directs, complets pour les agents et la CI
+arclith-cli add-usecase CreateTodo --entity Todo
+arclith-cli add-usecase CreateRecipe --new-entity Recipe
+arclith-cli add-usecase RunMaintenance --no-entity
 ```
 
+| Option | Effet |
+|---|---|
+| `--entity Todo` | lie le use case à une entité détectée et échoue si elle est absente |
+| `--new-entity Todo` | crée l'entité si nécessaire, puis génère le use case lié |
+| `--no-entity` | génère un `Command`, un `Result` et un use case transverse sans repository |
+
+Ces options sont mutuellement exclusives. `--new-entity` réutilise une entité
+valide déjà présente, mais refuse un fichier homonyme qui ne déclare pas la
+classe `Entity` attendue.
+
 Fichier généré :
 
 ```text
@@ -287,9 +347,17 @@ src/<package>/domain/ports/inbound/plan_shopping_list.py
 src/<package>/application/use_cases/plan_shopping_list.py
 ```
 
-Le nom peut être fourni en PascalCase, snake_case ou kebab-case. Le suffixe `UseCase` est normalisé : `PlanShoppingListUseCase` et `plan-shopping-list-use-case` génèrent tous les deux `PlanShoppingListUseCase`.
+Le nom peut être fourni en PascalCase, snake_case ou kebab-case. Le suffixe
+`UseCase` est normalisé : `PlanShoppingListUseCase` et
+`plan-shopping-list-use-case` génèrent tous les deux
+`PlanShoppingListUseCase`.
 
-Comme `add-entity`, cette commande ne câble pas FastAPI, FastMCP, LangGraph, un repository ou un service. Les adapters se branchent ensuite explicitement avec `add-adapter` et devraient dépendre du port inbound généré.
+Pour une entité principale, le squelette injecte explicitement
+`Repository[Entity]` et type `execute` avec un `Command` Pydantic et l'entité en
+retour. Le mode transverse génère plutôt un `Command` et un `Result` Pydantic,
+sans repository implicite. Aucun mode ne câble FastAPI, FastMCP ou LangGraph.
+Les exemples complets et les règles de séparation sont dans le
+[deep dive du scaffold CLI](https://karned-rekipe.github.io/arclith/deep-dives/cli-scaffold/).
 
 ---
 
@@ -319,7 +387,9 @@ logique métier.
 
 ### `add-adapter` — Ajouter un adapter
 
-Wizard interactif à lancer **depuis la racine du projet cible**. Scaffold le code Python et/ou les fichiers de configuration pour un nouvel adapter. Par défaut, la capacité cible est `repository`.
+Wizard interactif à lancer **depuis la racine du projet cible**. Sans option, il affiche toutes les
+capabilities et leurs adapters, notamment `api/fastapi` et `mcp/fastmcp`, puis demande le choix.
+Il scaffold uniquement le code, la configuration et l'extra de dépendance du choix effectué.
 
 ```bash
 cd my-recipe-service
@@ -346,9 +416,10 @@ arclith-cli add-adapter --capability repository --adapter memory --entity Recipe
 
 **Étapes du wizard :**
 
-1. **Type d'adapter** — selon la capacité : `memory` · `mongodb` · `duckdb` · `mariadb` · `fastapi` · `fastmcp` · `rabbitmq` · `docker-image` · `lmstudio` · `openai` · `anthropic` · `langgraph` · `langsmith` · `opentelemetry`
-2. **Entité(s) cible(s)** — détectées automatiquement pour les adapters entity-scoped ; ignorées pour les transports globaux, `cache/*`, `llm/*`, `agent/langgraph`, `runtime/docker-image` et les adapters d'observability
-3. **Paramètres** — questions spécifiques à l'adapter :
+1. **Capability** — toutes les capabilities du catalogue sont proposées avec leurs adapters
+2. **Type d'adapter** — selon la capability : `memory` · `mongodb` · `duckdb` · `mariadb` · `fastapi` · `fastmcp` · `rabbitmq` · `docker-image` · `lmstudio` · `openai` · `anthropic` · `langgraph` · `langsmith` · `opentelemetry`
+3. **Entité(s) cible(s)** — détectées automatiquement pour les adapters entity-scoped ; ignorées pour les transports globaux, `cache/*`, `llm/*`, `agent/langgraph`, `runtime/docker-image` et les adapters d'observability
+4. **Paramètres** — questions spécifiques à l'adapter :
    - `mongodb` → `db_name`, `collection_name`, `multitenant`
    - `duckdb` → `path`
    - `mariadb` → `host`, `port`, `database`, `user`, `driver`, `table_prefix`
@@ -366,12 +437,12 @@ arclith-cli add-adapter --capability repository --adapter memory --entity Recipe
    - `command-bus/rabbitmq` → `url`, `exchange`, `exchange_type`, `queue`, `routing_key`, `prefetch`, `consumer_name`, `concurrency`, `publisher_confirms`, `durable`, `retry_enabled`, `retry_requeue`, `dead_letter_exchange`, `dead_letter_routing_key`
    - `runtime/docker-image` → `uv_version`, `api_port`, `mcp_port`, `probe_port`, `agent_port`
    - `repository/memory` → aucun paramètre
-4. **Activation** — met à jour `config/adapters/adapters.yaml` pour les capacités activables (`repository: <adapter>` ou `observability.enabled: [<adapter>, ...]`) ; `api/fastapi`, `mcp/fastmcp`, `cache/*`, `llm/*`, `agent/langgraph`, `command-bus/rabbitmq` et `runtime/docker-image` sont exposés par leurs fichiers dédiés
-5. **Récapitulatif** — liste des fichiers créés ou remplacés avant confirmation
+5. **Activation** — met à jour `config/adapters/adapters.yaml` pour les capacités activables (`repository: <adapter>` ou `observability.enabled: [<adapter>, ...]`) ; `api/fastapi`, `mcp/fastmcp`, `cache/*`, `llm/*`, `agent/langgraph`, `command-bus/rabbitmq` et `runtime/docker-image` sont exposés par leurs fichiers dédiés
+6. **Récapitulatif** — liste des fichiers créés ou remplacés avant confirmation
 
 | Option | Défaut | Description |
 |--------|--------|-------------|
-| `--capability` | `repository` | Capacité cible du catalogue standardisé (`repository`, `cache`, `api`, `mcp`, `http`, `command-bus`, `runtime`, `llm`, `agent`, `observability`) |
+| `--capability` | interactif | Capacité cible du catalogue standardisé (`repository`, `cache`, `api`, `mcp`, `http`, `command-bus`, `runtime`, `llm`, `agent`, `observability`) |
 | `--adapter` / `-a` | interactif | Adapter du catalogue : `memory`, `mongodb`, `duckdb`, `mariadb`, `fastapi`, `fastmcp`, `idempotency`, `etag`, `cache-control`, `rabbitmq`, `docker-image`, `lmstudio`, `openai`, `anthropic`, `langgraph`, `langsmith`, `opentelemetry` |
 | `--entity` / `-e` | auto si une seule entité | Entité cible, liste séparée par virgule acceptée |
 | `--all-entities` | `false` | Génère l'adapter pour toutes les entités détectées |
@@ -430,6 +501,9 @@ LM Studio ou tout endpoint OpenAI-compatible avec `base_url`.
 L'adapter `repository/mongodb` génère `config/adapters/outbound/mongodb.yaml` avec `uri: null`, puis
 mappe `adapters.mongodb.uri` vers `MONGODB_URI` dans `config/secrets.yaml`. L'URI réelle reste dans
 l'environnement, un fichier local de secrets ou Vault selon le resolver choisi.
+Il ne génère pas de repository `memory` applicatif. L'implémentation mémoire du framework peut être
+utilisée directement dans des tests ; une spécialisation mémoire du projet n'est créée que par un
+choix explicite de `repository/memory`.
 
 L'adapter `agent/langgraph` génère `langgraph.json`, `config/adapters/inbound/langgraph.yaml` et
 `src/<package>/adapters/inbound/langgraph/agent.py`. Le projet ne modifie ensuite que ce fichier pour

{arclith_cli-0.20.0 → arclith_cli-0.22.0}/README.md

@@ -1,6 +1,8 @@
 # arclith-cli
 
-`arclith-cli` génère instantanément un projet Python en architecture hexagonale prêt à démarrer, en téléchargeant le template officiel `_sample` depuis GitHub et en remplaçant l'entité de démo `Ingredient` par le nom de votre choix. Tout type de projet peut être scaffoldé — service REST, agent IA, API MCP — avec les ports, le nom de projet et le backend de persistance configurés d'emblée.
+`arclith-cli` construit un projet Python hexagonal par étapes. `init` pose uniquement le socle
+installable ; chaque adapter, transport et dépendance optionnelle est ensuite ajouté explicitement.
+`new` reste disponible pour générer un projet depuis le template officiel `_sample`.
 
 ## Installation
 
@@ -10,6 +12,8 @@ uv tool install "git+https://github.com/karned-rekipe/arclith.git#subdirectory=c
 
 ## Commandes
 
+Exécuter `arclith-cli` sans argument affiche cette liste de commandes et termine sans erreur.
+
 ### `init` — Initialiser un projet minimal
 
 Crée un projet Arclith vide de métier, avec le layout canonique `src/<package>/...`, une
@@ -27,6 +31,39 @@ arclith-cli init todo-list-service --dir ~/projects
 
 Cette commande ne crée aucune entité, aucun CRUD et aucun endpoint métier. Elle sert quand on veut
 construire le projet étape par étape avec `add-entity`, `add-usecase`, puis `add-adapter`.
+Elle ne crée pas non plus FastAPI ou FastMCP et n'installe aucun de leurs extras.
+
+#### Pourquoi `src/<package>/...` ?
+
+`src/` est la racine des imports du projet installé ; `<package>` est le namespace propre au
+service. Les couches restent donc importées comme `todo_service.domain` ou
+`todo_service.application`, au lieu de créer des packages Python globaux et génériques nommés
+`domain`, `application` et `adapters`. Cette structure évite les collisions, empêche les tests
+d'importer accidentellement le dépôt courant à la place du package installé et suit le `src layout`
+standard de l'écosystème Python.
+
+#### Parcours complet vers une API
+
+```bash
+arclith-cli init todo-api
+cd todo-api
+arclith-cli add-entity Todo
+arclith-cli add-usecase CreateTodo --entity Todo
+
+# Choisir explicitement la persistance et le transport utilisés.
+arclith-cli add-adapter --capability repository --adapter memory --entity Todo --yes
+arclith-cli add-adapter --capability api --adapter fastapi --yes
+
+# Après avoir défini les champs et implémenté CreateTodoUseCase.execute :
+arclith-cli expose-usecase create-todo --via fastapi --feature todos \
+  --path /v1/todos --method POST --status-code 201
+uv sync
+MODE=api uv run python main.py
+```
+
+Le registre de binding généré reste à appeler depuis le composition root avec l'instance typée du
+use case ; le CLI ne devine pas ses dépendances métier. Voir le
+[guide des bindings](https://karned-rekipe.github.io/arclith/deep-dives/use-case-bindings/).
 
 ---
 
@@ -58,7 +95,10 @@ template est régénéré côté CLI pour appliquer le contrat `runtime/docker-i
 
 ### `add-entity` — Ajouter une entité métier
 
-Crée uniquement le fichier minimal d'une entité dans `src/<package>/domain/models/`.
+Crée un squelette minimal et guidé dans `src/<package>/domain/models/`. Le fichier
+signale où déclarer les champs et invariants, rappelle les champs déjà fournis par
+`Entity` et renvoie vers les guides Arclith et Pydantic. L'exemple `Field(...)`
+reste commenté, donc aucun import inutilisé n'est ajouté.
 
 ```bash
 cd my-recipe-service
@@ -71,21 +111,41 @@ Fichier généré :
 src/<package>/domain/models/shopping_item.py
 ```
 
-La commande ne génère aucun CRUD, aucun port repository, aucun adapter et aucun endpoint. Elle pose seulement le point d'ancrage du modèle métier ; le développeur complète ensuite les champs et invariants de l'entité.
+La commande ne génère aucun CRUD, aucun port repository, aucun adapter et aucun
+endpoint. Elle pose seulement le point d'ancrage du modèle métier ; le
+développeur complète ensuite les champs et invariants de l'entité.
 
 ---
 
 ### `add-usecase` — Ajouter un cas d'usage
 
-Crée le port inbound minimal dans `src/<package>/domain/ports/inbound/`, puis le fichier minimal du
-cas d'usage dans `src/<package>/application/use_cases/`.
+Crée un port inbound guidé dans `src/<package>/domain/ports/inbound/`, puis le
+cas d'usage dans `src/<package>/application/use_cases/`. Sans option de liaison,
+la commande interactive propose les entités détectées par analyse AST, la
+création d'une nouvelle entité ou un cas d'usage transverse.
 
 ```bash
 cd my-recipe-service
+
+# Mode interactif : choisir une entité détectée, en créer une ou rester transverse
 arclith-cli add-usecase PlanShoppingList
-arclith-cli add-usecase find-by-name
+
+# Modes directs, complets pour les agents et la CI
+arclith-cli add-usecase CreateTodo --entity Todo
+arclith-cli add-usecase CreateRecipe --new-entity Recipe
+arclith-cli add-usecase RunMaintenance --no-entity
 ```
 
+| Option | Effet |
+|---|---|
+| `--entity Todo` | lie le use case à une entité détectée et échoue si elle est absente |
+| `--new-entity Todo` | crée l'entité si nécessaire, puis génère le use case lié |
+| `--no-entity` | génère un `Command`, un `Result` et un use case transverse sans repository |
+
+Ces options sont mutuellement exclusives. `--new-entity` réutilise une entité
+valide déjà présente, mais refuse un fichier homonyme qui ne déclare pas la
+classe `Entity` attendue.
+
 Fichier généré :
 
 ```text
@@ -93,9 +153,17 @@ src/<package>/domain/ports/inbound/plan_shopping_list.py
 src/<package>/application/use_cases/plan_shopping_list.py
 ```
 
-Le nom peut être fourni en PascalCase, snake_case ou kebab-case. Le suffixe `UseCase` est normalisé : `PlanShoppingListUseCase` et `plan-shopping-list-use-case` génèrent tous les deux `PlanShoppingListUseCase`.
+Le nom peut être fourni en PascalCase, snake_case ou kebab-case. Le suffixe
+`UseCase` est normalisé : `PlanShoppingListUseCase` et
+`plan-shopping-list-use-case` génèrent tous les deux
+`PlanShoppingListUseCase`.
 
-Comme `add-entity`, cette commande ne câble pas FastAPI, FastMCP, LangGraph, un repository ou un service. Les adapters se branchent ensuite explicitement avec `add-adapter` et devraient dépendre du port inbound généré.
+Pour une entité principale, le squelette injecte explicitement
+`Repository[Entity]` et type `execute` avec un `Command` Pydantic et l'entité en
+retour. Le mode transverse génère plutôt un `Command` et un `Result` Pydantic,
+sans repository implicite. Aucun mode ne câble FastAPI, FastMCP ou LangGraph.
+Les exemples complets et les règles de séparation sont dans le
+[deep dive du scaffold CLI](https://karned-rekipe.github.io/arclith/deep-dives/cli-scaffold/).
 
 ---
 
@@ -125,7 +193,9 @@ logique métier.
 
 ### `add-adapter` — Ajouter un adapter
 
-Wizard interactif à lancer **depuis la racine du projet cible**. Scaffold le code Python et/ou les fichiers de configuration pour un nouvel adapter. Par défaut, la capacité cible est `repository`.
+Wizard interactif à lancer **depuis la racine du projet cible**. Sans option, il affiche toutes les
+capabilities et leurs adapters, notamment `api/fastapi` et `mcp/fastmcp`, puis demande le choix.
+Il scaffold uniquement le code, la configuration et l'extra de dépendance du choix effectué.
 
 ```bash
 cd my-recipe-service
@@ -152,9 +222,10 @@ arclith-cli add-adapter --capability repository --adapter memory --entity Recipe
 
 **Étapes du wizard :**
 
-1. **Type d'adapter** — selon la capacité : `memory` · `mongodb` · `duckdb` · `mariadb` · `fastapi` · `fastmcp` · `rabbitmq` · `docker-image` · `lmstudio` · `openai` · `anthropic` · `langgraph` · `langsmith` · `opentelemetry`
-2. **Entité(s) cible(s)** — détectées automatiquement pour les adapters entity-scoped ; ignorées pour les transports globaux, `cache/*`, `llm/*`, `agent/langgraph`, `runtime/docker-image` et les adapters d'observability
-3. **Paramètres** — questions spécifiques à l'adapter :
+1. **Capability** — toutes les capabilities du catalogue sont proposées avec leurs adapters
+2. **Type d'adapter** — selon la capability : `memory` · `mongodb` · `duckdb` · `mariadb` · `fastapi` · `fastmcp` · `rabbitmq` · `docker-image` · `lmstudio` · `openai` · `anthropic` · `langgraph` · `langsmith` · `opentelemetry`
+3. **Entité(s) cible(s)** — détectées automatiquement pour les adapters entity-scoped ; ignorées pour les transports globaux, `cache/*`, `llm/*`, `agent/langgraph`, `runtime/docker-image` et les adapters d'observability
+4. **Paramètres** — questions spécifiques à l'adapter :
    - `mongodb` → `db_name`, `collection_name`, `multitenant`
    - `duckdb` → `path`
    - `mariadb` → `host`, `port`, `database`, `user`, `driver`, `table_prefix`
@@ -172,12 +243,12 @@ arclith-cli add-adapter --capability repository --adapter memory --entity Recipe
    - `command-bus/rabbitmq` → `url`, `exchange`, `exchange_type`, `queue`, `routing_key`, `prefetch`, `consumer_name`, `concurrency`, `publisher_confirms`, `durable`, `retry_enabled`, `retry_requeue`, `dead_letter_exchange`, `dead_letter_routing_key`
    - `runtime/docker-image` → `uv_version`, `api_port`, `mcp_port`, `probe_port`, `agent_port`
    - `repository/memory` → aucun paramètre
-4. **Activation** — met à jour `config/adapters/adapters.yaml` pour les capacités activables (`repository: <adapter>` ou `observability.enabled: [<adapter>, ...]`) ; `api/fastapi`, `mcp/fastmcp`, `cache/*`, `llm/*`, `agent/langgraph`, `command-bus/rabbitmq` et `runtime/docker-image` sont exposés par leurs fichiers dédiés
-5. **Récapitulatif** — liste des fichiers créés ou remplacés avant confirmation
+5. **Activation** — met à jour `config/adapters/adapters.yaml` pour les capacités activables (`repository: <adapter>` ou `observability.enabled: [<adapter>, ...]`) ; `api/fastapi`, `mcp/fastmcp`, `cache/*`, `llm/*`, `agent/langgraph`, `command-bus/rabbitmq` et `runtime/docker-image` sont exposés par leurs fichiers dédiés
+6. **Récapitulatif** — liste des fichiers créés ou remplacés avant confirmation
 
 | Option | Défaut | Description |
 |--------|--------|-------------|
-| `--capability` | `repository` | Capacité cible du catalogue standardisé (`repository`, `cache`, `api`, `mcp`, `http`, `command-bus`, `runtime`, `llm`, `agent`, `observability`) |
+| `--capability` | interactif | Capacité cible du catalogue standardisé (`repository`, `cache`, `api`, `mcp`, `http`, `command-bus`, `runtime`, `llm`, `agent`, `observability`) |
 | `--adapter` / `-a` | interactif | Adapter du catalogue : `memory`, `mongodb`, `duckdb`, `mariadb`, `fastapi`, `fastmcp`, `idempotency`, `etag`, `cache-control`, `rabbitmq`, `docker-image`, `lmstudio`, `openai`, `anthropic`, `langgraph`, `langsmith`, `opentelemetry` |
 | `--entity` / `-e` | auto si une seule entité | Entité cible, liste séparée par virgule acceptée |
 | `--all-entities` | `false` | Génère l'adapter pour toutes les entités détectées |
@@ -236,6 +307,9 @@ LM Studio ou tout endpoint OpenAI-compatible avec `base_url`.
 L'adapter `repository/mongodb` génère `config/adapters/outbound/mongodb.yaml` avec `uri: null`, puis
 mappe `adapters.mongodb.uri` vers `MONGODB_URI` dans `config/secrets.yaml`. L'URI réelle reste dans
 l'environnement, un fichier local de secrets ou Vault selon le resolver choisi.
+Il ne génère pas de repository `memory` applicatif. L'implémentation mémoire du framework peut être
+utilisée directement dans des tests ; une spécialisation mémoire du projet n'est créée que par un
+choix explicite de `repository/memory`.
 
 L'adapter `agent/langgraph` génère `langgraph.json`, `config/adapters/inbound/langgraph.yaml` et
 `src/<package>/adapters/inbound/langgraph/agent.py`. Le projet ne modifie ensuite que ce fichier pour

arclith_cli-0.22.0/arclith_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.22.0"