Documentation

Deskworth est une application de bureau qui pilote les outils en ligne de commande de fournisseurs auxquels vous vous connectez vous-même, sous les conditions de chacun. Ce n’est pas un modèle, il n’en revend aucun, et il ne détient jamais la connexion de votre CLI : chaque CLI garde sa propre session. Cette page est la carte ; chaque guide en documente une partie contre une version nommée.

#Quatre états, et aucun n’est une promesse

Chaque page de cet espace porte un état, et chaque capacité à l’intérieur d’une page aussi. L’échelle n’arrondit jamais vers le haut : sans preuve que quelqu’un l’a regardée tourner, une capacité est disponible au mieux, jamais vérifiée.

• VÉRIFIÉVÉRIFIÉObservé sur une vraie machine, et la page dit quand. La date fait partie de l’affirmation.
• DISPONIBLEDISPONIBLELivré dans la construction courante et appelable. Personne ne l’a regardé pendant cette passe, donc la page ne dit pas le contraire.
• APERÇUANNONCÉÉcrit et couvert par des tests dans le cœur, mais rien de ce que fait un opérateur ne l’atteint encore.
• PRÉVUPRÉVURien n’est écrit. La page existe pour dire précisément ce qui manque, pas pour laisser croire que c’est presque là.

#La forme d’une exécution

1. Une question arrive au rôle hôte, qui aiguille au lieu d’exécuter.
2. L’aiguillage convoque les rôles que la question réclame, et, quand un livrable est nommé, le rôle qui possède ce format.
3. Chaque rôle convoqué devient une carte. Une carte pilote un CLI d’éditeur sans interface, dans son propre atelier isolé.
4. La carte émet une trace : une ligne par phase, par outil, par processus. Jamais un résumé. La sortie brute du processus reste accessible en dessous, avec la ligne de commande exacte.
5. Les outils sont servis à la carte par un serveur local sur l’adresse de bouclage, filtrés par les capacités que le rôle déclare.
6. Ce que la carte produit, un module graphique, un classeur, un résultat bloqué, est déposé avec sa provenance.
7. L’hôte recoud le bureau et le résultat porte sa piste.

#Les registres

Quatre choses sont des registres, et un registre a exactement un domicile. Ajouter une entrée ailleurs est un défaut, pas un raccourci.

PreuveCe site en recopie trois, rôles, fournisseurs et outils, au lieu de les redire 4. La référence des outils est engendrée à la construction depuis le registre du cœur, donc un outil retiré du serveur disparaît de cette documentation sans que personne n’ait à penser à l’effacer.

#Où aller ensuite

• Commencer, d’un Mac neuf à une première exécution.
• Architecture, l’arbre de processus, les ateliers isolés, le serveur d’outils local.
• Brancher un fournisseur, les trois CLIs, leurs portes de connexion, et les dix états d’une connexion.
• MCP, les deux sens, et celui qui n’existe pas encore.
• Référence de l’API, chaque outil, sa capacité, ses paramètres et les rôles qui le tiennent.
• Sécurité, chaque garantie rattachée à ce qui la tient.