Installer un plugin

La vue Plugins

L’icône en forme de pièce de puzzle de la barre des projets, sous les statistiques, ouvre la vue Plugins en plein écran ; un second clic revient au projet. Réglages › Plugins mène au même endroit.

Sa barre latérale :

• Store : le catalogue de store.escouade.dev, gardé sur ta machine et cherché sur elle (voir plus bas).
• Installés : tous les plugins, en deux groupes, « Ajoutés » et « Livrés avec Escouade ». Une ligne par plugin : sa version, « Non vérifié » ou « En développement », la mise à jour trouvée, d’où il vient, les projets où il est actif (une pastille par projet, un cadenas pour un projet privé) et son interrupteur pour toute l’app.
• Mises à jour : les versions plus récentes trouvées, leur nombre en ambre.
• En développement : les dossiers chargés en place.
• Les catégories : Harness, Sources du Kanban, Hébergeurs de code, Thèmes, Notifications, Autorisations, Outils, Langues, tirées de ce que chaque plugin ajoute.

Installer

Deux boutons en tête de la vue :

• Depuis un dossier… : le dossier du plugin, celui de son escouade-plugin.json. Escouade le copie dans ses données (~/.escouade/plugins/<id>), sans son historique git, et le fixe par l’empreinte SHA-256 de ses fichiers : une copie modifiée ensuite se charge désactivée, et le dit.
• Depuis un dépôt git… : l’adresse du dépôt et une étiquette (v1.2.0). Escouade le clone à cette étiquette seule et le fixe par son commit.

Rien n’est installé tout de suite : le plugin est lu, mis de côté, et la fenêtre d’installation s’ouvre.

Depuis le store

Store, dans la barre latérale, montre le catalogue de store.escouade.dev. Escouade le lit au démarrage puis toutes les 6 heures et le garde sur ta machine : l’en-tête dit quand (« catalogue lu à 10:42 ») et, si le store ne répond pas, montre le catalogue gardé en le disant.

• La recherche se fait sur ta machine, sans rien envoyer : le nom, la description, les mots-clés, l’auteur et l’id, sans tenir compte de la casse ni des accents. Vérifiés seulement ne garde que les plugins au sceau « Vérifié par Escouade » ; les puces et la barre latérale filtrent par catégorie.
• Pour <projet>, en tête : jusqu’à trois plugins qu’Escouade propose d’après ce qu’il voit sur ce poste et dans le projet ouvert, chacun avec sa raison (« vibe est installé sur ce poste », « des clés DEM-… dans les commits de ce dépôt »). Rien n’en est envoyé. « Pas maintenant » écarte une proposition une semaine, « Ne plus proposer » pour de bon.
• Chaque ligne dit le sceau de la version proposée ou « Non vérifié », l’auteur, les installations et ce que le plugin demande en une ligne (« Lance un programme », les hôtes, « Un secret », ou « Sans programme »).
• La page d’un plugin du store : sa description, ses permissions, ses versions (chacune vérifiée ou non, retirée par son auteur), le résumé de la revue, d’où il vient, et « Signaler sur le store ».

Escouade propose la dernière version qu’il peut faire tourner : une version écrite pour une Escouade plus récente est sautée, une version retirée par son auteur aussi.

Installer télécharge la version, puis vérifie tout avant d’ouvrir la fenêtre d’installation : version.json contre l’empreinte du catalogue, la signature contre les clés publiques qu’Escouade embarque (le store ne peut pas fabriquer un sceau : il n’a pas la clé), l’archive et son module contre version.json, le manifeste contre son empreinte. Un écart arrête tout et le dit (« L’archive reçue ne correspond pas à celle que le store a publiée ») : rien n’est installé. Le catalogue, les archives et la liste de révocation passent par Réglages › Réseau (proxy, certificats du système).

La fenêtre d’installation dit alors « Vérifié par Escouade » et « Signature : vérifiée ici, par l’app » ; pour une version non vérifiée, une bande : « Personne n’a relu cette version. Elle vient du store, son archive est bien celle que l’auteur a publiée, mais rien ne dit ce que fait son programme », et le bouton « Installer quand même ».

N’installer que des versions vérifiées, en tête des installés (éteint d’office), refuse toute version du store sans sceau, à l’installation comme à la mise à jour.

Un plugin installé depuis un dossier ou un dépôt git dont l’id est au store le dit sur sa page, avec « Passer à la v… du store » : la même fenêtre, tes choix gardés.

Ouvrir dans Escouade, sur la page d’un plugin de store.escouade.dev, est un lien escouade://plugin/<id> : il lance Escouade, ou la ramène au premier plan si elle est ouverte, sur la page du plugin dans la vue Plugins (sa page d’installé s’il l’est déjà). Un lien n’installe jamais rien : l’installation reste ton geste, depuis la page, dans la fenêtre qui montre ses permissions. Un lien qu’Escouade ne sait pas lire est dit (« Lien Escouade illisible, rien n’a été fait »), un plugin que le catalogue n’a pas aussi, et rien d’autre ne se passe. L’installeur enregistre le lien auprès du système (Windows, macOS, le .deb sous Linux) ; une AppImage l’enregistre elle-même à son démarrage.

La fenêtre d’installation

Elle dit, avant que rien ne soit installé :

• qui l’a fait : son nom, son auteur, sa version, sa licence et son id ;
• d’où il vient : le dossier, ou le dépôt et l’étiquette ; sa version et son commit ; son empreinte ; sa signature, « Aucune » hors du store. Un plugin hors du store est non vérifié : personne ne l’a relu, et la fenêtre le dit en tête ;
• ce qu’il ajoute : ses thèmes, ses harness, ses webhooks, ses réglages…, et où les trouver ;
• ce qu’il pourra faire, permission par permission, la plus forte d’abord :

« Installer quand même » installe le plugin ; « Annuler » efface ce qui avait été mis de côté. Un manifeste qui ne tient pas n’ouvre pas la fenêtre : la raison s’affiche en tête de la vue, champ par champ (voir le manifeste).

Les plugins livrés avec Escouade

Certaines intégrations d’Escouade sont des plugins, livrés avec l’app, signés et mis à jour avec elle : la vue Plugins les range sous « Livrés avec Escouade », avec la même page que les autres (ce qu’ils ajoutent, leurs permissions, leur journal). Ils sont actifs partout d’office, projets privés compris, comme quand ils faisaient partie de l’app.

• Les couper : leur interrupteur, pour toute l’app, ou leur onglet Projets, pour un projet. Rien de ce qu’ils ont fait n’est perdu, et tes choix sont gardés pour quand tu les rallumes.
• Ce qui se voit : un hébergeur coupé ou arrêté ne suit plus les PR, et la carte de l’agent comme Réglages › Intégrations le disent ; une source coupée arrête sa synchro, qui dit pourquoi ; un service de voix coupé quitte Réglages › Voix, et la dictée repasse en local ; les agents d’un harness ACP restent, marqués « Harness absent ».
• Pas de désinstallation, ni de mise à jour à part : ils changent avec l’app. Un plugin d’un autre auteur ne peut pas prendre leur identifiant (dev.escouade.* est réservé) ; il peut servir le même service à côté d’eux, et c’est le compte qui dit lequel le sert.

Activer pour l’app ou par projet

• Pour toute l’app : l’interrupteur de sa ligne, ou « Désactiver » sur sa page. Désactivé, rien de lui ne tourne et aucun projet ne le reçoit ; son process est arrêté.
• Par projet : l’onglet Projets de sa page, une ligne par projet ouvert. Un plugin installé est actif dans chaque projet, sauf les projets privés : un projet privé est coupé d’office, et la ligne le dit (« rien ne lui parvient »). L’y activer est un choix fait un par un ; la ligne rappelle alors qu’Escouade ne peut pas empêcher un programme de lire le disque.

Retirer une permission

L’onglet Permissions de sa page liste ce qu’il peut faire, avec un interrupteur par permission. En retirer une arrête son process ; le suivant démarre sans elle, et le plugin continue, ou s’arrête s’il ne peut pas. Un secret retiré ne lui est plus donné : secrets/get lui répond une erreur pour cette clé. Le programme lui-même ne se retire pas : pour l’arrêter, désactive le plugin.

Ses réglages et ses secrets

L’onglet Réglages montre les champs qu’il déclare (contributes.settings, contributes.secrets). Un réglage est gardé avec la liste des plugins installés et lui est donné par settings/get ; dans un projet dont le .escouade.yml règle le plugin (plugins.<id>), la valeur du projet passe devant. Un secret va au trousseau du système, sous un nom à lui (plugin:<id>:<clé>) : l’onglet dit seulement s’il est gardé, et « Oublier » l’efface.

Le journal

L’onglet Journal montre où en est son process (prêt, en marche, relancé après un plantage, arrêté après trois plantages, arrêté pour sa mémoire…) et les 500 dernières lignes de son journal : ses démarrages, ses arrêts et leur raison, ses plantages, sa sortie d’erreur, ses messages, les appels restés sans réponse et ce qui lui a été refusé. Il est relu toutes les deux secondes, se filtre par genre et se copie en entier. Les secrets qu’il a reçus y sont masqués.

• Démarrer lance un plugin qui n’a pas encore tourné (il démarre seul à sa première activation).
• Relancer relance un plugin arrêté, ses plantages oubliés.

Le fichier du journal est ~/.escouade/plugin-logs/<id>.log (le protocole).

Les mises à jour

Au démarrage, Escouade cherche une version plus récente de chaque plugin : une étiquette plus haute de son dépôt git, une version plus haute dans le dossier d’où il a été copié, la dernière version compatible du catalogue pour un plugin du store (« v1.3.0 · non vérifiée » quand elle n’a pas de sceau). Ce qu’il trouve est proposé, jamais installé seul : « v1.3.0 disponible » sur sa ligne, « Mettre à jour vers la v1.3.0 » sur sa page, la liste dans Mises à jour, et « Tout mettre à jour » en tête des installés.

Une mise à jour passe par la fenêtre d’installation, de la version installée à la nouvelle. Si elle demande plus, la fenêtre le dit (« ton accord est redemandé ») et marque « nouveau » chaque permission en plus. Tes choix restent : ses projets, les permissions retirées, ses réglages et ses secrets. « Tout mettre à jour » ouvre la fenêtre de chacune, l’une après l’autre.

Le retrait par Escouade

Escouade lit la liste de révocation du store au démarrage puis toutes les 6 heures (ou « Relire maintenant », en bas des installés), la vérifie avec ses clés et refuse une liste plus ancienne que la dernière lue ; si le store ne répond pas, il lit sa copie sur escouade.dev. La dernière liste lue s’applique même hors ligne.

• Une version retirée est arrêtée et désactivée ; une bande rouge en tête des installés dit laquelle, quand et pourquoi. Escouade ne supprime rien : ses réglages et ses secrets restent là, et « Désinstaller » est sur sa page.
• Une version dont le sceau est retiré continue de tourner ; sa page dit pourquoi elle n’est plus vérifiée.

Le sceau d’un plugin installé est revérifié sur ta machine, avec le version.json et la signature gardés à l’installation : il tient sans le store.

Désinstaller

« Désinstaller », sur sa page, arrête son process et efface son dossier, ses réglages, ses secrets et son journal. La case « Garder ses réglages et ses secrets pour une prochaine installation » les garde : réinstallé, le plugin les retrouve. Un dossier en développement reste où il est.

Le mode développeur

En développement, « Charger un dossier… » lit le dossier d’un plugin où il est, sans copie ni empreinte, et le relit dès qu’un fichier change. Son journal se lit en direct dans l’onglet Journal. Voir le manifeste et le protocole pour l’écrire.