feat(vscode): extension VS Code native (intégration native, pas un webview)

Nouveau workspace packages/vscode (git-arboretum, privé, non publié sur npm), client REST/WS
réutilisant @arboretum/shared. Auth Authorization: Bearer sur REST et l'upgrade WS (via `ws`) ;
un client Node sans en-tête Origin passe le check Origin strict du serveur.

- Arbres temps réel : Repositories (repos → worktrees → sessions) et Groups, via le WebSocket.
- Terminaux natifs (vscode.Pseudoterminal) pour attacher/observer une session — rendu et
  scrollback de VS Code ; décodage UTF-8 streaming + comptabilité ACK dans des modules purs.
- Status bar (compteur waiting) + notifications natives sur passage en waiting, réponses Yes/No
  via la commande WS answer.
- Mutations git (create worktree, commit, push, promote), start/kill/hide/resume/fork, session
  de groupe ; conscience du workspace (reveal + start/create here).
- Bundle esbuild (format cjs, external vscode) inlinant @arboretum/shared → VSIX autonome.
  Logique réutilisable sans import vscode → testée par vitest (19 tests).
- CI : .gitea/workflows/vscode-release.yml package le VSIX sur tag vscode-vX.Y.Z (artefact +
  asset de release best-effort). build:vscode hors du build principal (comme le site).
- spikes/s5-vscode/STUDY.md : décision de conception (GO phasé A→D), marquée implémentée.
This commit is contained in:
2026-06-23 17:43:03 +02:00
parent 663ae7ace1
commit cf7eb05aca
35 changed files with 6172 additions and 4 deletions

View File

@@ -0,0 +1,85 @@
// Pont d'une session vers un terminal — module pur (aucun import vscode), testable.
// Le ws-client remet des octets BRUTS (un chunk PTY peut couper un caractère UTF-8 en frontière de
// frame, exactement comme côté web où xterm.write(Uint8Array) gérait le décodage). Ici la cible est
// un Pseudoterminal qui veut des `string` → on décode en streaming avec un TextDecoder, et on recrée
// le décodeur à chaque RESYNC pour ne pas traîner une séquence partielle au-delà d'un reset.
import type { ArbWsClient, Attachment, AttachmentSink, DetachReason } from '../api/ws-client.js';
/** Décodeur UTF-8 incrémental : conserve l'octet partiel d'une frontière de frame jusqu'au suivant. */
export class StreamingUtf8Decoder {
private decoder = new TextDecoder('utf-8');
decode(chunk: Uint8Array): string {
return this.decoder.decode(chunk, { stream: true });
}
/** Vide l'état partiel et repart à neuf (appelé sur RESYNC). */
reset(): void {
this.decoder = new TextDecoder('utf-8');
}
}
export interface SessionBridgeCallbacks {
/** texte décodé à écrire dans le terminal. */
onText(text: string): void;
/** RESYNC reçu : le terminal doit se réinitialiser (le texte de replay suit via onText). */
onReset(): void;
onDetached(reason: DetachReason): void;
onControlChanged(controlling: boolean): void;
}
/**
* Relie une session Arboretum à un terminal via le ws-client. Instancié par l'adaptateur
* Pseudoterminal ; reste pur pour être testable avec un faux ws-client.
*/
export class SessionBridge {
private attachment: Attachment | null = null;
private readonly decoder = new StreamingUtf8Decoder();
private detached = false;
constructor(
private readonly ws: ArbWsClient,
private readonly sessionId: string,
private readonly mode: 'interactive' | 'observer',
private readonly cb: SessionBridgeCallbacks,
) {}
/** Ouvre l'attache ; résout quand le canal est établi. Rejette si la session est introuvable. */
async open(cols: number, rows: number): Promise<void> {
const sink: AttachmentSink = {
data: (payload) => {
if (this.detached) return;
const text = this.decoder.decode(payload);
if (text.length > 0) this.cb.onText(text);
},
reset: () => {
this.decoder.reset();
this.cb.onReset();
},
detached: (reason) => {
this.detached = true;
this.cb.onDetached(reason);
},
controlChanged: (c) => this.cb.onControlChanged(c),
};
this.attachment = await this.ws.attach({ sessionId: this.sessionId, mode: this.mode, cols, rows, sink });
}
sendStdin(data: string): void {
this.attachment?.sendStdin(data);
}
resize(cols: number, rows: number): void {
this.attachment?.resize(cols, rows);
}
answer(action: 'select' | 'confirm' | 'deny', optionN?: number): void {
this.attachment?.answer(action, optionN);
}
close(): void {
this.detached = true;
this.attachment?.detach();
this.attachment = null;
}
}