Notes de version
Touba 1.4.0
Le langage, le runtime et les SDK JavaScript et Python passent à 1.4.0. L’extension VS Code correspondante est 1.0.6.
Packages et approbations
L’application conserve les approbations minimales des outils importés. Une mise à jour qui modifie le contrat de gouvernance demande une revue explicite. L’acceptation du package conserve les exigences de l’application et les permissions accordées par l’hôte.
Les traces relient les appels aux versions et empreintes des packages, au verrou admis et à la demande d’approbation. Elles conservent aussi une référence pseudonymisée du signataire et son rôle attesté.
Préparation et confinement
- Un projet neuf avec packages et fragments se prépare avec un seul
write, suivi decheck. - Les modifications de fragments apparaissent dans le plan. Leurs empreintes
de comparaison sont conservées dans
touba.project.jsonet se versionnent. touba sdk sandbox pythonprépare l’inventaire d’un handler Python à relire. macOS et Linux conservent son environnement virtuel et les accès explicitement accordés. Les bibliothèques partagées de Python sous Linux sont inventoriées.- Les SDK conservent les diagnostics précis d’intégrité et d’admission.
Le confinement des handlers est activé explicitement avec sandbox.required.
Le backend Windows reste prévu pour une évolution ultérieure.
Prise en main
La documentation propose un parcours guidé. Les erreurs de lecture d’AIR indiquent comment vérifier le fichier compilé et le projet sélectionné. Les changements enregistrés sont visibles après la fin de la compilation dans les commandes suivantes et dans Explorer.
Migrer depuis 1.3.1
Conservez les données et traitez les opérations suspendues avec leur build d’origine. Mettez à jour la CLI, puis les SDK de chaque projet :
touba update
touba sdk install javascript
touba sdk install python --manager uv
touba prepare --mode plan
touba prepare --mode write
touba prepare --mode check
Installez uniquement les SDK utilisés par l’application. Relisez puis versionnez
package_contracts, tool_policies et fragment_baselines dans la configuration
du projet. Si un ancien fragment diverge déjà, suivez la
réconciliation documentée.
Régénérez les inventaires de confinement sur chaque machine et rejouez les
tests métier. Les règles de validation et d’unicité des paiements appartiennent
toujours au service métier.
Touba 1.3.1
Cette mise à jour réunit les nouveautés et correctifs depuis Touba 1.1.0. Le runtime et les SDK JavaScript et Python sont alignés sur 1.3.1 ; l’extension VS Code correspondante porte le numéro 1.0.5.
Approbations et gouvernance
- Un outil peut exiger l’approbation de ses arguments exacts, avec rôle requis, délai et séparation des signataires. Cette exigence suit aussi les imports, les skills et les appels sélectionnés par un agent.
- Un appel protégé consomme une seule unité du budget d’outils, même après une pause et une reprise pour approbation.
- Les handlers reçoivent la provenance du run, de l’appelant et de l’agent actif.
Voir le guide Approbation d’une opération et unicité métier.
Applications et SDK
- Les ressources préparées sont transmises aux exécutions et conservées lors d’une reprise, avec vérification des empreintes et permissions.
- Les deux SDK permettent de créer et reprendre une compensation explicite.
- L’hôte peut activer les triggers déclarés et réduire leurs limites.
- Les diagnostics distinguent une entrée refusée (
ProjectEntrypointNotAllowed) d’un journal d’effets occupé (EffectJournalBusy).
Mise à jour depuis 1.1.0
Sauvegardez les projets et traitez les exécutions suspendues avec leur build d’origine. Actualisez la CLI, puis les SDK utilisés dans chaque projet :
touba update
touba sdk install javascript
touba sdk install python --manager uv
touba prepare --mode write
Les SDK doivent accompagner le runtime : les anciens schémas fermés peuvent
refuser le nouveau champ de provenance execution_context. Les champs inconnus
du manifeste ou de la configuration hôte sont désormais signalés : corrigez-les
avant préparation. Les nouveaux outils protégés nécessitent le runtime 1.3.1.
Pour les anciens journaux JSON, suivez la migration explicite vers SQLite. Conservez les originaux et leurs checkpoints associés. Rejouez ensuite les tests métier de votre application. Les contrôles du fournisseur, du montant et de l’unicité d’une facture restent dans le service métier.
Touba 1.1.0
Cette version ajoute la mise à jour vérifiée de la distribution :
touba update --check
touba update
touba update --rollback
Explorer améliore la lecture des ressources et des budgets. Les reprises refusent les checkpoints altérés, les contrats hôtes modifiés et les approbations déjà consommées. Les diagnostics des SDK conservent les causes structurées.
Pour migrer, sauvegardez les données, terminez ou rapprochez les opérations suspendues, installez la distribution puis actualisez les SDK de chaque projet. Un retour à l’ancien exécutable conserve les données métier actuelles. Les étapes de mise à jour décrivent ce parcours.
Les mises à jour suivantes paraîtront ici après qualification et distribution.