Versions et compatibilité du catalogue | Documentation Prescriptio

Quatre révisions disent ce qui a changé : le contrat d'appel, le catalogue, la documentation et la distribution.

Les révisions

Attention :

Un fichier généré ne prouve pas un déploiement

Le registre local comporte 96 outils ; le catalogue projeté en décrit 91. Les cinq compléments sont identifiés comme « En préparation » et restent hors du compteur des fiches projetées. Le manifeste du dépôt est lui aussi une projection. Seule une vérification du serveur déployé puis de tools/list avec les portées du compte établit ce qui est disponible dans cette connexion. Voir l'état des sources.

Champ	Ce qu'il suit
`api_contract_version`	La compatibilité des appels (aujourd'hui `3.0.0`)
`catalog_revision`	Les schémas et les métadonnées des outils
`docs_revision`	Cette référence
`distribution_revision`	La révision du profil connecteur à quatre outils (`/api/mcp/connectors`) ; ce champ n'atteste pas sa publication dans un annuaire

Elles se lisent dans le manifeste, avec tools_total et les portées.

Le contrat 3.0.0

Décidé le 22/09/2026 : les outils sont renommés par module, sans préfixe de marque ni numérotation (marches_rechercher, annuaire_entreprises, evenements_lire).

Les anciens noms en prescriptio_ (prescriptio_aide, prescriptio_entreprises…) restent des alias d'appel, absents de tools/list : ce ne sont pas des outils de plus.
Les opérations REST /api/mcp/v1/* et leurs identifiants n'ont pas changé.
Une session déjà ouverte peut garder son ancienne liste : actualisez le catalogue dans l'hôte.

Les règles de compatibilité

Le premier catalogue publié (1.0.0) est conservé tel quel, comme référence ; il ne se remplace jamais.
Une rupture exige une note de migration versionnée et une revue, publiées avec la version.
Le cache HTTP : les fichiers générés acceptent If-None-Match. L'outil aide accepte known_revision seulement avec cache_present: true, et force: true redonne le contenu après une perte de contexte.

Note :

Un changement de documentation ne prouve pas qu'un plugin déjà publié a été mis à jour.

[Index de la documentation](https://prescriptio.fr/docs/llms.txt) # Versions et compatibilité du catalogue Le catalogue de Prescriptio est versionné : le contrat 3.0.0 range les outils par module sous des noms stables, sans préfixe, et les anciens noms restent appelables comme alias non listés. ## Les révisions > **Attention :** Le registre local comporte 96 outils ; le catalogue projeté en décrit 91. Les cinq compléments sont identifiés comme « En préparation » et restent hors du compteur des fiches projetées. Le manifeste du dépôt est lui aussi une projection. Seule une vérification du serveur déployé puis de `tools/list` avec les portées du compte établit ce qui est disponible dans cette connexion. Voir [l'état des sources](https://prescriptio.fr/docs/reference/etat-des-sources). | Champ | Ce qu'il suit | |---|---| | `api_contract_version` | La compatibilité des appels (aujourd'hui `3.0.0`) | | `catalog_revision` | Les schémas et les métadonnées des outils | | `docs_revision` | Cette référence | | `distribution_revision` | La révision du profil connecteur à quatre outils (`/api/mcp/connectors`) ; ce champ n'atteste pas sa publication dans un annuaire | Elles se lisent dans le [manifeste](https://prescriptio.fr/agents/manifest.json), avec `tools_total` et les portées. ## Le contrat 3.0.0 Décidé le 22/09/2026 : les outils sont renommés par module, sans préfixe de marque ni numérotation (`marches_rechercher`, `annuaire_entreprises`, `evenements_lire`). - Les **anciens noms** en `prescriptio_` (`prescriptio_aide`, `prescriptio_entreprises`…) restent des **alias d'appel**, absents de `tools/list` : ce ne sont pas des outils de plus. - Les opérations REST `/api/mcp/v1/*` et leurs identifiants n'ont pas changé. - Une session déjà ouverte peut garder son ancienne liste : actualisez le catalogue dans l'hôte. ## Les règles de compatibilité - Le premier catalogue publié (`1.0.0`) est conservé tel quel, comme référence ; il ne se remplace jamais. - Une rupture exige une note de migration versionnée et une revue, publiées avec la version. - Le cache HTTP : les fichiers générés acceptent `If-None-Match`. L'outil `aide` accepte `known_revision` seulement avec `cache_present: true`, et `force: true` redonne le contenu après une perte de contexte. > **Note :** Un changement de documentation ne prouve pas qu'un plugin déjà publié a été mis à jour.