docs: enrich Axe 13 Shell AI in roadmap and update architecture

ARCHITECTURE.md

@@ -15,6 +15,7 @@
 - 🚀 Les démarrer, arrêter, redémarrer en avant-plan ou en arrière-plan
 - 🔍 Observer leur état, leurs logs, leurs statistiques d'utilisation
 - 🛠️ Gérer dépendances, alias, groupes, profils, secrets, favoris et annotations
+- ⚡ Exécuter des actions shell via langage naturel avec un agent léger (`am ai`)
 
 Le tout sans toucher au système : chaque agent est installé dans un répertoire utilisateur isolé.
 
@@ -35,6 +36,7 @@ flowchart TB
         APP["App<br/>contexte partagé"]
         CLI_DEF["cli.rs<br/>définition des commandes"]
         CMD["commands/<br/>dispatch"]
+        SHELL_AI["shell_ai.rs<br/>agent shell léger"]
     end
 
     subgraph DATA["💾 Données persistantes"]
@@ -62,7 +64,9 @@ flowchart TB
     CLI --> APP
     REPL --> APP
     TUI --> APP
+    WEB --> APP
     APP --> CLI_DEF
+    APP --> SHELL_AI
     APP --> CONFIG
     APP --> CATALOG
     APP --> STATE
@@ -76,6 +80,7 @@ flowchart TB
     CMD --> DASH
     CMD --> STATS
     CMD --> SESSIONS
+    SHELL_AI --> CMD
 ```
 
 ---
@@ -166,6 +171,7 @@ src/
 ├── playbook.rs          ▶️ Rejeu pas à pas d'une séquence d'historique
 ├── plugins.rs           🔌 Scripts d'extension sur les événements (contrat JSON)
 ├── models.rs            🤖 Inventaire des modèles locaux (ollama, llama.cpp, LM Studio)
+├── shell_ai.rs          ⚡ Agent shell léger : langage naturel → action shell
 ├── sync.rs              🔄 Push git de l'état (journal, sessions, config)
 ├── agent_config.rs      ⚙️ Adaptateurs de configuration post-install (TOML/YAML/JSON/key=value)
 ├── costs.rs             💰 Coûts estimés par agent (tokens in/out, modèles de prix)
@@ -463,6 +469,7 @@ flowchart TB
 | `am registry publish/search/install` | Registre communautaire de catalogues (Gitea, manifeste + checksum sha256 vérifié) |
 | `am serve --token [--port]` | API HTTP + WebSocket authentifiée : stats, run, start, stop, ask — rate limiting par IP, TLS derrière reverse proxy |
 | `am web [--port]` | Dashboard web local en lecture seule (127.0.0.1), contrats `--json` réutilisés |
+| `am ai "<prompt>" [--exec] [--files <path>]` | **Shell AI** : langage naturel → commande/action shell via agent léger (AIChat) ; `--dry-run` par défaut, confirmation avant exécution |
 | `am lab --agents a,b --task <f>` | Benchmark comparatif (durée, exit, coût) sur tâches YAML versionnables |
 | `am sync [--message]` | Sauvegarde git de l'état (journal, sessions, config — secrets exclus) |
 | `am migrate export/import` | Bundle de transfert machine A → B (config + état + historique) |
@@ -711,6 +718,57 @@ flowchart LR
 
 ---
 
+## ⚡ Shell AI
+
+`am ai` (alias `am shell`) est une commande dédiée aux **actions shell via langage naturel**. Elle repose sur un agent léger (par défaut **AIChat**, installé comme n'importe quel autre agent via le catalogue) et réutilise le registre de providers LLM (`providers.rs`) pour choisir le modèle le plus rapide/cheap.
+
+### Flux d'exécution
+
+```mermaid
+sequenceDiagram
+    autonumber
+    participant User
+    participant cli as cli.rs
+    participant shell_ai as shell_ai.rs
+    participant catalog as catalog.rs
+    participant providers as providers.rs
+    participant runner as runner.rs
+    participant aichat as aichat (agent)
+
+    User->>cli: am ai "traite les JSON"
+    cli->>shell_ai: parse args (--exec, --files)
+    shell_ai->>catalog: agent "aichat" installé ?
+    catalog-->>shell_ai: Ok / install
+    shell_ai->>providers: provider & modèle par défaut
+    providers-->>shell_ai: config (ollama / cheap cloud)
+    shell_ai->>shell_ai: injecte cwd + fichiers (--files)
+    shell_ai->>runner: exec aichat -f . -e "..."
+    runner->>aichat: lancement processus
+    aichat-->>runner: commande générée / exécutée
+    runner-->>shell_ai: output + exit code
+    shell_ai->>shell_ai: journalise événement shell_ai
+    shell_ai-->>User: résultat ou confirmation
+```
+
+### Sécurité
+
+| Règle | Détail |
+|---|---|
+| `--dry-run` par défaut | Aucune commande modifiante n'est exécutée sans confirmation |
+| Classification risk/certainty | Inspiré d'AI CLI : chaque commande est classée `safe` ou `risky` |
+| Confirmation utilisateur | Les commandes `risky` demandent une validation explicite |
+| Mode local possible | Support d'Ollama via `providers.rs` pour ne pas sortir les données |
+
+### Dépendances
+
+- `src/shell_ai.rs` : parsing du prompt, gestion des flags, appel à l'agent
+- `src/providers.rs` : résolution du provider/modèle
+- `src/runner.rs` : exécution du binaire `aichat`
+- `src/events.rs` : journalisation `shell_ai` dans le journal JSONL
+- `config.yaml` : définition de l'agent `aichat` + alias `ai`
+
+---
+
 ## 📚 Références
 
 - `src/lib.rs:4` : documentation d'architecture du crate