MAX_SORTIE = 20_000                                   # caractères renvoyés au modèle par appel
COMMANDES_AUTORISEES = {"diff", "show", "ls-files"}   # aucune commande qui écrit


def git(depot: str, *args: str) -> str:
    """Exécute une commande git AUTORISÉE, sans shell, avec délai maximal et sortie tronquée."""
    if args[0] not in COMMANDES_AUTORISEES:
        raise PermissionError(f"commande git interdite : {args[0]}")
    r = subprocess.run(["git", "-C", depot, "--no-pager", *args],
                       capture_output=True, text=True, timeout=20, check=True)
    return r.stdout[:MAX_SORTIE] + ("\n[... tronqué]" if len(r.stdout) > MAX_SORTIE else "")

if base.startswith("-") or cible.startswith("-"):
    raise ValueError("référence git invalide")       # empêche d'injecter une option git
...
session = await runner.session_service.create_session(
    app_name="revue", user_id="u1", state={"depot": depot, "base": base, "cible": cible})

def _verifier_fichier(ctx: ToolContext, fichier: str) -> str | None:
    """Garde-fou : seul un fichier du diff est lisible (pas de ../, pas d'option git injectée)."""
    s = ctx.state
    if fichier not in fichiers_modifies(s["depot"], s["base"], s["cible"]):
        return f"refusé : {fichier!r} ne fait pas partie des fichiers modifiés"
    return None


def lister_fichiers_modifies(tool_context: ToolContext) -> dict:
    """Liste les fichiers modifiés entre la base et la cible, avec leur statut (A ajouté, M modifié, D supprimé)."""
    s = tool_context.state
    return {"fichiers": git(s["depot"], "diff", "--name-status", s["base"], s["cible"])}


def lire_diff(fichier: str, tool_context: ToolContext) -> dict:
    """Renvoie le diff unifié d'un fichier modifié. Les lignes ajoutées commencent par +."""
    if refus := _verifier_fichier(tool_context, fichier):
        return {"erreur": refus}
    s = tool_context.state
    return {"diff": git(s["depot"], "diff", "-U3", s["base"], s["cible"], "--", fichier)}


def lire_fichier(fichier: str, tool_context: ToolContext) -> dict:
    """Renvoie le contenu complet d'un fichier modifié dans sa version cible, lignes numérotées."""
    if refus := _verifier_fichier(tool_context, fichier):
        return {"erreur": refus}
    s = tool_context.state
    texte = git(s["depot"], "show", f"{s['cible']}:{fichier}")
    return {"contenu": "\n".join(f"{i:>4} {l}" for i, l in enumerate(texte.splitlines(), 1))}

  outil lister_fichiers_modifies({})
  outil lire_diff({'fichier': 'app/panier.py'})
  outil lire_fichier({'fichier': 'app/panier.py'})
  outil lire_diff({'fichier': 'app/utilisateurs.py'})
  outil lire_fichier({'fichier': 'app/utilisateurs.py'})