Contrats publics et versionnés

Interopérabilité

Cette page décrit uniquement les interfaces prises en charge pour Tentacular 1.x par l’activité HarmonyFidelis Technology, sous la marque HarmonyFidelis™. Les autres routes /api/* sont internes, peuvent changer sans préavis et ne constituent pas une interface publique.

Statut local agrégé

GET http://127.0.0.1:<port>/api/interop/v1/status retourne un état JSON en lecture seule conforme au schéma de statut v1. La lecture utilise uniquement l’état déjà présent en mémoire : elle ne lance ni scan, ni commande Git, ni accès réseau, ni écriture.

La réponse contient seulement des nombres agrégés. Elle exclut volontairement noms et chemins des dépôts, branches, SHA, auteurs, contenus, sorties Git, objectifs de mission, journal d’actions, jetons et secrets. Les contrôles Host et Origin locaux restent appliqués et aucun accès CORS n’est activé.

Retour de mission

Le bloc texte TENTACULAR_REPORT version 1 permet à un agent de déclarer son état. Tentacular traite cette déclaration comme une entrée non fiable, la borne, ne conserve pas le texte brut et revalide les preuves locales avant toute clôture.

Mises à jour signées

Le schéma du manifeste de mise à jour v1 décrit le manifeste signé Ed25519. L’artefact reste ensuite contrôlé par sa taille, son SHA-256 et l’identité Authenticode réellement configurée lors de la publication.

Compatibilité et demandes

Une version publiée ne change pas silencieusement le type ou le sens d’un champ requis. Tout changement incompatible crée une nouvelle version majeure. Les contrats v1 restent pris en charge pendant la ligne Tentacular 1.x.

Si une information nécessaire manque ou n’est pas suffisamment claire, utilisez le formulaire d’interopérabilité. Ne transmettez ni secret, code, chemin local, sortie Git brute, jeton ou donnée personnelle inutile.

Cette documentation vise à éviter une analyse du logiciel lorsqu’elle n’est pas nécessaire. Elle ne limite pas les droits impératifs applicables.