# Brief Dev — Lot D4 : commandes Tauri + bridge chat (§17.9)

> Demandé par **Main** à **DevBackend** (dev) + **QA** (test). Cycle §3 : code → tests → vert.
> Périmètre **backend uniquement** (`app-tauri`). Le frontend chat est D5, hors périmètre ici.

## 0. Où on en est

Le fil §17 (exécution structurée des agents IA via le port `AgentSession`) est livré
jusqu'à **D3 inclus** :

- **D0/D1** (`5e10b5e`) : port `domain::ports::AgentSession` + `AgentSessionFactory`,
  `ReplyEvent`/`ReplyStream`/`AgentSessionError`, champ `AgentProfile.structured_adapter`,
  registre `StructuredSessions`, agrégateur `LiveSessions`, helper `send_blocking`.
- **D2** (`751d94d`) + spikes **S1/S2** (`f104862`) : adapters `ClaudeSdkSession` /
  `CodexExecSession` dans `crates/infrastructure/src/session/`, fake CLI + harnais de
  conformité, **formats réels** Claude `stream-json` / Codex `exec --json` câblés.
- **D3** (`56913b9`) : `LaunchAgent` route structuré vs PTY ; `LaunchAgentOutput` porte
  désormais `structured: Option<StructuredSessionDescriptor>`.

**D4 = exposer tout ça à l'UI** : commandes Tauri + pont de streaming, jumeau exact du
chemin PTY existant. Aucun chemin PTY (terminal non-IA) ne doit changer ni régresser.

## 1. Périmètre D4 (réf. §17.7 et tableau §17.9)

À livrer dans `crates/app-tauri/src/` :

1. **`ChatBridge`** — jumeau de `PtyBridge` (`crates/app-tauri/src/pty.rs`), **generation-tracked**
   (même mécanique de génération pour éviter la double-pompe lors d'une ré-attache). Il pompe
   un `ReplyStream` (events `ReplyEvent` du port) vers un `tauri::ipc::Channel`, en émettant
   des `ReplyChunk` (DTO ci-dessous). Vit à côté de `PtyBridge`, ne le remplace pas.
2. **Commandes Tauri** :
   - `agent_send(sessionId, prompt)` → pompe les `ReplyEvent` du tour sur le `Channel`
     (deltas `TextDelta` → chunks, `ToolActivity` → chunks d'activité, `Final` → chunk final
     qui fige le tour). S'appuie sur le registre `StructuredSessions` / `send_blocking` côté
     application (déjà livré en D1).
   - `reattach_agent_chat(...)` → renvoie le scrollback de conversation + rebranche le `Channel`
     (repeint sans re-spawn ; supersede l'ancienne génération).
   - `close_agent_session(sessionId)` → `shutdown` (polymorphe) + unregister du registre.
3. **DTO** (`crates/app-tauri/src/dto.rs`) :
   - `ReplyChunk` : variantes delta texte / activité outil / final (sérialisation camelCase,
     cohérente avec les DTO existants).
   - `ReattachChatDto`.
   - **`cellKind`** ajouté au DTO de session (terminal `pty` vs chat `chat`), dérivé de la
     présence d'un descripteur structuré (`LaunchAgentOutput.structured`).
4. **Wiring composition root** (`state.rs`/`lib.rs`) : injecter les dépendances nécessaires,
   enregistrer les nouvelles commandes. **Aucun `new ClaudeSdkSession` ici** — passe par la
   factory déjà injectée (règle D du §17.8).

## 2. Contrat / invariants à respecter

- **Generation supersede** : une ré-attache invalide l'ancienne pompe ; pas de double émission.
- **`cellKind`** est la seule info dont D5 (frontend) a besoin pour router cellule chat vs
  terminal. Stable et explicite au DTO.
- **Isolation parsing** : D4 ne parse aucun format CLI — il consomme des `ReplyEvent` typés.
- **Zéro régression PTY** : le chemin terminal brut (`PtyBridge`, commandes terminal) reste
  identique. Les tests PTY existants restent verts.
- Frontières hexagonales (§17.8) : `app-tauri` dépend des ports/registres application, jamais
  des adapters infra concrets.

## 3. Tests attendus (QA — réf. colonne « Tests attendus » D4 du §17.9)

Crate `app-tauri` (fakes pour la session structurée, pas de vrai CLI) :

- `agent_send` pompe les events d'un tour sur le `Channel` (séquence deltas… puis `Final`).
- ré-attache → scrollback conversation repeint, **sans** re-spawn de session.
- `close_agent_session` → `shutdown` appelé **et** unregister du registre.
- **generation supersede** : après ré-attache, l'ancienne génération ne pompe plus (pas de
  double émission sur le `Channel`).
- DTO : `cellKind` = `chat` pour une sortie `LaunchAgentOutput` avec `structured: Some(..)`,
  `pty` sinon ; round-trip `ReplyChunk` (camelCase).
- non-régression : un DTO de session PTY existant sérialise toujours pareil (le nouveau champ
  `cellKind` ne casse pas les snapshots — vérifier la valeur par défaut/dérivée).

## 4. Méthode

Cycle §3 strict : DevBackend code → QA écrit + exécute les tests → vert avant de clore.
Rapport d'erreurs clair si rouge → correction → re-test. Commit `feat(agent): … (D4) — §17`
quand `cargo test --workspace` est vert. **Ne pas push** (validation Main requise).

## 5. Références code

- Jumeau à copier : `crates/app-tauri/src/pty.rs` (`PtyBridge`, generation tracking).
- Source du flux : `domain::ports::{AgentSession, ReplyEvent, ReplyStream}` ;
  registre/`send_blocking` : `crates/application/src/agent/structured.rs`.
- Routage déjà fait : `crates/application/src/agent/lifecycle.rs`
  (`LaunchAgentOutput.structured`).
- DTO existants : `crates/app-tauri/src/dto.rs` ; commandes : `crates/app-tauri/src/commands.rs`.
- Spec complète : `ARCHITECTURE.md` §17.7 (commandes & DTO) et tableau §17.9 ligne **D4**.
