# ADR LS5 — Borne du résumé de handoff & seam résumeur LLM

Statut : accepté (lot LS5, branche `feature/agent-live-state`).

## Contexte

Le résumé de reprise (`Handoff::summary_md`) est injecté dans le contexte d'un agent
à **chaque lancement** et persisté à **chaque checkpoint**. Sans borne, un gros tour
`Response` produit une ligne géante qui gonfle le résumé → coût sur le **chemin chaud**
(append/checkpoint + contexte injecté). Priorité produit : gagner en perf **sans** mettre
de LLM sur ce chemin chaud.

## Décision (implémentée)

1. **Borne par ligne (infra)** : `render_turn` tronque le texte aplati de chaque tour à
   `TURN_LINE_MAX_CHARS = 240` (élision `…`), préfixe `- **role:**` conservé. Correctif
   central du trou de perf.
2. **Borne universelle (domaine)** : `bound_handoff_summary(h, HANDOFF_SUMMARY_MAX_CHARS=4096)`,
   pure, idempotente, sans rejet — garde l'objectif + le suffixe de tours le plus récent,
   droppe les plus anciens, hard-truncate la fin d'une ligne trop longue sans casser son
   préfixe. `up_to`/`objective` jamais modifiés.
3. **Application** : la borne universelle est posée **entre `fold` et `save`** (écriture)
   et **avant `compose_convention_file`** (injection, protège les `handoff.md` legacy).
   Indépendante du résumeur.

## Seam LLM — futur, NON implémenté

Le port `HandoffSummarizer::fold` reste **inchangé** (async, sans `Result`, best-effort) ;
le défaut câblé reste `HeuristicHandoffSummarizer`. Un futur `LlmHandoffSummarizer` devra
respecter le contrat suivant :

- **Hors chemin chaud, déclenchement froid** : jamais par tour. Calcul à la reprise / à la
  rotation / sur débounce (coalescer plusieurs tours rapides), pas à chaque `record`.
- **Timeout + fallback heuristique** : un appel réseau lent/échoué retombe sur le résumé
  heuristique (ou `prev`), jamais d'erreur propagée, jamais de blocage du checkpoint.
- **Sélection par flag**, défaut **heuristique** (zéro dépendance réseau par défaut).
- La **borne universelle** s'applique de toute façon à sa sortie (garantie indépendante
  du résumeur).
