Dérouler les scénarios de bout en bout (v0.1)

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102

# Dérouler les scénarios de bout en bout (v0.1)

Ce guide déroule les six scénarios qui valident une release avec les vrais agents de test (ticket #34), puis les vérifications de ce que la v0.1 a ajouté. Il suppose un Mac avec `mm`, llmman démarré, les modèles des quatre agents de test téléchargés, et Sidekicks construit depuis le tag de la release (`make package-macos`, ou `make dev`).

Deux agents au plus tournent en même temps (`limits.maxRunningAgents: 2`). Entre deux scénarios, déchargez tous les modèles, pour que chaque scénario parte à froid :

```bash
scripts/agents.sh unload --all
scripts/agents.sh ps        # aucun modèle chargé
```

Les libellés cités sont ceux de l'interface en anglais (la langue par défaut).

## 0. Préparer

1. `make install-test-config` (les quatre agents de test à l'emplacement par défaut ; le fichier précédent est gardé en sauvegarde).
2. Ouvrez Sidekicks. Sous **AGENTS** : Alice, Bob, Riker, Garfield, tous « stopped ».
3. Ouvrez le [rapport](#rapport) ci-dessous dans un éditeur de texte, pour le remplir au fur et à mesure.

## 1. Alice — conversation simple, Markdown, annulation

1. Cliquez sur **Alice (assistant)**, envoyez : `Donne un tableau markdown de 2 lignes (nom, rôle) puis un bloc de code Go qui affiche hello.`
2. Attendu : la réponse s'affiche au fil de l'eau ; un tableau et du code Go en couleurs avec **Copy**.
3. Envoyez : `Écris un poème de 40 vers sur la mer.` et cliquez sur **■ Stop** après quelques lignes.
4. Attendu : la réponse s'arrête et finit par « Answer stopped. » ; Alice repasse à « ready ».

## 2. Alice + Bob — channel multi-agents, routage, contexte partagé

1. Créez un channel `#e2e` (**⌘N**). Envoyez : `@alice donne un prénom pour un chat roux.`
2. Attendu : « Alice (assistant) joined the channel. » puis sa réponse avec un prénom.
3. Envoyez : `@bob que penses-tu du prénom proposé par Alice ?`
4. Attendu : Bob rejoint le channel et reprend le prénom donné par Alice : il a reçu les messages qu'il n'avait pas vus.
5. Envoyez un message sans mention : attendu, le dernier agent qui a parlé (Bob) répond.

## 3. Riker — tool calls, permissions

1. Déchargez les modèles. Cliquez sur **Riker (tools)**, envoyez : `Crée le fichier e2e.txt contenant "ok", puis liste le dossier.`
2. Attendu : une carte de permission en phrases claires. Cliquez sur **Allow once** : la carte de l'outil passe à ✓, `e2e.txt` est listé.
3. Envoyez : `Supprime e2e.txt.` Cliquez sur **Reject once**.
4. Attendu : Riker dit qu'il n'a pas pu ; le fichier est toujours là (📂 → Files).

## 4. Garfield — commandes slash et skills

1. Déchargez les modèles. Cliquez sur **Garfield (translator)**, tapez `/`.
2. Attendu : « Asking Garfield (translator) for their commands… » puis les commandes et skills de Garfield (`idioms`, `styles`…).
3. Choisissez `/idioms` (Tab), ajoutez `il pleut des cordes`, envoyez.
4. Attendu : la réponse explique l'expression avec un équivalent anglais.

## 5. Garfield + Bob — `/garfield:commande` dans un channel

1. Déchargez les modèles. Dans `#e2e`, invitez Garfield (**+ Invite**), puis tapez `/gar`.
2. Attendu : `/garfield:idioms`, `/garfield:styles`… listés avec leur agent.
3. Envoyez `/garfield:styles Bonjour à tous`. Attendu : seul Garfield répond.
4. Envoyez `@bob traduis la première version de Garfield en espagnol.` Attendu : Bob répond à partir du texte de Garfield.

## 6. Alice — redémarrage et reprise

1. Quittez Sidekicks (⌘Q) pendant que rien ne répond. Rouvrez-le.
2. Attendu : `#e2e` et les conversations directes sont là avec leurs messages ; les agents sont « stopped ».
3. Dans la conversation d'Alice, envoyez : `Quelle était ma première question ?`
4. Attendu : Alice répond à partir de l'échange précédent (sa session a été reprise, ou l'historique lui a été redonné).

## 7. Ce que la v0.1 a ajouté

| # | Vérification | Attendu |
| --- | --- | --- |
| 7.1 | `mv ~/Library/Application\ Support/sidekicks ~/sidekicks-backup`, ouvrez Sidekicks | Écran d'accueil : logo, trois étapes, **＋ Add my first agent** |
| 7.2 | Ajoutez Alice avec l'assistant (programme `mm`, arguments `-acp -config agent.yaml`, dossier `agents/alice`) | Sa conversation s'ouvre ; Settings montre son entrée, les commentaires du fichier sont gardés |
| 7.3 | Ajoutez un agent dont le programme est `nothere`, démarrez-le (▶) | « The program "nothere" cannot be found… », avec **Technical details** replié |
| 7.4 | Ajoutez un agent dans un conteneur qui n'existe pas, démarrez-le | Une phrase sur le conteneur manquant |
| 7.5 | ⌘K, tapez `ali`, Entrée ; ⌘N ; ⌘L ; ⌘, ; ⌘J ; ⌘B ; ⇧⌘N | Chacun fait ce que dit [Raccourcis clavier](../reference/raccourcis-clavier.md) |
| 7.6 | Parcourez la fenêtre avec Tab | L'élément qui a le focus est toujours entouré |
| 7.7 | Ouvrez le `.app` installé depuis le `.dmg` **depuis le Finder**, démarrez Alice | Elle démarre : `mm` est trouvé sans chemin complet (le PATH du shell) |
| 7.8 | Remettez la sauvegarde : `rm -r ~/Library/Application\ Support/sidekicks && mv ~/sidekicks-backup ~/Library/Application\ Support/sidekicks` | Vos agents et votre historique sont de retour |

## Rapport

Copiez ceci dans un commentaire du ticket #34 et remplissez-le :

```markdown
## Rapport de bout en bout — Sidekicks <version>, <date>

Mac : <modèle, RAM>, macOS <version> · mm <version> · build : <dmg | make dev>

| # | Scénario | Résultat | Notes |
| --- | --- | --- | --- |
| 1 | Alice : conversation, Markdown, annulation | ✅ / ❌ | |
| 2 | Alice + Bob : channel, routage, contexte partagé | ✅ / ❌ | |
| 3 | Riker : outils, autoriser / refuser | ✅ / ❌ | |
| 4 | Garfield : commandes / et skills | ✅ / ❌ | |
| 5 | Garfield + Bob : /garfield:commande dans un channel | ✅ / ❌ | |
| 6 | Alice : redémarrage et reprise | ✅ / ❌ | |
| 7 | Vérifications v0.1 (7.1–7.8) | ✅ / ❌ | |

Modèles déchargés entre les scénarios : oui / non
```

## Voir aussi

- [Lancer les tests](lancer-les-tests.md) — les tests automatiques, avec et sans vrais agents
- [scripts/agents.sh](../reference/script-agents.md)
- [Publier une release](publier-une-release.md)