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

# Managed by IssueSpec. Hand edits are welcome; keep the schema valid.
id: 31
title: "Terminal intégré sur le workspace de l'agent"
state: closed
author:
  name: k33g
  email: ph.charriere@gmail.com
createdAt: 2026-10-29T07:20:29.000Z
updatedAt: 2026-10-29T18:17:05.000Z
labels:
  - "kind::feature"
  - "area::workspace"
  - "priority::medium"
  - "size::L"
milestone: "M4 · Workspace des agents"
epic: "Workspace des agents"
related:
  - 13
  - 28
body: |
  ## Contexte
  Draft [#1 — draft](.tickets/issues/0001-draft.yaml) : un terminal qui pointe sur le workspace de l'agent, y compris dans une sandbox sbx ou un container.

  ## Choix
  - xterm.js côté frontend, `Workspace.Exec(tty=true)` côté Go ([#28 — Abstraire le workspace : local, sandbox sbx, container](.tickets/issues/0028-abstraire-le-workspace-local-sandbox-sbx-contain.yaml)) → en local un PTY (`creack/pty`), en container `docker exec -it`, en sbx l'équivalent identifié dans [#28 — Abstraire le workspace : local, sandbox sbx, container](.tickets/issues/0028-abstraire-le-workspace-local-sandbox-sbx-contain.yaml).
  - Flux via le bus d'événements [#13 — Pont d'événements entre Go et le frontend](.tickets/issues/0013-pont-d-evenements-entre-go-et-le-frontend.yaml) (ou un canal dédié si le débit l'exige).
  - Panel repliable, **caché par défaut** pour le citizen user (cf. [#6 — Maquettes UX des panels pour le citizen user](.tickets/issues/0006-maquettes-ux-des-panels-pour-le-citizen-user.yaml)).

  ## Critères d'acceptation
  - [ ] `ls`, `vim`, `htop` fonctionnent (redimensionnement inclus) en local et en container.
  - [ ] Fermer le panel tue le processus shell.
tasks:
  - id: 1
    title: "Intégration xterm.js"
    state: closed
    priority: high
    author:
      name: k33g
      email: ph.charriere@gmail.com
    createdAt: 2026-10-29T07:20:29.000Z
    updatedAt: 2026-10-29T18:17:05.000Z
    closedAt: 2026-10-29T18:17:05.000Z
  - id: 2
    title: "PTY local"
    state: closed
    priority: high
    author:
      name: k33g
      email: ph.charriere@gmail.com
    createdAt: 2026-10-29T07:20:29.000Z
    updatedAt: 2026-10-29T18:17:05.000Z
    closedAt: 2026-10-29T18:17:05.000Z
  - id: 3
    title: "Terminal dans un container"
    state: closed
    priority: medium
    author:
      name: k33g
      email: ph.charriere@gmail.com
    createdAt: 2026-10-29T07:20:29.000Z
    updatedAt: 2026-10-29T18:17:05.000Z
    closedAt: 2026-10-29T18:17:05.000Z
  - id: 4
    title: "Terminal dans une sandbox sbx"
    state: closed
    priority: medium
    author:
      name: k33g
      email: ph.charriere@gmail.com
    createdAt: 2026-10-29T07:20:29.000Z
    updatedAt: 2026-10-29T18:17:05.000Z
    closedAt: 2026-10-29T18:17:05.000Z
  - id: 5
    title: "Redimensionnement (SIGWINCH)"
    state: closed
    priority: medium
    author:
      name: k33g
      email: ph.charriere@gmail.com
    createdAt: 2026-10-29T07:20:29.000Z
    updatedAt: 2026-10-29T18:17:05.000Z
    closedAt: 2026-10-29T18:17:05.000Z
comments:
  - id: 1
    author:
      name: k33g
      email: ph.charriere@gmail.com
    createdAt: 2026-10-29T18:17:05.000Z
    body: |
      ## Résultat

      Onglet **Terminal** : xterm.js 6 côté interface, pseudo-terminal côté Go (`$SHELL -l` en local, `docker exec -it` avec bash ou sh dans un conteneur). Sortie groupée toutes les 16 ms (ou 32 Ko) sans couper un caractère UTF-8 ; la taille suit le panneau (`tput cols`, `stty size` vérifiés) ; `vi` plein écran vérifié dans un conteneur. Le terminal reste ouvert quand on regarde les fichiers ; **quitter la vue termine le shell et tout ce qu'il a lancé**, tâches de fond comprises (toute la session est raccrochée).

      Trouvé en testant : arrêter le client `docker exec` ne termine pas le shell dans le conteneur. Le shell note son pid, et Sidekicks termine sa session côté conteneur en lisant `/proc`. Un test de contrat le vérifie en local et en conteneur.

      **Terminal dans une sandbox sbx : déplacé vers [#39](.tickets/issues/0039-workspace-et-terminal-pour-les-sandboxes-sbx.yaml).**