Ressources

Ressources : référence

Les ressources transverses : index du glossaire ACF®, métadonnées de la doctrine (version, hash, signature, URL d’archive, langues supportées) et bundle d’archive livré avec le paquet. La couche infrastructure du corpus, celle qui permet de vérifier sur quelle doctrine une sortie d’outil s’appuie.

→Astuce

La ressource acf://meta est le pivot du modèle de confiance ACF®. Elle expose le content_hash de la doctrine et sa signature Ed25519. Pin-la dans votre pipeline d’audit et vous obtenez un point d’entrée unique pour vérifier qu’une sortie d’outil correspond à une version de doctrine précise.

Ce que cette catégorie contient

Trois ressources transverses : (1) acf://glossary, l’index canonique des termes ACF® ; (2) acf://meta, les métadonnées techniques de la doctrine ; (3) le bundle d’archive, un fichier JSON livré dans le paquet npm. Aucune n’est volumineuse : elles tiennent toutes dans un cache client.

Liste exhaustive

Glossaire

acf://glossaryJSONFR + EN

Index canonique des termes ACF®

Liste structurée des termes officiels (DDAO, Souveraineté décisionnelle, autonomie déléguée, maturité N0 à N3, kill switch, mandat, registre de décisions, etc.) avec définitions bilingues et cross-refs vers les principes, fiches et articles régulateurs.

See also, outil READ acf.glossary.define pour la définition canonique d’un terme précis.

Métadonnées de la doctrine

acf://metaJSONneutre

Version, empreinte, signature, URL d’archive prévue, langues servies

Document court (JSON, ~1 Ko) qui décrit la version de doctrine actuellement servie : framework_version sémantique, content_build ISO 8601, content_hash SHA-256, doctrine_signature Ed25519, doctrine_public_key, permanent_archive_url, rules_version, fallback_locale et la liste exhaustive des locales supportées (V1.0 : fr, en, es, de, pt, it, nl, ru, ar, tr, ja, zh, ko, seuls fr et en sont effectivement servis, le reste tombe en fallback en).

Bundle d’archive

node_modules/acf-mcp/dist/archive/doctrine-v1.0.jsonJSON

Livré dans chaque version npm, avec son manifeste

Le bundle d’archive n’est pas une ressource MCP (pas d’URI acf://) : c’est un fichier qui contient tout le corpus de la version, chaque fichier avec son empreinte SHA-256, ainsi que l’empreinte globale, la signature Ed25519 et la clé publique. Le manifeste (manifest-v1.0.json) reprend les mêmes empreintes sans le contenu. Conservez-le dans votre dossier d’audit : il se vérifie hors ligne, sans le serveur MCP.

Forme des métadonnées

Ce que acf://meta renvoie (valeurs réelles d’acf-mcp 2.0.1) :

meta.jsonjson

{
  "framework_version": "1.0",
  "content_build": "2026-11-01T11:15:31.220Z",
  "content_hash": "sha256:119819463363cde0649504ab8ed5a96982fdb8506441f2c5e76e7e3c3feb77f1",
  "permanent_archive_url": "https://acfstandard.io/archive/doctrine/v1.0/doctrine-v1.0.json",
  "rules_version": "2026-06",
  "locales": [
    "fr",
    "en"
  ],
  "fallback_locale": "en",
  "doctrine_signature": "ed25519:3R0oIiqL3KgdVAemSy4oEprbUZnRWE4OEQQgD+2JnMzKhAL2xrmYjwrwbpkbew0T5B4YKvEYkycWFQ+paADFCQ==",
  "doctrine_public_key": "MCowBQYDK2VwAyEAojtKfh20SGGV63LMETjZBXRWo2tY0viAYziG/y3/L0s="
}

Récupérer les ressources de référence

En pratique, un client commence en général par lire acf://meta une fois au démarrage pour fixer la version de doctrine et obtenir la clé publique de vérification. Le glossaire suit, le plus souvent caché ensuite côté client puisqu’il change uniquement avec la doctrine elle-même.

fetch-reference.tsts

// 1. Pin the doctrine version on startup
const metaResp = await client.readResource({ uri: "acf://meta" });
const meta = JSON.parse(metaResp.contents[0].text);

const pinnedVersion = meta.framework_version;        // "1.0"
const pinnedHash = meta.content_hash;                // "sha256:1198..."
const verificationKey = meta.doctrine_public_key;    // base64 SPKI Ed25519

// 2. Read the glossary index
const glossaryResp = await client.readResource({ uri: "acf://glossary" });
const glossary = JSON.parse(glossaryResp.contents[0].text);
// Index of the terms; each one reads at acf://glossary/{term}

// 3. Every later tool output must embed the same content_hash,
//    otherwise the doctrine has shifted and the client must refresh.

Voir aussi

La page Signatures détaille la vérification Ed25519 hors-ligne et fournit des implémentations Node / Python / Go. La page Architecture explique pourquoi le contrat de signature est construit autour de acf://meta et non d’une signature par ressource.