[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.