@nodefony/devkit 10.0.0-alpha.6 → 10.0.0-alpha.8

package/dist/_virtual/{_@oxc-project_runtime@0.149.0 → _@oxc-project_runtime@0.150.0}/helpers/esm/decorate.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.150.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);

package/dist/_virtual/{_@oxc-project_runtime@0.149.0 → _@oxc-project_runtime@0.150.0}/helpers/esm/decorateMetadata.js

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

package/dist/_virtual/{_@oxc-project_runtime@0.149.0 → _@oxc-project_runtime@0.150.0}/helpers/esm/decorateParam.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorateParam.js
+//#region \0@oxc-project+runtime@0.150.0/helpers/esm/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);

package/dist/index.js

@@ -1,8 +1,8 @@
 import defaults, { devkitConfigSchema } from "./nodefony/config/config.js";
 import { defineDevkitConfig } from "./nodefony/config/defineModuleConfig.js";
 import { buildCard } from "./nodefony/src/card.js";
-import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "./_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "./_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import DevkitService_default from "./nodefony/service/DevkitService.js";
 import DevkitController_default from "./nodefony/controllers/DevkitController.js";
 import McpController_default from "./nodefony/controllers/McpController.js";

package/dist/nodefony/controllers/DevkitController.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import { Controller, controller, route } from "@nodefony/framework";
 //#region nodefony/controllers/DevkitController.ts
 /**

package/dist/nodefony/controllers/McpController.js

@@ -1,6 +1,6 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
-import __decorateParam from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateParam.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateParam from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateParam.js";
 import { ACCESS_TOKEN_VERIFIER, JsonRpcError, Nodefony, authorizeProtectedResource, checkMcpAccess, collectMcpTools, handleMcpMessage, jsonRpcFailure, mcpCallerRoles, protectedResourceMetadataUrl, readBearerHeader } from "nodefony";
 import { Body, Controller, Headers, controller, route } from "@nodefony/framework";
 //#region nodefony/controllers/McpController.ts

package/dist/nodefony/service/DevkitService.js

@@ -1,7 +1,7 @@
 import defaults from "../config/config.js";
 import { buildCard } from "../src/card.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import { Module, Nodefony, Service, extend, injectable, mcpDeclaredScopes } from "nodefony";
 //#region nodefony/service/DevkitService.ts
 /**

package/docs/index.md

@@ -264,8 +264,8 @@ est absent de `tools/list` **et** inappelable en le nommant, et le refus dit
 
 > 🔴 **Tant que la porte n'authentifie personne, un outil à scopes ne sortira
 > jamais.** C'est le comportement voulu — fermé par défaut — mais il faut le
-> savoir avant de chercher une panne : `caller` vaut `{ authenticated: false,
-scopes: [] }` tant que le rôle _resource server_ décrit plus haut n'est pas
+> savoir avant de chercher une panne : `caller` vaut
+> `{ authenticated: false, scopes: [] }` tant que le rôle _resource server_ décrit plus haut n'est pas
 > branché. Le jour où il le sera, ces déclarations prendront effet sans qu'une
 > ligne d'outil change.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodefony/devkit",
-  "version": "10.0.0-alpha.6",
+  "version": "10.0.0-alpha.8",
   "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": "^10.0.0-alpha.6",
-    "@nodefony/http": "^10.0.0-alpha.6",
-    "nodefony": "^10.0.0-alpha.6",
-    "zod": "^4.6.1",
+    "@nodefony/framework": "^10.0.0-alpha.8",
+    "@nodefony/http": "^10.0.0-alpha.8",
+    "nodefony": "^10.0.0-alpha.8",
+    "zod": "^4.6.5",
     "playwright": "^1.50.0",
     "lighthouse": "^13.0.0"
   },
   "devDependencies": {
-    "@nodefony/framework": "^10.0.0-alpha.6",
-    "@nodefony/http": "^10.0.0-alpha.6",
-    "nodefony": "^10.0.0-alpha.6"
+    "@nodefony/framework": "^10.0.0-alpha.8",
+    "@nodefony/http": "^10.0.0-alpha.8",
+    "nodefony": "^10.0.0-alpha.8"
   },
   "dependencies": {
     "axe-core": "4.13.0",

package/skills/nodefony-add-crud/SKILL.md

@@ -17,6 +17,15 @@ description: >
 
 # add-crud — une ressource complète, générée
 
+> 🧭 **Tu es arrivé ici directement ? Charge aussi `nodefony-dev`** — il porte la conduite
+> commune (par où commencer, comment prouver que c'est fait) et les pièges qui coûtent une heure,
+> serveur comme front. Cette page-ci ne couvre QUE son geste.
+>
+> Et si une réponse te manque, elle est probablement INSTALLÉE : `rg` ne descend pas dans
+> `node_modules`, donc 70 pages de documentation y paraissent absentes. Une commande les lit, avec
+> la ligne exacte :
+> `node node_modules/@nodefony/devkit/skills/nodefony-dev/scripts/docs.mjs <termes>`.
+
 > ⚖️ **La confiance n'exclut pas le contrôle.** Ce que le générateur produit se relit ;
 > ce que tu écris à la main se prouve par un test.
 
@@ -35,7 +44,7 @@ se connecte qu'au démarrage), la pagination bornée **et son tri déclaré**, l
 
 ## La grammaire de champs
 
-`nom:type[?|!][:index]` — **non-null par défaut**, `?` rend facultatif, `!` pose une contrainte
+`nom:type[?][:index|:unique]` — **non-null par défaut**, `?` rend facultatif, `:unique` pose une contrainte
 d'unicité, `:index` un index simple.
 
 | Type     | Ce que ça produit       |
@@ -73,7 +82,7 @@ index utiles sont composites : c'est ainsi qu'une table est réellement interrog
 Trois réglages, et ils ne touchent **que** le SQL — la propriété TypeScript reste `id`, `siteId` :
 
 ```bash
-npx nodefony create entity Session token:string! --table user_sessions --column-case snake --id-name session_id
+npx nodefony create entity Session token:string:unique --table user_sessions --column-case snake --id-name session_id
 ```
 
 Faire suivre le TypeScript aurait transformé un réglage de nommage en refonte : le service, le

package/skills/nodefony-add-realtime-channel/SKILL.md

@@ -13,6 +13,15 @@ description: >
 
 # add-realtime-channel — le temps réel par sa couche
 
+> 🧭 **Tu es arrivé ici directement ? Charge aussi `nodefony-dev`** — il porte la conduite
+> commune (par où commencer, comment prouver que c'est fait) et les pièges qui coûtent une heure,
+> serveur comme front. Cette page-ci ne couvre QUE son geste.
+>
+> Et si une réponse te manque, elle est probablement INSTALLÉE : `rg` ne descend pas dans
+> `node_modules`, donc 70 pages de documentation y paraissent absentes. Une commande les lit, avec
+> la ligne exacte :
+> `node node_modules/@nodefony/devkit/skills/nodefony-dev/scripts/docs.mjs <termes>`.
+
 > ⚖️ **La confiance n'exclut pas le contrôle.** Un canal sans politique est **public par
 > construction** — c'est le comportement voulu du framework, pas un oubli. Ce qui n'est pas
 > déclaré fermé est ouvert.

package/skills/nodefony-add-service/SKILL.md

@@ -14,6 +14,15 @@ description: >
 
 # add-service — un service que le conteneur connaît
 
+> 🧭 **Tu es arrivé ici directement ? Charge aussi `nodefony-dev`** — il porte la conduite
+> commune (par où commencer, comment prouver que c'est fait) et les pièges qui coûtent une heure,
+> serveur comme front. Cette page-ci ne couvre QUE son geste.
+>
+> Et si une réponse te manque, elle est probablement INSTALLÉE : `rg` ne descend pas dans
+> `node_modules`, donc 70 pages de documentation y paraissent absentes. Une commande les lit, avec
+> la ligne exacte :
+> `node node_modules/@nodefony/devkit/skills/nodefony-dev/scripts/docs.mjs <termes>`.
+
 > ⚖️ **La confiance n'exclut pas le contrôle.** Un service qui compile n'est pas un service
 > enregistré. Le seul juge est l'application en marche.
 

package/skills/nodefony-browser/SKILL.md

@@ -1,40 +1,48 @@
 ---
 name: nodefony-browser
 description: >
-  Ouvre un écran de ton application dans un navigateur piloté pour le VOIR et surtout le MESURER —
+  Ouvre un écran de ton application Nodefony dans un navigateur piloté pour le VOIR et surtout le MESURER —
   contrastes et tailles réellement calculés par le moteur de rendu, audit d'accessibilité par
-  axe-core, erreurs de console, requêtes HTTP, frames WebSocket. Fonctionne sur ta machine
-  (Playwright) ou dans un conteneur jetable, au choix. Porte les sondes prêtes à l'emploi, le choix
-  du thème clair ou sombre — un défaut d'affichage n'existe souvent que dans l'un des deux —, les
-  contraintes de réseau qui font répondre `421` ou `401` à une application pourtant saine, et les
-  pièges qui font conclure FAUX : mesurer avant que l'écran soit peuplé, observer un bundle qui
-  n'est plus celui du code, prendre une condition d'arrêt qui réussit toujours. Sait aussi piloter
-  un socket temps réel de bout en bout : accueil, abonnement à un canal, action, latence médiane,
-  pont API, reconnexion. À charger AVANT de conclure quoi que ce soit sur un écran.
+  axe-core, erreurs de console, requêtes HTTP, frames WebSocket, sur ta machine ou dans un
+  conteneur jetable. Porte les sondes prêtes à l'emploi, le thème clair ou sombre — un défaut
+  d'affichage n'existe souvent que dans l'un des deux —, et les pièges qui font conclure FAUX :
+  mesurer avant que l'écran soit peuplé, ou observer un bundle qui n'est plus celui du code. Sait
+  aussi piloter un socket temps réel de bout en bout. À charger AVANT de conclure quoi que ce
+  soit sur un écran.
   Déclencheurs : "regarde l'écran", "vérifie l'affichage", "est-ce que ça s'affiche ?",
-  "montre-moi la page", "lis la console", "y a-t-il des erreurs JS ?", "mesure le contraste",
-  "cette couleur est-elle lisible ?", "capture d'écran", "vérifie l'accessibilité",
-  "audit accessibilité", "audit WCAG", "en mode clair", "en mode sombre", "le thème sombre",
-  "la page est-elle rapide ?", "temps de chargement", "responsive ?",
-  "quelles requêtes fait la page ?", "le temps réel arrive-t-il jusqu'à l'écran ?",
-  "teste le socket", "mesure la latence du websocket", "le canal pousse-t-il ?",
-  "l'application démarre-t-elle vraiment ?".
+  "lis la console", "y a-t-il des erreurs JS ?", "mesure le contraste", "capture d'écran",
+  "vérifie l'accessibilité", "audit WCAG", "en mode sombre", "la page est-elle rapide ?",
+  "quelles requêtes fait la page ?", "teste le socket".
 ---
 
 # see-screen — voir et MESURER un écran
 
+> 🧭 **Tu es arrivé ici directement ? Charge aussi `nodefony-dev`** — il porte la conduite
+> commune (par où commencer, comment prouver que c'est fait) et les pièges qui coûtent une heure,
+> serveur comme front. Cette page-ci ne couvre QUE son geste.
+>
+> Et si une réponse te manque, elle est probablement INSTALLÉE : `rg` ne descend pas dans
+> `node_modules`, donc 70 pages de documentation y paraissent absentes. Une commande les lit, avec
+> la ligne exacte :
+> `node node_modules/@nodefony/devkit/skills/nodefony-dev/scripts/docs.mjs <termes>`.
+
 > ⚖️ **La confiance n'exclut pas le contrôle.** Un `curl` prouve qu'une route répond ; il ne dit
 > pas si l'écran se monte, s'alimente et ne crie pas dans la console.
 
 ## Le geste — sur ta machine
 
 ```bash
-npm run see:setup    # dans une application générée — pose `playwright` et `axe-core`
-node node_modules/@nodefony/devkit/skills/nodefony-browser/scripts/inspect.mjs /
+npx nodefony see /              # dans une application : mesure l'écran
+npx nodefony see / --install    # la même, en posant d'abord `playwright` et `axe-core`
 ```
 
-Hors d'une application générée, le premier pas s'écrit en toutes lettres : `npm i -D playwright
-axe-core`, puis `npx playwright install chromium` si aucun navigateur n'est déjà là (§ suivant).
+La commande résout elle-même la sonde et **dit ce qui manque** plutôt que d'échouer sur une trace de
+résolution. Elle n'installe rien sans `--install` : l'outillage d'un navigateur piloté pèse des
+centaines de mégaoctets une fois les navigateurs posés.
+
+Hors d'une application Nodefony, le premier pas s'écrit en toutes lettres : `npm i -D playwright
+axe-core`, puis `npx playwright install chromium` si aucun navigateur n'est déjà là (§ suivant), et
+la sonde se lance par son chemin (`node node_modules/@nodefony/devkit/skills/nodefony-browser/scripts/inspect.mjs /`).
 
 C'est tout. Les sondes **constatent** où elles s'exécutent : sur ta machine elles visent
 `https://127.0.0.1:5152` et déposent leurs captures dans `tmp/browser/`. Rien à configurer tant que
@@ -275,9 +283,9 @@ Lighthouse complet, y compris **derrière une authentification** — ce que l'ex
 ne sait pas faire sur une application protégée.
 
 ```bash
-npm run audit:setup                      # pose `lighthouse` — SÉPARÉ de `see:setup` : une vingtaine
-                                         # de mégaoctets, que tu ne paies que si tu audites
-npm run audit:web -- /tableau-de-bord
+npx nodefony see /tableau-de-bord --audit             # audite
+npx nodefony see /tableau-de-bord --audit --install   # pose `lighthouse` (une vingtaine de
+                                                      # mégaoctets, payés seulement si tu audites)
 ```
 
 Hors d'une application générée, ou pour passer des identifiants :