arclith-cli 0.19.0__tar.gz → 0.21.0__tar.gz

{arclith_cli-0.19.0 → arclith_cli-0.21.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: arclith-cli
-Version: 0.19.0
+Version: 0.21.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.22.0
+Requires-Dist: arclith>=0.24.0
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: typer>=0.15.0
@@ -252,7 +252,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 +268,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 +310,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`.
-
-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é.
+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`.
+
+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/).
 
 ---
 

{arclith_cli-0.19.0 → arclith_cli-0.21.0}/README.md

@@ -58,7 +58,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 +74,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 +116,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`.
-
-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é.
+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`.
+
+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/).
 
 ---
 

arclith_cli-0.21.0/arclith_cli/__init__.py

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

{arclith_cli-0.19.0 → arclith_cli-0.21.0}/arclith_cli/adapter_templates.py

@@ -205,7 +205,8 @@ _repository_registry: RepositoryRegistry[{pascal}, {pascal}Repository] = (
 
 
 def build_{snake}_service(arclith: Arclith) -> tuple[{pascal}Service, Logger]:
-    arclith.logger.info("🗄️ Repository adapter selected", adapter=arclith.config.adapters.repository)
+    adapter = arclith.config.adapters.repository_adapter_for({pascal})
+    arclith.logger.info("🗄️ Repository adapter selected", adapter=adapter)
     repo: {pascal}Repository = arclith.repository({pascal}, registry=_repository_registry)
     return {pascal}Service(repo, arclith.logger, arclith.config.soft_delete.retention_days), arclith.logger
 """

{arclith_cli-0.19.0 → arclith_cli-0.21.0}/arclith_cli/capabilities.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 from typing import Any
 
 from arclith_cli.capability_models import (
+    AdapterFacets,
     AdapterProfileSpec,
     AdapterSpec,
     CapabilitySpec,
@@ -18,6 +19,7 @@ from arclith_cli.catalogs.ai import (
     EMBEDDING_CAPABILITY,
     LLM_CAPABILITY,
 )
+from arclith_cli.catalogs.channels import CHANNEL_CAPABILITY
 from arclith_cli.catalogs.core import (
     CACHE_CAPABILITY,
     LOGGER_CAPABILITY,
@@ -48,9 +50,11 @@ __all__ = [
     "AGENT_PERSISTENCE_CAPABILITY",
     "API_CAPABILITY",
     "AUTH_CAPABILITY",
+    "AdapterFacets",
     "AdapterProfileSpec",
     "AdapterSpec",
     "CACHE_CAPABILITY",
+    "CHANNEL_CAPABILITY",
     "CAPABILITY_CATALOG",
     "COMMAND_BUS_CAPABILITY",
     "CapabilitySpec",
@@ -91,6 +95,7 @@ CAPABILITY_CATALOG = (
     PROBE_CAPABILITY,
     HTTP_CAPABILITY,
     COMMAND_BUS_CAPABILITY,
+    CHANNEL_CAPABILITY,
     RUNTIME_CAPABILITY,
     AUTH_CAPABILITY,
     TENANT_CAPABILITY,

{arclith_cli-0.19.0 → arclith_cli-0.21.0}/arclith_cli/capability_models.py

@@ -5,6 +5,16 @@ from typing import Any, Literal
 
 ParameterKind = Literal["string", "boolean"]
 LayerKind = Literal["inbound", "outbound", "bidirectional", "runtime"]
+StorageModel = Literal[
+    "memory",
+    "document",
+    "relational_json",
+    "embedded_analytics",
+    "relational_structured",
+]
+RuntimeKind = Literal["in_process", "file", "server"]
+TransactionSupport = Literal["none", "limited", "strong"]
+SchemaStrategy = Literal["flexible", "json_table", "structured_tables"]
 
 
 @dataclass(frozen=True)
@@ -70,6 +80,30 @@ class AdapterProfileSpec:
         return {"name": self.name, "parameters": dict(self.parameters)}
 
 
+@dataclass(frozen=True)
+class AdapterFacets:
+    storage_model: StorageModel
+    runtime: RuntimeKind
+    production_ready: bool
+    multi_process: bool
+    transactions: TransactionSupport
+    schema_strategy: SchemaStrategy
+    recommended_for: tuple[str, ...]
+    limits: tuple[str, ...]
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "storage_model": self.storage_model,
+            "runtime": self.runtime,
+            "production_ready": self.production_ready,
+            "multi_process": self.multi_process,
+            "transactions": self.transactions,
+            "schema_strategy": self.schema_strategy,
+            "recommended_for": list(self.recommended_for),
+            "limits": list(self.limits),
+        }
+
+
 @dataclass(frozen=True)
 class AdapterSpec:
     name: str
@@ -90,6 +124,7 @@ class AdapterSpec:
     profiles: tuple[AdapterProfileSpec, ...] = ()
     dependency_extra: str | None = None
     entity_scoped: bool = True
+    facets: AdapterFacets | None = None
 
     def has_config(self) -> bool:
         return self.config_path is not None and bool(self.config_template)
@@ -137,6 +172,7 @@ class AdapterSpec:
             "profiles": [profile.to_dict() for profile in self.profiles],
             "dependency_extra": self.dependency_extra,
             "entity_scoped": self.entity_scoped,
+            "facets": self.facets.to_dict() if self.facets is not None else None,
         }
 
 
@@ -169,6 +205,7 @@ class CapabilitySpec:
 
 
 __all__ = [
+    "AdapterFacets",
     "AdapterProfileSpec",
     "AdapterSpec",
     "CapabilitySpec",
@@ -176,5 +213,9 @@ __all__ = [
     "LayerKind",
     "ParameterKind",
     "ParameterSpec",
+    "RuntimeKind",
+    "SchemaStrategy",
     "SecretMappingSpec",
+    "StorageModel",
+    "TransactionSupport",
 ]

arclith_cli-0.21.0/arclith_cli/catalogs/channels.py

@@ -0,0 +1,197 @@
+from arclith_cli.capability_models import (
+    AdapterSpec,
+    CapabilitySpec,
+    ParameterSpec,
+    SecretMappingSpec,
+)
+
+CHANNEL_CAPABILITY = CapabilitySpec(
+    name="channel",
+    layer="bidirectional",
+    description="Messages conversationnels entrants et sortants normalisés.",
+    activation_config_key=None,
+    adapters=(
+        AdapterSpec(
+            name="memory",
+            capability="channel",
+            layer="bidirectional",
+            description="Fake déterministe en mémoire pour tests et prototypes locaux.",
+            config_path="config/adapters/bidirectional/memory.yaml",
+            config_template="""\
+enabled: true
+""",
+            entity_scoped=False,
+        ),
+        AdapterSpec(
+            name="webhook",
+            capability="channel",
+            layer="bidirectional",
+            description="Webhook HTTP générique signé, idempotent et provider-neutral.",
+            config_path="config/adapters/bidirectional/webhook.yaml",
+            config_template="""\
+enabled: true
+path: "{path}"
+secret: null
+signature_header: "{signature_header}"
+timestamp_header: "{timestamp_header}"
+signature_tolerance_seconds: {signature_tolerance_seconds}
+idempotency_header: "{idempotency_header}"
+event_ttl_seconds: {event_ttl_seconds}
+max_payload_bytes: {max_payload_bytes}
+metadata_allowlist: []
+response_mode: "{response_mode}"
+callback_url: {callback_url}
+callback_allowed_host: {callback_allowed_host}
+callback_timeout_seconds: {callback_timeout_seconds}
+""",
+            secret_mappings=(
+                SecretMappingSpec(
+                    field_path="adapters.channel.webhook.secret",
+                    secret_key="ARCLITH_WEBHOOK_SECRET",
+                ),
+            ),
+            parameters=(
+                ParameterSpec(
+                    name="path",
+                    kind="string",
+                    prompt="Route HTTP statique du webhook",
+                    default="/channels/webhook",
+                ),
+                ParameterSpec(
+                    name="signature_header",
+                    kind="string",
+                    prompt="Header de signature HMAC",
+                    default="X-Arclith-Signature",
+                ),
+                ParameterSpec(
+                    name="timestamp_header",
+                    kind="string",
+                    prompt="Header du timestamp signé",
+                    default="X-Arclith-Timestamp",
+                ),
+                ParameterSpec(
+                    name="signature_tolerance_seconds",
+                    kind="string",
+                    prompt="Tolérance de fraîcheur HMAC en secondes",
+                    default="300",
+                ),
+                ParameterSpec(
+                    name="idempotency_header",
+                    kind="string",
+                    prompt="Header de l'identifiant stable de l'événement",
+                    default="X-Arclith-Event-Id",
+                ),
+                ParameterSpec(
+                    name="event_ttl_seconds",
+                    kind="string",
+                    prompt="Durée de déduplication en secondes",
+                    default="86400",
+                ),
+                ParameterSpec(
+                    name="max_payload_bytes",
+                    kind="string",
+                    prompt="Taille maximale du payload en octets",
+                    default="1048576",
+                ),
+                ParameterSpec(
+                    name="response_mode",
+                    kind="string",
+                    prompt="Mode de réponse HTTP",
+                    default="sync",
+                    choices=("sync", "accepted", "callback"),
+                ),
+                ParameterSpec(
+                    name="callback_url",
+                    kind="string",
+                    prompt="URL HTTPS du callback côté serveur (null hors mode callback)",
+                    default="null",
+                ),
+                ParameterSpec(
+                    name="callback_allowed_host",
+                    kind="string",
+                    prompt="Hostname exact autorisé pour le callback (null hors mode callback)",
+                    default="null",
+                ),
+                ParameterSpec(
+                    name="callback_timeout_seconds",
+                    kind="string",
+                    prompt="Timeout du callback sortant en secondes",
+                    default="5.0",
+                ),
+            ),
+            dependency_extra="channel",
+            entity_scoped=False,
+        ),
+        AdapterSpec(
+            name="slack",
+            capability="channel",
+            layer="bidirectional",
+            description="Slack Events API signé avec réponses chat.postMessage.",
+            config_path="config/adapters/bidirectional/slack.yaml",
+            config_template="""\
+enabled: true
+path: "{path}"
+signing_secret: null
+bot_token: null
+workspace_id: {workspace_id}
+allowed_channel_ids: []
+signature_tolerance_seconds: {signature_tolerance_seconds}
+event_ttl_seconds: {event_ttl_seconds}
+max_payload_bytes: {max_payload_bytes}
+request_timeout_seconds: {request_timeout_seconds}
+""",
+            secret_mappings=(
+                SecretMappingSpec(
+                    field_path="adapters.channel.slack.signing_secret",
+                    secret_key="ARCLITH_SLACK_SIGNING_SECRET",
+                ),
+                SecretMappingSpec(
+                    field_path="adapters.channel.slack.bot_token",
+                    secret_key="ARCLITH_SLACK_BOT_TOKEN",
+                ),
+            ),
+            parameters=(
+                ParameterSpec(
+                    name="path",
+                    kind="string",
+                    prompt="Route HTTP statique des événements Slack",
+                    default="/channels/slack/events",
+                ),
+                ParameterSpec(
+                    name="workspace_id",
+                    kind="string",
+                    prompt="Workspace Slack exact autorisé (null pour tout accepter)",
+                    default="null",
+                ),
+                ParameterSpec(
+                    name="signature_tolerance_seconds",
+                    kind="string",
+                    prompt="Tolérance de fraîcheur de signature en secondes",
+                    default="300",
+                ),
+                ParameterSpec(
+                    name="event_ttl_seconds",
+                    kind="string",
+                    prompt="Durée de déduplication des event_id en secondes",
+                    default="86400",
+                ),
+                ParameterSpec(
+                    name="max_payload_bytes",
+                    kind="string",
+                    prompt="Taille maximale du payload en octets",
+                    default="1048576",
+                ),
+                ParameterSpec(
+                    name="request_timeout_seconds",
+                    kind="string",
+                    prompt="Timeout de chat.postMessage en secondes",
+                    default="5.0",
+                ),
+            ),
+            dependency_extra="channel",
+            entity_scoped=False,
+        ),
+    ),
+)
+
+__all__ = ["CHANNEL_CAPABILITY"]

{arclith_cli-0.19.0 → arclith_cli-0.21.0}/arclith_cli/catalogs/persistence.py

@@ -6,6 +6,15 @@ from arclith_cli.capability_models import (
     ParameterSpec,
     SecretMappingSpec,
 )
+from arclith_cli.catalogs.repository_facets import (
+    DUCKDB_FACETS,
+    MARIADB_FACETS,
+    MEMORY_FACETS,
+    MONGODB_FACETS,
+)
+from arclith_cli.catalogs.repository_postgresql import (
+    POSTGRESQL_REPOSITORY_ADAPTER,
+)
 
 REPOSITORY_CAPABILITY = CapabilitySpec(
     name="repository",
@@ -18,6 +27,7 @@ REPOSITORY_CAPABILITY = CapabilitySpec(
             capability="repository",
             layer="outbound",
             description="Stockage volatile en mémoire pour dev, tests et smoke locaux.",
+            facets=MEMORY_FACETS,
         ),
         AdapterSpec(
             name="mongodb",
@@ -57,6 +67,7 @@ multitenant: {multitenant}   # true = uri/db_name résolus par requête via JWT
                     default=False,
                 ),
             ),
+            facets=MONGODB_FACETS,
         ),
         AdapterSpec(
             name="duckdb",
@@ -76,6 +87,7 @@ path: {path}
                     default="data/",
                 ),
             ),
+            facets=DUCKDB_FACETS,
         ),
         AdapterSpec(
             name="mariadb",
@@ -142,86 +154,9 @@ multitenant: false
                     default="",
                 ),
             ),
+            facets=MARIADB_FACETS,
         ),
-        AdapterSpec(
-            name="postgresql",
-            capability="repository",
-            layer="outbound",
-            description="Repository PostgreSQL async optionnel, pilote par SQLAlchemy et asyncpg, avec payload JSONB generique.",
-            config_path="config/adapters/outbound/postgresql.yaml",
-            config_template="""\
-url: null   # à mapper via config/secrets.yaml ou resolver env/vault si vous fournissez une URL complète
-host: {host}
-port: {port}
-database: {database}
-user: {user}
-password: null   # à mapper via config/secrets.yaml ou resolver env/vault
-schema: {schema}
-driver: {driver}
-table_prefix: "{table_prefix}"
-multitenant: {multitenant}
-""",
-            secret_mappings=(
-                SecretMappingSpec(
-                    field_path="adapters.postgresql.url",
-                    secret_key="POSTGRESQL_URL",
-                ),
-                SecretMappingSpec(
-                    field_path="adapters.postgresql.password",
-                    secret_key="POSTGRESQL_PASSWORD",
-                ),
-            ),
-            parameters=(
-                ParameterSpec(
-                    name="host",
-                    kind="string",
-                    prompt="host",
-                    default="127.0.0.1",
-                ),
-                ParameterSpec(
-                    name="port",
-                    kind="string",
-                    prompt="port",
-                    default="5432",
-                ),
-                ParameterSpec(
-                    name="database",
-                    kind="string",
-                    prompt="database",
-                    default_from_project_name=True,
-                ),
-                ParameterSpec(
-                    name="user",
-                    kind="string",
-                    prompt="user",
-                    default="app",
-                ),
-                ParameterSpec(
-                    name="schema",
-                    kind="string",
-                    prompt="schema",
-                    default="public",
-                ),
-                ParameterSpec(
-                    name="driver",
-                    kind="string",
-                    prompt="driver",
-                    default="asyncpg",
-                ),
-                ParameterSpec(
-                    name="table_prefix",
-                    kind="string",
-                    prompt="table_prefix",
-                    default="",
-                ),
-                ParameterSpec(
-                    name="multitenant",
-                    kind="boolean",
-                    prompt="multitenant",
-                    default=False,
-                ),
-            ),
-        ),
+        POSTGRESQL_REPOSITORY_ADAPTER,
     ),
 )