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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: arclith-cli
-Version: 0.18.0
+Version: 0.20.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.21.0
+Requires-Dist: arclith>=0.23.0
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: typer>=0.15.0

arclith_cli-0.20.0/arclith_cli/__init__.py

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

{arclith_cli-0.18.0 → arclith_cli-0.20.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.18.0 → arclith_cli-0.20.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,13 +19,18 @@ 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,
     SECRETS_CAPABILITY,
 )
 from arclith_cli.catalogs.observability import OBSERVABILITY_CAPABILITY
-from arclith_cli.catalogs.persistence import REPOSITORY_CAPABILITY, STORAGE_CAPABILITY
+from arclith_cli.catalogs.persistence import (
+    REPOSITORY_CAPABILITY,
+    STORAGE_CAPABILITY,
+    VECTOR_STORE_CAPABILITY,
+)
 from arclith_cli.catalogs.security import (
     AUTH_CAPABILITY,
     LICENSE_CAPABILITY,
@@ -44,9 +50,11 @@ __all__ = [
     "AGENT_PERSISTENCE_CAPABILITY",
     "API_CAPABILITY",
     "AUTH_CAPABILITY",
+    "AdapterFacets",
     "AdapterProfileSpec",
     "AdapterSpec",
     "CACHE_CAPABILITY",
+    "CHANNEL_CAPABILITY",
     "CAPABILITY_CATALOG",
     "COMMAND_BUS_CAPABILITY",
     "CapabilitySpec",
@@ -68,6 +76,7 @@ __all__ = [
     "STORAGE_CAPABILITY",
     "SecretMappingSpec",
     "TENANT_CAPABILITY",
+    "VECTOR_STORE_CAPABILITY",
     "capability_catalog_as_dict",
     "capability_names",
     "get_capability",
@@ -77,6 +86,7 @@ __all__ = [
 CAPABILITY_CATALOG = (
     REPOSITORY_CAPABILITY,
     STORAGE_CAPABILITY,
+    VECTOR_STORE_CAPABILITY,
     CACHE_CAPABILITY,
     LOGGER_CAPABILITY,
     SECRETS_CAPABILITY,
@@ -85,6 +95,7 @@ CAPABILITY_CATALOG = (
     PROBE_CAPABILITY,
     HTTP_CAPABILITY,
     COMMAND_BUS_CAPABILITY,
+    CHANNEL_CAPABILITY,
     RUNTIME_CAPABILITY,
     AUTH_CAPABILITY,
     TENANT_CAPABILITY,

{arclith_cli-0.18.0 → arclith_cli-0.20.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.18.0 → arclith_cli-0.20.0}/arclith_cli/catalogs/ai.py

@@ -260,6 +260,95 @@ multitenant: {multitenant}
             dependency_extra="embedding",
             entity_scoped=False,
         ),
+        AdapterSpec(
+            name="openai",
+            capability="embedding",
+            layer="outbound",
+            description="Embeddings via l'API OpenAI officielle et un secret externe.",
+            config_path="config/adapters/outbound/embedding.yaml",
+            config_template="""\
+adapter: openai
+base_url: "{base_url}"
+api_key: null
+model_name: "{model_name}"
+dimensions: {dimensions}
+batch_size: {batch_size}
+timeout: {timeout}
+encoding_format: {encoding_format}
+normalize: {normalize}
+multitenant: {multitenant}
+""",
+            env_path=".env",
+            env_template="""\
+OPENAI_API_KEY={api_key}
+""",
+            secret_mappings=(
+                SecretMappingSpec(
+                    field_path="adapters.embedding.api_key",
+                    secret_key="OPENAI_API_KEY",
+                ),
+            ),
+            parameters=(
+                ParameterSpec(
+                    name="base_url",
+                    kind="string",
+                    prompt="Endpoint officiel OpenAI avec préfixe API",
+                    default="https://api.openai.com/v1",
+                ),
+                ParameterSpec(
+                    name="api_key",
+                    kind="string",
+                    prompt="OPENAI_API_KEY (laisser vide pour un secret externe)",
+                    default="",
+                    secret=True,
+                ),
+                ParameterSpec(
+                    name="model_name",
+                    kind="string",
+                    prompt="ID du modèle d'embedding OpenAI accessible au projet",
+                    default="remplacer-par-model-id-openai-embedding",
+                ),
+                ParameterSpec(
+                    name="dimensions",
+                    kind="string",
+                    prompt="Dimension optionnelle des vecteurs (null pour le défaut modèle)",
+                    default="null",
+                ),
+                ParameterSpec(
+                    name="batch_size",
+                    kind="string",
+                    prompt="Taille maximale des sous-batches",
+                    default="64",
+                ),
+                ParameterSpec(
+                    name="timeout",
+                    kind="string",
+                    prompt="Timeout HTTP en secondes",
+                    default="30.0",
+                ),
+                ParameterSpec(
+                    name="encoding_format",
+                    kind="string",
+                    prompt="Format des vecteurs retournés",
+                    default="float",
+                    choices=("float",),
+                ),
+                ParameterSpec(
+                    name="normalize",
+                    kind="boolean",
+                    prompt="Normaliser les vecteurs en norme L2",
+                    default=False,
+                ),
+                ParameterSpec(
+                    name="multitenant",
+                    kind="boolean",
+                    prompt="Réserver la résolution de contexte par tenant",
+                    default=False,
+                ),
+            ),
+            dependency_extra="embedding",
+            entity_scoped=False,
+        ),
     ),
 )
 

arclith_cli-0.20.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.18.0 → arclith_cli-0.20.0}/arclith_cli/catalogs/persistence.py

@@ -6,6 +6,13 @@ from arclith_cli.capability_models import (
     ParameterSpec,
     SecretMappingSpec,
 )
+from arclith_cli.catalogs.repository_facets import (
+    DUCKDB_FACETS,
+    MARIADB_FACETS,
+    MEMORY_FACETS,
+    MONGODB_FACETS,
+    POSTGRESQL_FACETS,
+)
 
 REPOSITORY_CAPABILITY = CapabilitySpec(
     name="repository",
@@ -18,6 +25,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 +65,7 @@ multitenant: {multitenant}   # true = uri/db_name résolus par requête via JWT
                     default=False,
                 ),
             ),
+            facets=MONGODB_FACETS,
         ),
         AdapterSpec(
             name="duckdb",
@@ -76,6 +85,7 @@ path: {path}
                     default="data/",
                 ),
             ),
+            facets=DUCKDB_FACETS,
         ),
         AdapterSpec(
             name="mariadb",
@@ -142,6 +152,7 @@ multitenant: false
                     default="",
                 ),
             ),
+            facets=MARIADB_FACETS,
         ),
         AdapterSpec(
             name="postgresql",
@@ -221,6 +232,7 @@ multitenant: {multitenant}
                     default=False,
                 ),
             ),
+            facets=POSTGRESQL_FACETS,
         ),
     ),
 )
@@ -444,3 +456,132 @@ multitenant: {multitenant}
         ),
     ),
 )
+
+VECTOR_STORE_CAPABILITY = CapabilitySpec(
+    name="vector-store",
+    layer="outbound",
+    description="Indexation et recherche dense derrière un port provider-neutral.",
+    activation_config_key=None,
+    adapters=(
+        AdapterSpec(
+            name="memory",
+            capability="vector-store",
+            layer="outbound",
+            description="Recherche exacte déterministe sans dépendance pour tests et POC.",
+            config_path="config/adapters/outbound/vector_store.yaml",
+            config_template="""\
+adapter: memory
+collection_name: "{collection_name}"
+vector_size: {vector_size}
+distance: {distance}
+multitenant: {multitenant}
+""",
+            parameters=(
+                ParameterSpec(
+                    name="collection_name",
+                    kind="string",
+                    prompt="Nom logique de la collection",
+                    default="default",
+                ),
+                ParameterSpec(
+                    name="vector_size",
+                    kind="string",
+                    prompt="Dimension obligatoire des vecteurs",
+                    default="1536",
+                ),
+                ParameterSpec(
+                    name="distance",
+                    kind="string",
+                    prompt="Métrique de similarité",
+                    default="cosine",
+                    choices=("cosine", "dot", "euclid"),
+                ),
+                ParameterSpec(
+                    name="multitenant",
+                    kind="boolean",
+                    prompt="Réserver la résolution de contexte par tenant",
+                    default=False,
+                ),
+            ),
+            entity_scoped=False,
+        ),
+        AdapterSpec(
+            name="qdrant",
+            capability="vector-store",
+            layer="outbound",
+            description="Index vectoriel dense Qdrant via le client Python async officiel.",
+            config_path="config/adapters/outbound/vector_store.yaml",
+            config_template="""\
+adapter: qdrant
+url: "{url}"
+api_key: null
+collection_name: "{collection_name}"
+vector_size: {vector_size}
+distance: {distance}
+prefer_grpc: {prefer_grpc}
+timeout: {timeout}
+create_collection: {create_collection}
+multitenant: {multitenant}
+""",
+            secret_mappings=(
+                SecretMappingSpec(
+                    field_path="adapters.vector_store.api_key",
+                    secret_key="QDRANT_API_KEY",
+                ),
+            ),
+            parameters=(
+                ParameterSpec(
+                    name="url",
+                    kind="string",
+                    prompt="Endpoint HTTP Qdrant sans credentials",
+                    default="http://localhost:6333",
+                ),
+                ParameterSpec(
+                    name="collection_name",
+                    kind="string",
+                    prompt="Nom de la collection Qdrant",
+                    default="default",
+                ),
+                ParameterSpec(
+                    name="vector_size",
+                    kind="string",
+                    prompt="Dimension obligatoire des vecteurs",
+                    default="1536",
+                ),
+                ParameterSpec(
+                    name="distance",
+                    kind="string",
+                    prompt="Métrique de similarité",
+                    default="cosine",
+                    choices=("cosine", "dot", "euclid"),
+                ),
+                ParameterSpec(
+                    name="prefer_grpc",
+                    kind="boolean",
+                    prompt="Préférer le transport gRPC",
+                    default=False,
+                ),
+                ParameterSpec(
+                    name="timeout",
+                    kind="string",
+                    prompt="Timeout client en secondes",
+                    default="5.0",
+                ),
+                ParameterSpec(
+                    name="create_collection",
+                    kind="boolean",
+                    prompt="Créer la collection si elle manque",
+                    default=True,
+                ),
+                ParameterSpec(
+                    name="multitenant",
+                    kind="boolean",
+                    prompt="Résoudre url, api_key et collection par tenant",
+                    default=False,
+                ),
+            ),
+            dependency_extra="qdrant",
+            entity_scoped=False,
+        ),
+    ),
+)