@nodefony/devkit 10.0.0-alpha.1 → 10.0.0-alpha.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodefony/devkit",
-  "version": "10.0.0-alpha.1",
+  "version": "10.0.0-alpha.2",
   "type": "module",
   "description": "Outillage de développement d'une application Nodefony : carte de visite du projet et portes de découverte pour un agent de développement",
   "author": "Christophe CAMENSULI <ccamensuli@gmail.com>",
@@ -25,17 +25,17 @@
     "coverage": "vitest run --coverage"
   },
   "peerDependencies": {
-    "@nodefony/framework": "*",
-    "@nodefony/http": "*",
-    "nodefony": "*",
+    "@nodefony/framework": "^10.0.0-alpha.2",
+    "@nodefony/http": "^10.0.0-alpha.2",
+    "nodefony": "^10.0.0-alpha.2",
     "zod": "^4.4.3",
     "playwright": "^1.50.0",
     "lighthouse": "^13.0.0"
   },
   "devDependencies": {
-    "@nodefony/framework": "*",
-    "@nodefony/http": "*",
-    "nodefony": "*"
+    "@nodefony/framework": "^10.0.0-alpha.2",
+    "@nodefony/http": "^10.0.0-alpha.2",
+    "nodefony": "^10.0.0-alpha.2"
   },
   "dependencies": {
     "axe-core": "4.13.0",

package/dist/_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorate.js

@@ -1,9 +0,0 @@
-//#region \0@oxc-project+runtime@0.142.0/helpers/esm/decorate.js
-function __decorate(decorators, target, key, desc) {
-	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-	return c > 3 && r && Object.defineProperty(target, key, r), r;
-}
-//#endregion
-export { __decorate as default };

package/dist/_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorateMetadata.js

@@ -1,6 +0,0 @@
-//#region \0@oxc-project+runtime@0.142.0/helpers/esm/decorateMetadata.js
-function __decorateMetadata(k, v) {
-	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-//#endregion
-export { __decorateMetadata as default };

package/dist/_virtual/_@oxc-project_runtime@0.142.0/helpers/esm/decorateParam.js

@@ -1,8 +0,0 @@
-//#region \0@oxc-project+runtime@0.142.0/helpers/esm/decorateParam.js
-function __decorateParam(paramIndex, decorator) {
-	return function(target, key) {
-		decorator(target, key, paramIndex);
-	};
-}
-//#endregion
-export { __decorateParam as default };

package/dist/_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.js

@@ -1,9 +0,0 @@
-//#region \0@oxc-project+runtime@0.143.0/helpers/esm/decorate.js
-function __decorate(decorators, target, key, desc) {
-	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-	return c > 3 && r && Object.defineProperty(target, key, r), r;
-}
-//#endregion
-export { __decorate as default };

package/dist/_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateMetadata.js

@@ -1,6 +0,0 @@
-//#region \0@oxc-project+runtime@0.143.0/helpers/esm/decorateMetadata.js
-function __decorateMetadata(k, v) {
-	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-//#endregion
-export { __decorateMetadata as default };

package/dist/_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateParam.js

@@ -1,8 +0,0 @@
-//#region \0@oxc-project+runtime@0.143.0/helpers/esm/decorateParam.js
-function __decorateParam(paramIndex, decorator) {
-	return function(target, key) {
-		decorator(target, key, paramIndex);
-	};
-}
-//#endregion
-export { __decorateParam as default };

package/dist/_virtual/_@oxc-project_runtime@0.146.0/helpers/esm/decorate.js

@@ -1,9 +0,0 @@
-//#region \0@oxc-project+runtime@0.146.0/helpers/esm/decorate.js
-function __decorate(decorators, target, key, desc) {
-	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-	return c > 3 && r && Object.defineProperty(target, key, r), r;
-}
-//#endregion
-export { __decorate as default };

package/dist/_virtual/_@oxc-project_runtime@0.146.0/helpers/esm/decorateMetadata.js

@@ -1,6 +0,0 @@
-//#region \0@oxc-project+runtime@0.146.0/helpers/esm/decorateMetadata.js
-function __decorateMetadata(k, v) {
-	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-//#endregion
-export { __decorateMetadata as default };

package/dist/_virtual/_@oxc-project_runtime@0.146.0/helpers/esm/decorateParam.js

@@ -1,8 +0,0 @@
-//#region \0@oxc-project+runtime@0.146.0/helpers/esm/decorateParam.js
-function __decorateParam(paramIndex, decorator) {
-	return function(target, key) {
-		decorator(target, key, paramIndex);
-	};
-}
-//#endregion
-export { __decorateParam as default };

package/dist/_virtual/_@oxc-project_runtime@0.147.0/helpers/esm/decorate.js

@@ -1,9 +0,0 @@
-//#region \0@oxc-project+runtime@0.147.0/helpers/esm/decorate.js
-function __decorate(decorators, target, key, desc) {
-	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-	return c > 3 && r && Object.defineProperty(target, key, r), r;
-}
-//#endregion
-export { __decorate as default };

package/dist/_virtual/_@oxc-project_runtime@0.147.0/helpers/esm/decorateMetadata.js

@@ -1,6 +0,0 @@
-//#region \0@oxc-project+runtime@0.147.0/helpers/esm/decorateMetadata.js
-function __decorateMetadata(k, v) {
-	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-//#endregion
-export { __decorateMetadata as default };

package/dist/_virtual/_@oxc-project_runtime@0.147.0/helpers/esm/decorateParam.js

@@ -1,8 +0,0 @@
-//#region \0@oxc-project+runtime@0.147.0/helpers/esm/decorateParam.js
-function __decorateParam(paramIndex, decorator) {
-	return function(target, key) {
-		decorator(target, key, paramIndex);
-	};
-}
-//#endregion
-export { __decorateParam as default };

package/dist/nodefony/command/CardCommand.js

@@ -1,70 +0,0 @@
-import { Command } from "nodefony";
-//#region nodefony/command/CardCommand.ts
-/**
-* `onReady` : les services sont construits, AUCUN serveur n'écoute. La carte se
-* lit dans l'état du kernel — ouvrir un port pour la rendre serait payer un
-* démarrage complet pour une réponse qui n'en dépend pas.
-*/
-const options = {
-	showBanner: false,
-	kernelEvent: "onReady"
-};
-/**
-* `nodefony devkit:card [-j]` — qui répond, et où aller ensuite.
-*
-* ## Pourquoi une commande, alors que la route existe
-*
-* La route HTTP vit sous `/nodefony`, que le pare-feu d'une application réelle
-* couvre : un agent qui code ne s'authentifie pas, et n'a pas de navigateur. La
-* porte qu'il a déjà, c'est le terminal. Même source (le service), deux rendus —
-* ajouter une porte n'ajoute jamais une vérité.
-*
-* ⚠️ Le module est `policy: "dev"` : hors développement il n'est pas chargé, donc
-* cette commande **n'existe pas**. C'est voulu — et c'est pour ça qu'elle
-* s'invoque `NODE_ENV=development npx nodefony devkit:card` depuis un terminal
-* qui n'aurait pas posé la variable.
-*/
-var CardCommand = class CardCommand extends Command {
-	constructor(cli) {
-		super("devkit:card", "Imprime la carte de visite de l application", cli, options);
-		this.addOption("-j, --json", "sortie JSON brute (scriptable, `| jq`)");
-	}
-	async generate(opts) {
-		const svc = this.kernel?.container?.get("devkit");
-		if (!svc) {
-			this.log("service « devkit » non enregistré — module non chargé (policy dev) ?", "ERROR");
-			return this;
-		}
-		const card = svc.getCard();
-		if (opts.json) {
-			process.stdout.write(`${JSON.stringify(card, null, 2)}\n`);
-			return this;
-		}
-		process.stdout.write(CardCommand.format(card));
-		return this;
-	}
-	/**
-	* Rend la carte pour un HUMAIN (ou un agent qui lit un terminal).
-	*
-	* Statique et PURE : elle ne touche ni au kernel ni au service, donc elle
-	* s'éprouve seule. Sortie sur `stdout` plutôt que par le journal — une carte
-	* de visite n'est pas un événement de log, et le préfixe horodaté rendrait le
-	* copier-coller inutilisable.
-	*/
-	static format(card) {
-		return [
-			`${card.app.name} ${card.app.version} — ${card.app.environment} (nodefony ${card.nodefony.version})`,
-			"",
-			`Modules chargés (${card.modules.length}) : ${card.modules.join(", ")}`,
-			"",
-			"Où aller :",
-			...card.portes.map((p) => `  ${p.ou}\n      ${p.titre} — ${p.pourquoi}`),
-			"",
-			"Quoi lancer :",
-			...card.verbes.map((v) => `  ${v.commande}\n      ${v.pourquoi}`),
-			""
-		].join("\n");
-	}
-};
-//#endregion
-export { CardCommand as default };

package/dist/nodefony/controllers/OAuthMetadataController.js

@@ -1,89 +0,0 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.js";
-import { MCP_ENDPOINT_PATH, buildProtectedResourceMetadata, protectedResourceMetadataPath } from "nodefony";
-import { Controller, controller, route } from "@nodefony/framework";
-//#region nodefony/controllers/OAuthMetadataController.ts
-/**
-* Chemin bien connu où se publient les métadonnées de la porte MCP.
-*
-* **Dérivé, jamais recopié** : il se compose du chemin de l'endpoint par la
-* règle d'insertion de la RFC 9728 §3.1. Le littéral qu'on serait tenté
-* d'écrire ici deviendrait faux le jour où la porte déménage — et l'erreur
-* serait parfaitement silencieuse : un client sonde ce chemin, reçoit `404`,
-* et conclut que l'application n'a pas d'autorisation.
-*/
-const METADATA_PATH = protectedResourceMetadataPath(MCP_ENDPOINT_PATH);
-/**
-* Métadonnées OAuth 2.1 de la porte MCP — **le seul moyen normalisé** pour
-* qu'un agent apprenne où obtenir un jeton.
-*
-* ## Pourquoi un controller séparé
-*
-* Trois raisons, et aucune n'est esthétique. Le chemin vit **hors** du préfixe
-* `/nodefony` (la RFC impose `/.well-known/…` juste après l'hôte). Le document
-* est **public par conception** — un client doit pouvoir le lire avant d'avoir
-* le moindre jeton, donc il ne porte ni garde d'origine ni exigence de
-* localité, contrairement à la porte elle-même. Et il répond en `GET`, quand la
-* porte n'accepte que `POST`.
-*
-* ## Ce que publier coûte, et ce que ne rien publier coûte
-*
-* Le document ne révèle rien de sensible : l'émetteur des jetons, les scopes
-* compris, un nom. En revanche, ne PAS le publier a un coût mesuré — un client
-* qui ne le trouve pas suppose que le serveur d'autorisation est le serveur
-* lui-même, et part sonder des chemins qui n'existent pas. C'est exactement ce
-* qui a produit le bruit OAuth observé sur cette porte.
-*
-* 🔴 **Rôle éteint = `404`, jamais un document vide.** Un document sans serveur
-* d'autorisation apprendrait au client qu'un jeton est nécessaire sans jamais
-* lui dire où le demander : la spécification MCP l'interdit d'ailleurs
-* explicitement (« MUST include […] at least one authorization server »).
-*/
-let OAuthMetadataController = class OAuthMetadataController extends Controller {
-	constructor(context) {
-		super("devkit-oauth-metadata", context);
-	}
-	/** Résout le service du module depuis le conteneur partagé. */
-	#service() {
-		const svc = this.get("devkit");
-		if (!svc) throw new Error("DevkitService non enregistré");
-		return svc;
-	}
-	/**
-	* `GET /.well-known/oauth-protected-resource/nodefony/mcp` — RFC 9728 §3.
-	*
-	* @returns le document JSON, ou `404` si cette porte n'est pas protégée
-	*/
-	async metadata() {
-		const settings = this.#service().mcpSettings();
-		const authz = settings.authorization;
-		if (!settings.enabled || authz.authorizationServers.length === 0) return this.renderJson({ error: "not_found" }, 404);
-		let document;
-		try {
-			document = buildProtectedResourceMetadata({
-				resource: authz.resource,
-				authorizationServers: authz.authorizationServers,
-				scopesSupported: authz.scopesSupported,
-				resourceName: authz.resourceName,
-				resourceDocumentation: authz.resourceDocumentation
-			});
-		} catch (error) {
-			this.log(`MCP — métadonnées impubliables : ${error.message}`, "CRITIC");
-			return this.renderJson({ error: "server_error" }, 500);
-		}
-		return this.renderJson(document, 200, { "Cache-Control": "public, max-age=3600" });
-	}
-};
-__decorate([
-	route("devkit-mcp-protected-resource", {
-		path: METADATA_PATH,
-		method: "GET"
-	}),
-	__decorateMetadata("design:type", Function),
-	__decorateMetadata("design:paramtypes", []),
-	__decorateMetadata("design:returntype", Promise)
-], OAuthMetadataController.prototype, "metadata", null);
-OAuthMetadataController = __decorate([controller(""), __decorateMetadata("design:paramtypes", [Object])], OAuthMetadataController);
-var OAuthMetadataController_default = OAuthMetadataController;
-//#endregion
-export { OAuthMetadataController_default as default };

package/dist/nodefony/src/mcp/guard.js

@@ -1,51 +0,0 @@
-//#region nodefony/src/mcp/guard.ts
-/**
-* Une adresse est-elle celle de la machine locale ?
-*
-* Couvre les trois formes que Node rend selon la pile réseau : IPv4
-* (`127.x.x.x`), IPv6 (`::1`), et l'IPv4 encapsulée en IPv6
-* (`::ffff:127.0.0.1`) — la plus fréquente sur un serveur à double pile, et
-* celle qu'une comparaison naïve à `"127.0.0.1"` rate.
-*
-* @param address - `socket.remoteAddress`, éventuellement absent
-* @returns `true` si l'appel vient de cette machine
-*/
-function isLocalAddress(address) {
-	if (!address) return false;
-	const bare = address.startsWith("::ffff:") ? address.slice(7) : address;
-	if (bare === "::1" || bare === "localhost") return true;
-	return /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(bare);
-}
-/**
-* Décide si un appel MCP peut être servi.
-*
-* ⭐ **La règle sur `Origin` est contre-intuitive, et c'est elle qui protège.**
-* Un client MCP légitime est un *process* (Cursor, Claude Code, un agent tiers)
-* : il n'envoie **aucun** `Origin`, cet en-tête étant posé par les navigateurs.
-* Une page web malveillante, elle, en pose **toujours** un lorsqu'elle vise
-* `https://localhost:5152`. Donc : *absent* → on passe ; *présent et hors
-* allowlist* → `403`. C'est ce qui referme le DNS rebinding, le seul vecteur
-* réel contre un serveur MCP local.
-*
-* L'ordre des contrôles est délibéré : la localité d'abord, parce qu'un appel
-* distant ne doit même pas apprendre quelles origines sont admises.
-*
-* @param input - ce que la requête présente
-* @param policy - les réglages du module
-* @returns le verdict, avec le motif quand il refuse
-*/
-function checkMcpAccess(input, policy) {
-	if (!policy.allowRemote && !isLocalAddress(input.remoteAddress)) return {
-		allowed: false,
-		why: `adresse non locale (${input.remoteAddress ?? "inconnue"}) — voir devkit.mcp.allowRemote`
-	};
-	if (input.origin !== void 0 && input.origin !== "") {
-		if (!policy.allowedOrigins.includes(input.origin)) return {
-			allowed: false,
-			why: `origine « ${input.origin} » non admise — voir devkit.mcp.allowedOrigins`
-		};
-	}
-	return { allowed: true };
-}
-//#endregion
-export { checkMcpAccess, isLocalAddress };

package/dist/nodefony/src/mcp/protocol.js

@@ -1,127 +0,0 @@
-//#region nodefony/src/mcp/protocol.ts
-/**
-* Model Context Protocol — types et constantes du transport « Streamable HTTP ».
-*
-* Révision visée : **2026-07-28**, celle qui a supprimé les sessions de niveau
-* protocole et le flux `GET`. C'est ce qui rend cette porte possible sans
-* process dédié : chaque message est un `POST` autonome, donc un redémarrage du
-* serveur de développement ne casse rien — le client rejoue simplement sa
-* requête, et la réponse vient du code qui vient d'être rechargé.
-*
-* @see https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http
-*/
-/** Révision du protocole que ce serveur annonce. */
-const MCP_PROTOCOL_VERSION = "2026-07-28";
-/**
-* Versions que ce serveur sait servir — publiées par `server/discover` et
-* listées dans l'erreur `UnsupportedProtocolVersion`.
-*
-* Une seule pour l'instant, et c'est délibéré : annoncer une révision qu'on
-* n'a pas éprouvée reviendrait à promettre une sémantique qu'on ne tient pas.
-*/
-const MCP_SUPPORTED_VERSIONS = [MCP_PROTOCOL_VERSION];
-/**
-* Clé de métadonnée par laquelle un client MODERNE déclare sa révision.
-*
-* ⭐ **C'est la différence d'ÈRE, et elle commande tout le reste.** Jusqu'à
-* `2025-11-25` (ère « legacy »), un client ouvrait une session par un handshake
-* `initialize`. Depuis `2026-07-28` (ère « modern »), il n'y a plus de session :
-* chaque requête porte elle-même sa version et les capacités du client, dans
-* `params._meta`. Un serveur qui n'écouterait que `initialize` serait un
-* serveur *legacy* — quelle que soit la version qu'il prétend annoncer.
-*/
-const META_PROTOCOL_VERSION = "io.modelcontextprotocol/protocolVersion";
-/** Clé de métadonnée portant l'identité du serveur dans `server/discover`. */
-const META_SERVER_INFO = "io.modelcontextprotocol/serverInfo";
-/**
-* Chemin de l'endpoint MCP.
-*
-* ## Pourquoi `/nodefony/mcp`, et pas `/nodefony/devkit/api/mcp`
-*
-* Cette URL est un **contrat public** : elle est écrite dans le `.mcp.json` de
-* chaque utilisateur. Y faire figurer le module qui l'implémente la rendrait
-* caduque au premier déménagement — or ce serveur a vocation à bouger le jour
-* où une application voudra s'exposer en production (le devkit, lui, est
-* `policy: "dev"`). Le nom d'un module est un détail d'implémentation ; une URL
-* ne l'est pas.
-*
-* Le segment `api` est écarté pour une autre raison : il désigne le plan
-* d'administration JSON de Studio, avec son contrôle d'accès par rôle. Le MCP
-* n'est ni REST ni destiné à Studio — ranger deux protocoles sous le même
-* segment promettrait une parenté qui n'existe pas.
-*
-* Et `/mcp` à la racine, qui est la convention de fait ailleurs, prendrait un
-* chemin qui **appartient à l'application** : `/nodefony` est le préfixe
-* réservé du framework, donc sans collision possible.
-*
-* Constante et **non configurable** : une route décorée est statique, et un
-* réglage qui n'agirait pas serait pire qu'aucun réglage.
-*/
-const MCP_ENDPOINT_PATH = "/nodefony/mcp";
-/** Codes d'erreur JSON-RPC 2.0 employés par ce serveur. */
-const JsonRpcError = {
-	/** Corps illisible. */
-	PARSE_ERROR: -32700,
-	/** Message qui n'est pas une requête JSON-RPC valide. */
-	INVALID_REQUEST: -32600,
-	/** Méthode inconnue — la spec exige alors un `404` HTTP. */
-	METHOD_NOT_FOUND: -32601,
-	/** Paramètres absents ou mal typés. */
-	INVALID_PARAMS: -32602,
-	/** Échec côté serveur. */
-	INTERNAL_ERROR: -32603
-};
-/**
-* Codes réservés par la spec MCP, hors plage JSON-RPC standard.
-*
-* Ils ne sont pas décoratifs : un client s'en sert pour se rattraper seul —
-* renégocier une version sur `-32022`, relire `tools/list` puis réessayer sur
-* `-32020`. Rendre un `-32600` générique à leur place le priverait de cette
-* reprise et transformerait un désaccord réparable en échec définitif.
-*/
-const McpProtocolError = {
-	/**
-	* Les en-têtes HTTP contredisent le corps, ou un en-tête requis manque.
-	* La spec impose `400` **et** ce code (`streamable-http` §Server Validation).
-	*/
-	HEADER_MISMATCH: -32020,
-	/**
-	* La révision demandée n'est pas servie. La réponse **doit** lister celles
-	* qu'on sert, sans quoi le client n'a rien pour choisir.
-	*/
-	UNSUPPORTED_PROTOCOL_VERSION: -32022
-};
-/** Fabrique une réponse de succès. */
-function jsonRpcSuccess(id, result) {
-	return {
-		jsonrpc: "2.0",
-		id,
-		result
-	};
-}
-/** Fabrique une réponse d'erreur. */
-function jsonRpcFailure(id, code, message, data) {
-	return {
-		jsonrpc: "2.0",
-		id,
-		error: data === void 0 ? {
-			code,
-			message
-		} : {
-			code,
-			message,
-			data
-		}
-	};
-}
-/**
-* Un message est-il une NOTIFICATION (pas d'`id`) plutôt qu'une requête ?
-*
-* La distinction commande le statut HTTP : une notification acceptée rend
-* `202` **sans corps**, une requête rend son objet JSON.
-*/
-function isNotification(message) {
-	return message.id === void 0 || message.id === null;
-}
-//#endregion
-export { JsonRpcError, MCP_ENDPOINT_PATH, MCP_PROTOCOL_VERSION, MCP_SUPPORTED_VERSIONS, META_PROTOCOL_VERSION, META_SERVER_INFO, McpProtocolError, isNotification, jsonRpcFailure, jsonRpcSuccess };

package/dist/nodefony/src/mcp/server.js

@@ -1,133 +0,0 @@
-import { JsonRpcError, MCP_PROTOCOL_VERSION, MCP_SUPPORTED_VERSIONS, META_PROTOCOL_VERSION, META_SERVER_INFO, McpProtocolError, isNotification, jsonRpcFailure, jsonRpcSuccess } from "./protocol.js";
-import { callMcpTool, listMcpTools } from "./tools.js";
-//#region nodefony/src/mcp/server.ts
-/**
-* Extrait la révision déclarée dans `params._meta`, s'il y en a une.
-*
-* Un client MODERNE la pose à chaque requête ; un client LEGACY ne pose rien
-* et négocie par `initialize`. L'absence n'est donc pas une faute : c'est un
-* indice d'ère.
-*/
-function metaVersion(params) {
-	const meta = params._meta;
-	if (typeof meta !== "object" || meta === null) return void 0;
-	const value = meta[META_PROTOCOL_VERSION];
-	return typeof value === "string" ? value : void 0;
-}
-/**
-* Contrôle la cohérence et le support de la révision annoncée.
-*
-* Deux refus distincts, et la spec impose les deux :
-*  - **en-tête ≠ `_meta`** → `400` + `HeaderMismatch` (`-32020`). Le motif est
-*    une vraie faille : un répartiteur de charge peut router sur l'en-tête
-*    pendant que le serveur exécute d'après le corps — deux sources de vérité
-*    pour une même requête.
-*  - **révision inconnue** → `400` + `UnsupportedProtocolVersion` (`-32022`),
-*    **avec la liste de celles qu'on sert** : c'est elle qui permet au client
-*    de se rattraper au lieu d'abandonner.
-*
-* @returns `null` si tout va bien, sinon la réponse de refus
-*/
-function checkProtocolVersion(id, params, headers) {
-	const fromMeta = metaVersion(params);
-	const fromHeader = headers.protocolVersion;
-	if (fromMeta && fromHeader && fromMeta !== fromHeader) return {
-		status: 400,
-		body: jsonRpcFailure(id, McpProtocolError.HEADER_MISMATCH, "MCP-Protocol-Version ne correspond pas à _meta", {
-			header: fromHeader,
-			meta: fromMeta
-		})
-	};
-	const declared = fromMeta ?? fromHeader;
-	if (!declared) return null;
-	if (!MCP_SUPPORTED_VERSIONS.includes(declared)) return {
-		status: 400,
-		body: jsonRpcFailure(id, McpProtocolError.UNSUPPORTED_PROTOCOL_VERSION, "Unsupported protocol version", {
-			supported: [...MCP_SUPPORTED_VERSIONS],
-			requested: declared
-		})
-	};
-	return null;
-}
-/**
-* Traite UN message JSON-RPC.
-*
-* @param message - corps du `POST`, déjà parsé
-* @param context - outils autorisés et briques qui répondent
-* @param headers - en-têtes du transport (`MCP-Protocol-Version`)
-* @returns statut HTTP et corps à écrire (corps `null` = `202` sans contenu)
-*/
-async function handleMcpMessage(message, context, headers = {}) {
-	if (message === null || typeof message !== "object" || typeof message.method !== "string") return {
-		status: 400,
-		body: jsonRpcFailure(null, JsonRpcError.INVALID_REQUEST, "message JSON-RPC invalide : `method` manquante")
-	};
-	const method = message.method;
-	if (isNotification(message)) return {
-		status: 202,
-		body: null
-	};
-	const id = message.id;
-	const params = typeof message.params === "object" && message.params !== null ? message.params : {};
-	const refus = checkProtocolVersion(id, params, headers);
-	if (refus) return refus;
-	switch (method) {
-		case "server/discover": return {
-			status: 200,
-			body: jsonRpcSuccess(id, {
-				resultType: "complete",
-				supportedVersions: [...MCP_SUPPORTED_VERSIONS],
-				capabilities: { tools: {} },
-				instructions: "Outils d'introspection d'une application Nodefony : ce qui est monté (inspect), ce qui manque (check), ce qu'une API du framework signifie (symbols), et par où commencer (card).",
-				_meta: { [META_SERVER_INFO]: context.serverInfo }
-			})
-		};
-		case "initialize": return {
-			status: 200,
-			body: jsonRpcSuccess(id, {
-				protocolVersion: MCP_PROTOCOL_VERSION,
-				capabilities: { tools: {} },
-				serverInfo: context.serverInfo
-			})
-		};
-		case "ping": return {
-			status: 200,
-			body: jsonRpcSuccess(id, {})
-		};
-		case "tools/list": return {
-			status: 200,
-			body: jsonRpcSuccess(id, { tools: listMcpTools(context.tools) })
-		};
-		case "tools/call": {
-			const name = typeof params.name === "string" ? params.name : "";
-			const args = typeof params.arguments === "object" && params.arguments !== null ? params.arguments : {};
-			if (!name) return {
-				status: 400,
-				body: jsonRpcFailure(id, JsonRpcError.INVALID_PARAMS, "`name` est requis pour `tools/call`")
-			};
-			let result;
-			try {
-				result = await callMcpTool(name, args, context.tools, context);
-			} catch (error) {
-				return {
-					status: 200,
-					body: jsonRpcFailure(id, JsonRpcError.INTERNAL_ERROR, `l'outil « ${name} » a échoué : ${error.message}`)
-				};
-			}
-			if (result === null) return {
-				status: 200,
-				body: jsonRpcFailure(id, JsonRpcError.INVALID_PARAMS, `outil inconnu « ${name} » — voir tools/list`)
-			};
-			return {
-				status: 200,
-				body: jsonRpcSuccess(id, result)
-			};
-		}
-		default: return {
-			status: 404,
-			body: jsonRpcFailure(id, JsonRpcError.METHOD_NOT_FOUND, `méthode inconnue « ${method} »`)
-		};
-	}
-}
-//#endregion
-export { handleMcpMessage };

package/dist/nodefony/src/mcp/tools.js

@@ -1,163 +0,0 @@
-import { INSPECT_SUBJECTS, collectCheckReport, countCheckFindings, lookupSymbol, readAdminSubject, readSymbolsGraph } from "nodefony";
-//#region nodefony/src/mcp/tools.ts
-/** Préfixe des noms d'outils — un agent voit à qui il parle. */
-const PREFIX = "nodefony_";
-/**
-* Liste des sujets, rendue lisible pour la description de l'outil.
-*
-* Dérivée de {@link INSPECT_SUBJECTS} : ajouter un sujet au cœur le publie ici
-* sans rien réécrire, et il ne peut pas exister de sujet annoncé qu'on ne
-* saurait pas lire.
-*/
-function subjectLines() {
-	return Object.entries(INSPECT_SUBJECTS).map(([key, spec]) => `- \`${key}\` : ${spec.summary}`).join("\n");
-}
-/** Catalogue complet, avant filtrage par l'allowlist de configuration. */
-function catalogue() {
-	return {
-		inspect: {
-			name: `${PREFIX}inspect`,
-			description: `Lit l'état RÉEL de cette application Nodefony : les routes réellement montées, les modules chargés, les services enregistrés, la configuration effective et la provenance de chaque valeur, les stores de données, les entités de l'ORM. À utiliser avant d'écrire du code qui suppose une route, un service ou une clé de configuration — la réponse vient de l'application qui tourne, pas d'une lecture des sources, donc elle ne peut pas se tromper sur ce qui est chargé.
-
-Sujets disponibles :\n${subjectLines()}`,
-			inputSchema: {
-				type: "object",
-				properties: {
-					subject: {
-						type: "string",
-						enum: Object.keys(INSPECT_SUBJECTS),
-						description: "Ce qu'on veut voir"
-					},
-					target: {
-						type: "string",
-						description: "Paramètre du sujet, quand il en attend un (ex. le nom d'un module pour `module`)"
-					}
-				},
-				required: ["subject"]
-			}
-		},
-		card: {
-			name: `${PREFIX}card`,
-			description: "Carte de visite de l'application : son identité, les modules chargés, où trouver la documentation, et les commandes à lancer. À utiliser en ARRIVANT sur une application inconnue, avant toute autre exploration — elle dit en un appel ce qu'il y a et où aller ensuite.",
-			inputSchema: {
-				type: "object",
-				properties: {}
-			}
-		},
-		check: {
-			name: `${PREFIX}check`,
-			description: "Diagnostic STATIQUE de l'application : classes écrites que rien n'enregistre (entité, controller ou service jamais câblé), paquets importés sans être déclarés, variables d'environnement requises absentes, modules du manifeste non installés, ports occupés, et le bilan du dernier démarrage. À utiliser APRÈS avoir écrit ou généré du code, avant de conclure que c'est fini : ni la compilation ni les tests ne voient qu'une classe n'est branchée à rien.",
-			inputSchema: {
-				type: "object",
-				properties: {}
-			}
-		},
-		symbols: {
-			name: `${PREFIX}symbols`,
-			description: "Interroge le graphe symbolique du framework : ce qu'est un symbole (classe, interface, fonction), où il est défini, ce qu'il étend ou implémente, et la première phrase de sa documentation. À utiliser AVANT d'ouvrir un fichier pour comprendre une API du framework — la réponse est immédiate et vaut pour la version réellement installée. Sans argument, rend le résumé du graphe ; avec `module`, la surface exportée d'un paquet.",
-			inputSchema: {
-				type: "object",
-				properties: {
-					name: {
-						type: "string",
-						description: "Nom exact du symbole (ex. `AbstractCrudService`, `IKernel`)"
-					},
-					module: {
-						type: "string",
-						description: "Paquet dont on veut la surface exportée (ex. `@nodefony/http`)"
-					}
-				}
-			}
-		}
-	};
-}
-/**
-* Outils publiés, filtrés par l'allowlist de configuration.
-*
-* Une clé inconnue dans la configuration est simplement ignorée : elle ne peut
-* rien ouvrir. C'est le sens d'une allowlist — ce qui n'est pas nommé ICI
-* n'existe pas, et la faute de frappe d'un utilisateur ne peut pas activer
-* autre chose que ce qu'il voulait.
-*
-* ⚠️ **`Object.hasOwn` n'est pas une précaution de style.** Sans lui,
-* `tools: ["toString"]` résolvait une méthode héritée d'`Object.prototype` :
-* la valeur n'étant pas `undefined`, elle franchissait le filtre et un outil
-* fantôme entrait dans le catalogue publié. Trouvé par le test, pas à la
-* relecture.
-*
-* @param enabled - clés d'outils autorisées (`devkit.mcp.tools`)
-*/
-function listMcpTools(enabled) {
-	const all = catalogue();
-	return enabled.filter((key) => Object.hasOwn(all, key)).map((key) => all[key]).filter((tool) => tool !== void 0);
-}
-/** Rend un contenu textuel — les données partent en JSON indenté, lisible. */
-function text(value, isError = false) {
-	const rendered = typeof value === "string" ? value : JSON.stringify(value, null, 2);
-	return isError ? {
-		content: [{
-			type: "text",
-			text: rendered
-		}],
-		isError: true
-	} : { content: [{
-		type: "text",
-		text: rendered
-	}] };
-}
-/**
-* Exécute un outil par son nom public.
-*
-* Un échec métier (sujet inconnu, module absent) rend un résultat `isError`,
-* **pas** une erreur JSON-RPC : le protocole réserve celle-ci aux fautes de
-* protocole. La distinction compte pour l'agent — une erreur de protocole
-* signifie « tu t'y prends mal », un `isError` signifie « ta demande est
-* recevable, voici pourquoi elle n'aboutit pas » ; c'est la seconde qu'il peut
-* corriger seul.
-*
-* @param name - nom public de l'outil (`nodefony_inspect`…)
-* @param args - arguments fournis par l'agent
-* @param enabled - allowlist de configuration
-* @param deps - briques qui répondent réellement
-* @returns le résultat de l'outil, ou `null` si le nom n'est pas exposé
-*/
-async function callMcpTool(name, args, enabled, deps) {
-	if (!listMcpTools(enabled).find((tool) => tool.name === name)) return null;
-	if (name === `${PREFIX}card`) return text(deps.getCard());
-	if (name === `${PREFIX}inspect`) {
-		const subject = typeof args.subject === "string" ? args.subject : "";
-		const target = typeof args.target === "string" ? args.target : void 0;
-		const read = await readAdminSubject(deps.broker, subject, target);
-		if (!read.ok) return text(read.message, true);
-		return text(read.data);
-	}
-	if (name === `${PREFIX}check`) {
-		const report = await collectCheckReport(deps.projectRoot);
-		return text({
-			verdict: countCheckFindings(report) === 0 ? "ok" : "manquements",
-			total: countCheckFindings(report),
-			...report
-		});
-	}
-	if (name === `${PREFIX}symbols`) {
-		const graph = readSymbolsGraph(deps.projectRoot);
-		if (graph === null) return text("aucun graphe symbolique atteignable — il est publié par le paquet `nodefony` (node_modules/nodefony/.ai/symbols.json) et régénérable dans ce dépôt par `npm run generate-symbols`", true);
-		const wanted = typeof args.name === "string" ? args.name : null;
-		const module = typeof args.module === "string" ? args.module : null;
-		if (wanted !== null) {
-			const sym = lookupSymbol(graph, wanted);
-			return sym ? text(sym) : text(`« ${wanted} » est introuvable dans le graphe (${Object.keys(graph.symbols).length} symboles)`, true);
-		}
-		const entries = Object.values(graph.symbols).filter((s) => module === null || s.module === module);
-		if (module !== null) return text(entries.sort((a, b) => a.name.localeCompare(b.name)));
-		const parPaquet = Object.create(null);
-		for (const sym of entries) parPaquet[sym.module] = (parPaquet[sym.module] ?? 0) + 1;
-		return text({
-			total: entries.length,
-			parPaquet
-		});
-	}
-	return text(`outil « ${name} » publié mais non implémenté`, true);
-}
-//#endregion
-export { callMcpTool, listMcpTools };

package/dist/types/nodefony/command/CardCommand.d.ts

@@ -1,33 +0,0 @@
-import { Command, CliKernel } from "nodefony";
-import type { IDevkitCard } from "../interfaces/IDevkitService.js";
-/**
- * `nodefony devkit:card [-j]` — qui répond, et où aller ensuite.
- *
- * ## Pourquoi une commande, alors que la route existe
- *
- * La route HTTP vit sous `/nodefony`, que le pare-feu d'une application réelle
- * couvre : un agent qui code ne s'authentifie pas, et n'a pas de navigateur. La
- * porte qu'il a déjà, c'est le terminal. Même source (le service), deux rendus —
- * ajouter une porte n'ajoute jamais une vérité.
- *
- * ⚠️ Le module est `policy: "dev"` : hors développement il n'est pas chargé, donc
- * cette commande **n'existe pas**. C'est voulu — et c'est pour ça qu'elle
- * s'invoque `NODE_ENV=development npx nodefony devkit:card` depuis un terminal
- * qui n'aurait pas posé la variable.
- */
-declare class CardCommand extends Command {
-    constructor(cli: CliKernel);
-    generate(opts: {
-        json?: boolean;
-    }): Promise<this>;
-    /**
-     * Rend la carte pour un HUMAIN (ou un agent qui lit un terminal).
-     *
-     * Statique et PURE : elle ne touche ni au kernel ni au service, donc elle
-     * s'éprouve seule. Sortie sur `stdout` plutôt que par le journal — une carte
-     * de visite n'est pas un événement de log, et le préfixe horodaté rendrait le
-     * copier-coller inutilisable.
-     */
-    static format(card: IDevkitCard): string;
-}
-export default CardCommand;

package/dist/types/nodefony/controllers/OAuthMetadataController.d.ts

@@ -1,39 +0,0 @@
-import { Controller } from "@nodefony/framework";
-import type { ContextType } from "@nodefony/http";
-/**
- * Métadonnées OAuth 2.1 de la porte MCP — **le seul moyen normalisé** pour
- * qu'un agent apprenne où obtenir un jeton.
- *
- * ## Pourquoi un controller séparé
- *
- * Trois raisons, et aucune n'est esthétique. Le chemin vit **hors** du préfixe
- * `/nodefony` (la RFC impose `/.well-known/…` juste après l'hôte). Le document
- * est **public par conception** — un client doit pouvoir le lire avant d'avoir
- * le moindre jeton, donc il ne porte ni garde d'origine ni exigence de
- * localité, contrairement à la porte elle-même. Et il répond en `GET`, quand la
- * porte n'accepte que `POST`.
- *
- * ## Ce que publier coûte, et ce que ne rien publier coûte
- *
- * Le document ne révèle rien de sensible : l'émetteur des jetons, les scopes
- * compris, un nom. En revanche, ne PAS le publier a un coût mesuré — un client
- * qui ne le trouve pas suppose que le serveur d'autorisation est le serveur
- * lui-même, et part sonder des chemins qui n'existent pas. C'est exactement ce
- * qui a produit le bruit OAuth observé sur cette porte.
- *
- * 🔴 **Rôle éteint = `404`, jamais un document vide.** Un document sans serveur
- * d'autorisation apprendrait au client qu'un jeton est nécessaire sans jamais
- * lui dire où le demander : la spécification MCP l'interdit d'ailleurs
- * explicitement (« MUST include […] at least one authorization server »).
- */
-declare class OAuthMetadataController extends Controller {
-    #private;
-    constructor(context: ContextType);
-    /**
-     * `GET /.well-known/oauth-protected-resource/nodefony/mcp` — RFC 9728 §3.
-     *
-     * @returns le document JSON, ou `404` si cette porte n'est pas protégée
-     */
-    metadata(): Promise<import("@nodefony/http").Http2Response | import("@nodefony/http").HttpResponse | import("@nodefony/http").WebsocketResponse>;
-}
-export default OAuthMetadataController;

package/dist/types/nodefony/src/mcp/guard.d.ts

@@ -1,66 +0,0 @@
-/**
- * Gardes du transport MCP — ce qui protège une porte locale SANS authentification.
- *
- * Ces deux contrôles ne sont pas un pis-aller : ce sont exactement les
- * exigences que la spec pose au transport lui-même, indépendamment de toute
- * autorisation (`transports/streamable-http` §Security & Endpoint) —
- * « Servers **MUST** validate the `Origin` header on all incoming connections
- * to prevent DNS rebinding attacks » et « When running locally, servers
- * **SHOULD** bind only to localhost ».
- *
- * Fonctions **pures** : elles reçoivent ce qu'elles jugent, elles ne le lisent
- * nulle part. C'est ce qui les rend éprouvables sans serveur ni requête réelle
- * — et ce qui permet de vérifier le refus, qui est le comportement qui compte.
- */
-/** Verdict d'une garde : passer, ou refuser en disant pourquoi. */
-export type GuardVerdict = {
-    allowed: true;
-} | {
-    allowed: false;
-    why: string;
-};
-/** Ce que la garde a besoin de savoir d'une requête. */
-export interface IGuardInput {
-    /** En-tête `Origin`, `undefined` s'il est absent. */
-    origin?: string;
-    /** Adresse distante de la connexion (`socket.remoteAddress`). */
-    remoteAddress?: string;
-}
-/** Réglages qui gouvernent les gardes (viennent de la config du module). */
-export interface IGuardPolicy {
-    /** Origines de navigateur admises ; vide = aucune. */
-    allowedOrigins: readonly string[];
-    /** Accepter une adresse distante non locale. */
-    allowRemote: boolean;
-}
-/**
- * Une adresse est-elle celle de la machine locale ?
- *
- * Couvre les trois formes que Node rend selon la pile réseau : IPv4
- * (`127.x.x.x`), IPv6 (`::1`), et l'IPv4 encapsulée en IPv6
- * (`::ffff:127.0.0.1`) — la plus fréquente sur un serveur à double pile, et
- * celle qu'une comparaison naïve à `"127.0.0.1"` rate.
- *
- * @param address - `socket.remoteAddress`, éventuellement absent
- * @returns `true` si l'appel vient de cette machine
- */
-export declare function isLocalAddress(address?: string): boolean;
-/**
- * Décide si un appel MCP peut être servi.
- *
- * ⭐ **La règle sur `Origin` est contre-intuitive, et c'est elle qui protège.**
- * Un client MCP légitime est un *process* (Cursor, Claude Code, un agent tiers)
- * : il n'envoie **aucun** `Origin`, cet en-tête étant posé par les navigateurs.
- * Une page web malveillante, elle, en pose **toujours** un lorsqu'elle vise
- * `https://localhost:5152`. Donc : *absent* → on passe ; *présent et hors
- * allowlist* → `403`. C'est ce qui referme le DNS rebinding, le seul vecteur
- * réel contre un serveur MCP local.
- *
- * L'ordre des contrôles est délibéré : la localité d'abord, parce qu'un appel
- * distant ne doit même pas apprendre quelles origines sont admises.
- *
- * @param input - ce que la requête présente
- * @param policy - les réglages du module
- * @returns le verdict, avec le motif quand il refuse
- */
-export declare function checkMcpAccess(input: IGuardInput, policy: IGuardPolicy): GuardVerdict;

package/dist/types/nodefony/src/mcp/protocol.d.ts

@@ -1,139 +0,0 @@
-/**
- * Model Context Protocol — types et constantes du transport « Streamable HTTP ».
- *
- * Révision visée : **2026-07-28**, celle qui a supprimé les sessions de niveau
- * protocole et le flux `GET`. C'est ce qui rend cette porte possible sans
- * process dédié : chaque message est un `POST` autonome, donc un redémarrage du
- * serveur de développement ne casse rien — le client rejoue simplement sa
- * requête, et la réponse vient du code qui vient d'être rechargé.
- *
- * @see https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http
- */
-/** Révision du protocole que ce serveur annonce. */
-export declare const MCP_PROTOCOL_VERSION = "2026-07-28";
-/**
- * Versions que ce serveur sait servir — publiées par `server/discover` et
- * listées dans l'erreur `UnsupportedProtocolVersion`.
- *
- * Une seule pour l'instant, et c'est délibéré : annoncer une révision qu'on
- * n'a pas éprouvée reviendrait à promettre une sémantique qu'on ne tient pas.
- */
-export declare const MCP_SUPPORTED_VERSIONS: readonly ["2026-07-28"];
-/**
- * Clé de métadonnée par laquelle un client MODERNE déclare sa révision.
- *
- * ⭐ **C'est la différence d'ÈRE, et elle commande tout le reste.** Jusqu'à
- * `2025-11-25` (ère « legacy »), un client ouvrait une session par un handshake
- * `initialize`. Depuis `2026-07-28` (ère « modern »), il n'y a plus de session :
- * chaque requête porte elle-même sa version et les capacités du client, dans
- * `params._meta`. Un serveur qui n'écouterait que `initialize` serait un
- * serveur *legacy* — quelle que soit la version qu'il prétend annoncer.
- */
-export declare const META_PROTOCOL_VERSION = "io.modelcontextprotocol/protocolVersion";
-/** Clé de métadonnée portant l'identité du serveur dans `server/discover`. */
-export declare const META_SERVER_INFO = "io.modelcontextprotocol/serverInfo";
-/**
- * Chemin de l'endpoint MCP.
- *
- * ## Pourquoi `/nodefony/mcp`, et pas `/nodefony/devkit/api/mcp`
- *
- * Cette URL est un **contrat public** : elle est écrite dans le `.mcp.json` de
- * chaque utilisateur. Y faire figurer le module qui l'implémente la rendrait
- * caduque au premier déménagement — or ce serveur a vocation à bouger le jour
- * où une application voudra s'exposer en production (le devkit, lui, est
- * `policy: "dev"`). Le nom d'un module est un détail d'implémentation ; une URL
- * ne l'est pas.
- *
- * Le segment `api` est écarté pour une autre raison : il désigne le plan
- * d'administration JSON de Studio, avec son contrôle d'accès par rôle. Le MCP
- * n'est ni REST ni destiné à Studio — ranger deux protocoles sous le même
- * segment promettrait une parenté qui n'existe pas.
- *
- * Et `/mcp` à la racine, qui est la convention de fait ailleurs, prendrait un
- * chemin qui **appartient à l'application** : `/nodefony` est le préfixe
- * réservé du framework, donc sans collision possible.
- *
- * Constante et **non configurable** : une route décorée est statique, et un
- * réglage qui n'agirait pas serait pire qu'aucun réglage.
- */
-export declare const MCP_ENDPOINT_PATH = "/nodefony/mcp";
-/** Codes d'erreur JSON-RPC 2.0 employés par ce serveur. */
-export declare const JsonRpcError: {
-    /** Corps illisible. */
-    readonly PARSE_ERROR: -32700;
-    /** Message qui n'est pas une requête JSON-RPC valide. */
-    readonly INVALID_REQUEST: -32600;
-    /** Méthode inconnue — la spec exige alors un `404` HTTP. */
-    readonly METHOD_NOT_FOUND: -32601;
-    /** Paramètres absents ou mal typés. */
-    readonly INVALID_PARAMS: -32602;
-    /** Échec côté serveur. */
-    readonly INTERNAL_ERROR: -32603;
-};
-/**
- * Codes réservés par la spec MCP, hors plage JSON-RPC standard.
- *
- * Ils ne sont pas décoratifs : un client s'en sert pour se rattraper seul —
- * renégocier une version sur `-32022`, relire `tools/list` puis réessayer sur
- * `-32020`. Rendre un `-32600` générique à leur place le priverait de cette
- * reprise et transformerait un désaccord réparable en échec définitif.
- */
-export declare const McpProtocolError: {
-    /**
-     * Les en-têtes HTTP contredisent le corps, ou un en-tête requis manque.
-     * La spec impose `400` **et** ce code (`streamable-http` §Server Validation).
-     */
-    readonly HEADER_MISMATCH: -32020;
-    /**
-     * La révision demandée n'est pas servie. La réponse **doit** lister celles
-     * qu'on sert, sans quoi le client n'a rien pour choisir.
-     */
-    readonly UNSUPPORTED_PROTOCOL_VERSION: -32022;
-};
-/** Identifiant d'une requête JSON-RPC (jamais `null` pour une requête). */
-export type JsonRpcId = string | number;
-/** Message entrant : requête (avec `id`) ou notification (sans `id`). */
-export interface IJsonRpcMessage {
-    jsonrpc?: unknown;
-    id?: unknown;
-    method?: unknown;
-    params?: unknown;
-}
-/** Réponse JSON-RPC de succès. */
-export interface IJsonRpcSuccess {
-    jsonrpc: "2.0";
-    id: JsonRpcId;
-    result: unknown;
-}
-/** Réponse JSON-RPC d'erreur. */
-export interface IJsonRpcFailure {
-    jsonrpc: "2.0";
-    /** `null` quand l'erreur survient avant d'avoir pu lire un `id`. */
-    id: JsonRpcId | null;
-    error: {
-        code: number;
-        message: string;
-        data?: unknown;
-    };
-}
-/** Ce que le serveur MCP rend, avant traduction en réponse HTTP. */
-export interface IMcpHttpReply {
-    /** Statut HTTP à poser. */
-    status: number;
-    /**
-     * Corps JSON, ou `null` pour un `202 Accepted` sans corps — la spec l'exige
-     * pour une notification acceptée.
-     */
-    body: IJsonRpcSuccess | IJsonRpcFailure | null;
-}
-/** Fabrique une réponse de succès. */
-export declare function jsonRpcSuccess(id: JsonRpcId, result: unknown): IJsonRpcSuccess;
-/** Fabrique une réponse d'erreur. */
-export declare function jsonRpcFailure(id: JsonRpcId | null, code: number, message: string, data?: unknown): IJsonRpcFailure;
-/**
- * Un message est-il une NOTIFICATION (pas d'`id`) plutôt qu'une requête ?
- *
- * La distinction commande le statut HTTP : une notification acceptée rend
- * `202` **sans corps**, une requête rend son objet JSON.
- */
-export declare function isNotification(message: IJsonRpcMessage): boolean;

package/dist/types/nodefony/src/mcp/server.d.ts

@@ -1,48 +0,0 @@
-import { type IJsonRpcMessage, type IMcpHttpReply } from "./protocol.js";
-import { type IMcpToolDeps } from "./tools.js";
-/**
- * Cœur du serveur MCP : un message JSON-RPC entre, une réponse HTTP sort.
- *
- * **Fonction pure** — elle ne touche ni au socket, ni au conteneur, ni à
- * l'horloge. C'est ce qui permet d'éprouver le protocole entier (statuts
- * compris) sans démarrer de serveur, et c'est aussi ce qui rend le transport
- * interchangeable : le jour où un transport `stdio` serait nécessaire pour
- * répondre application éteinte, il appellerait cette même fonction.
- *
- * ## Ce que la révision 2026-07-28 change, et pourquoi c'est ce qui rend cette
- * porte viable
- *
- * Les sessions de niveau protocole ont disparu. Rien n'est retenu entre deux
- * appels : chaque `POST` porte tout ce qu'il faut pour être servi. Un
- * redémarrage du serveur de développement — celui que le superviseur déclenche
- * à chaque fichier sauvegardé — ne casse donc aucun état, et la réponse
- * suivante vient du code qui vient d'être rechargé. Aucun cache à invalider,
- * jamais : la fraîcheur est une propriété du protocole, pas une discipline.
- */
-/** Ce que ce serveur sait faire, annoncé à l'initialisation. */
-interface IServerInfo {
-    name: string;
-    version: string;
-}
-/** Tout ce dont le traitement d'un message a besoin. */
-export interface IMcpServerContext extends IMcpToolDeps {
-    /** Allowlist des outils (`devkit.mcp.tools`). */
-    tools: readonly string[];
-    /** Identité annoncée au client. */
-    serverInfo: IServerInfo;
-}
-/** En-têtes HTTP dont le protocole se sert. */
-export interface IMcpHeaders {
-    /** `MCP-Protocol-Version`, absent chez un client de l'ère legacy. */
-    protocolVersion?: string;
-}
-/**
- * Traite UN message JSON-RPC.
- *
- * @param message - corps du `POST`, déjà parsé
- * @param context - outils autorisés et briques qui répondent
- * @param headers - en-têtes du transport (`MCP-Protocol-Version`)
- * @returns statut HTTP et corps à écrire (corps `null` = `202` sans contenu)
- */
-export declare function handleMcpMessage(message: IJsonRpcMessage, context: IMcpServerContext, headers?: IMcpHeaders): Promise<IMcpHttpReply>;
-export {};

package/dist/types/nodefony/src/mcp/tools.d.ts

@@ -1,81 +0,0 @@
-import { type IAdminBrokerLike } from "nodefony";
-/**
- * Catalogue des outils MCP, et leur exécution.
- *
- * ⚠️ **Rien n'est calculé ici.** Chaque outil traduit un appel JSON-RPC vers une
- * brique qui répond DÉJÀ à une autre porte : `inspect` lit le plan
- * d'administration par `readAdminSubject` (la même fonction que la commande
- * `nodefony inspect`), `card` appelle le service du module (la même que la route
- * HTTP). Une source, plusieurs portes — un outil qui recalculerait sa réponse
- * finirait par contredire la commande, et c'est lui qu'on croirait sur parole.
- *
- * ⭐ **La description d'un outil est le premier critère de son déclenchement.**
- * Un modèle n'appelle pas ce qu'il ne comprend pas : le POC de 2026-05 l'a payé
- * cash — un outil à description neutre n'a jamais été appelé, un skill
- * auto-déclenché prenait la main à chaque fois. Ces descriptions disent donc ce
- * que l'outil rend ET quand s'en servir, pas seulement son nom.
- */
-/** Ce dont les outils ont besoin pour répondre — injecté, jamais lu ici. */
-export interface IMcpToolDeps {
-    /** Le service `adminBroker` du conteneur, ou `undefined` s'il manque. */
-    broker: IAdminBrokerLike | undefined;
-    /** Compose la carte de visite de l'application. */
-    getCard: () => unknown;
-    /**
-     * Racine depuis laquelle lire le disque (graphe symbolique, diagnostic).
-     *
-     * Injectée plutôt que lue par `process.cwd()` : le serveur répond dans le
-     * process de l'application, dont le dossier courant n'est pas garanti être
-     * celui du projet — et un outil qui diagnostiquerait le mauvais dossier
-     * conclurait « rien à signaler » avec aplomb.
-     */
-    projectRoot: string;
-}
-/** Un outil tel que `tools/list` le publie. */
-export interface IMcpToolDefinition {
-    name: string;
-    description: string;
-    inputSchema: Record<string, unknown>;
-}
-/** Ce que rend `tools/call` — du contenu, et l'aveu d'un échec métier. */
-export interface IMcpToolResult {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    isError?: boolean;
-}
-/**
- * Outils publiés, filtrés par l'allowlist de configuration.
- *
- * Une clé inconnue dans la configuration est simplement ignorée : elle ne peut
- * rien ouvrir. C'est le sens d'une allowlist — ce qui n'est pas nommé ICI
- * n'existe pas, et la faute de frappe d'un utilisateur ne peut pas activer
- * autre chose que ce qu'il voulait.
- *
- * ⚠️ **`Object.hasOwn` n'est pas une précaution de style.** Sans lui,
- * `tools: ["toString"]` résolvait une méthode héritée d'`Object.prototype` :
- * la valeur n'étant pas `undefined`, elle franchissait le filtre et un outil
- * fantôme entrait dans le catalogue publié. Trouvé par le test, pas à la
- * relecture.
- *
- * @param enabled - clés d'outils autorisées (`devkit.mcp.tools`)
- */
-export declare function listMcpTools(enabled: readonly string[]): IMcpToolDefinition[];
-/**
- * Exécute un outil par son nom public.
- *
- * Un échec métier (sujet inconnu, module absent) rend un résultat `isError`,
- * **pas** une erreur JSON-RPC : le protocole réserve celle-ci aux fautes de
- * protocole. La distinction compte pour l'agent — une erreur de protocole
- * signifie « tu t'y prends mal », un `isError` signifie « ta demande est
- * recevable, voici pourquoi elle n'aboutit pas » ; c'est la seconde qu'il peut
- * corriger seul.
- *
- * @param name - nom public de l'outil (`nodefony_inspect`…)
- * @param args - arguments fournis par l'agent
- * @param enabled - allowlist de configuration
- * @param deps - briques qui répondent réellement
- * @returns le résultat de l'outil, ou `null` si le nom n'est pas exposé
- */
-export declare function callMcpTool(name: string, args: Record<string, unknown>, enabled: readonly string[], deps: IMcpToolDeps): Promise<IMcpToolResult | null>;