Espace de travail

L’espace de travail est un document sérialisable ordinaire. Tout ce que la fenêtre affiche en dérive, et tout ce qu’un agent lit en est un résumé borné.

Modèle

interface WorkspaceState {
  version: 1;
  active: string;                 // id de l'onglet actif
  tabs: Tab[];
  pinned: string[] | null;        // null = toutes les extensions épinglées
  installedExtensions?: string[];
  seededCore?: string[];
  extensions?: Record<string, unknown>; // état sauvegardé par chaque extension
  theme: "dark" | "light" | "transparent";
}

type Mode = "side" | "tiling" | "stack";

interface Tab {
  id: string;
  name: string;
  mode: Mode;
  tiles: Tile[];
  layouts: Partial<Record<Mode, unknown>>;
  focused?: string;
}

interface Tile {
  id: string;
  type: string;
  data: Record<string, string>;
}
  • Tile.data ne contient que des chaînes : le document reste sérialisable et borné.
  • extensions est indexé par identifiant d’extension et contient ce que l’extension a enregistré via api.state.save().
  • Les paquets installés et les sources de dépôt ne sont pas dans l’espace : ils vivent dans extensions.json.

Trois modes

  • Side — les tuiles côte à côte.
  • Tiling — disposition libre dockview : glisser un onglet sur un bord divise, au centre regroupe, glisser un séparateur redimensionne.
  • Stack — les tuiles empilées verticalement.

Chaque onglet garde une disposition par mode : changer de mode ne recrée jamais une tuile, ce qui compte puisqu’une session terminal meurt avec sa tuile.

Cycle de vie d’une tuile

  • prepare(data) normalise les données initiales à l’ouverture.
  • dataKeys limite les clés acceptées.
  • describe(tile, surface) renvoie un résumé d’une ligne pour le brief ; il ne doit pas lever.
  • canClose(tile, closing) peut refuser une fermeture, par exemple pour un document non enregistré.
  • close(tile) libère ce que la tuile détient : session, fichier, écouteur.

Désactiver une extension la retire de installedExtensions mais laisse ses tuiles dans l’espace ; leur vue devient indisponible. La réactivation les restaure avec leurs données.

Journal

src/core/journal.ts garde 512 entrées en mémoire. Chaque entrée porteseq, at, source (human,agent ou system), un kind et éventuellementtabId, tileId et data.

Le journal ne remplace pas l’état : il raconte les changements. Il est borné parsummarize — chaînes coupées à 160 caractères, profondeur 2 — pour qu’une entrée ne transporte jamais un document ou une sortie de terminal.

Un agent reprend depuis un numéro de séquence avec spark_events_since.

Brief

src/core/brief.ts construit un résumé d’un onglet : ses tuiles, leurs titres, leurs lignes describe, les événements récents et les autres onglets. Le texte est plafonné à 1 400 caractères et chaque résumé à 120. Les événements bruyants commetile.focus et tab.reorder sont filtrés.

Persistance

~/Library/Application Support/fr.spark.desktop/
  workspace-v1.json      onglets, tuiles, dispositions, état, thème
  workspace-recovery.json copie écrite lors d'une reprise de format invalide
  settings-v1.json       { "dev": boolean }
  extensions.json        paquets installés, versions, sources de dépôt
  extensions/<id>/<version>/
  markdown-access.json   jetons des fichiers Markdown autorisés
  explorer-access.json   jetons des dossiers autorisés
  run/mcp.sock           socket MCP
  run/tools.json         cache de la liste d'outils pour le pont
  ~/Library/Caches/fr.spark.desktop/pdf/<id>.pdf
  • workspace-v1.json est écrit après un debounce de 180 ms.
  • Les écritures sont sérialisées : une écriture plus ancienne ne peut jamais écraser une plus récente.
  • Sur un format invalide, le runtime repart d’un espace neuf et marque recovery ; la première sauvegarde copie l’ancien fichier dans workspace-recovery.json au lieu de le détruire.
  • La fermeture de la fenêtre attend persistence.flush() avant de la détruire.
  • Le dossier fr.lab.desktop d’avant le renommage est repris au premier lancement, sans écraser les fichiers existants.

Annuler

⌘Z et ⇧⌘Z annulent et rétablissent les opérations de disposition : déplacements et redimensionnements, y compris ceux qu’un agent a lancés viaspark_tile_move et spark_tile_resize. L’historique est propre à l’onglet et au mode, et ne touche jamais au contenu des tuiles.