@mostajs/kind-catalog 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 **Auteur** : Dr Hamid MADANI <drmdh@msn.com>
 
+## 0.1.1 — 2026-09-03
+
+### Ajouté — `bind` : lier une épreuve à l'essai qui la couvre DÉJÀ
+
+Constaté **en instanciant pour la première fois**, dans ATC. Une application qui reprend une fiche
+l'éprouve déjà, la plupart du temps : ATC vérifiait la garde de périmètre par cinq essais avant que
+la fiche n'existe.
+
+Sans liaison, la projection ajoutait **cinq essais `automated` sans renvoi** — c'est-à-dire cinq
+trous dans la porte qualité de l'application, et une invitation à réécrire ce qui existe.
+
+```js
+toDevtest(kinds, { project, prefix: 'ATC', bind: {
+  'KIND-PERIMETRE-01': ['test-scripts/unit/portail.test.mjs::T-POR-2', null, …],
+}})
+```
+
+**Une épreuve non liée devient `manual`, et c'est voulu** : elle reste visible dans le suivi comme
+un travail à faire, sans mentir sur son état. La déclarer `automated` sans renvoi prétendrait qu'un
+essai la couvre.
+
+`T-KC-6b` tient les deux cas. 23 essais.
+
 ## Non publié — 2026-09-02 (soir) · le corpus double par EXPLORATION du parc
 
 Sept applications du parc ont été relues — CRM/TRADING, LabTrax, CollabTrax, LabTraxAdmin, SofTrax,

package/docs/DEVTEST-PLAN.kind-catalog.json

@@ -407,6 +407,20 @@
           "expected": "au moins trois incidents, issus de projets DISTINCTS — une exigence rencontrée dans trois projets indépendants n'est plus une opinion d'auteur, c'est un fait du métier"
         }
       ]
+    },
+    {
+      "ref": "T-KC-6b",
+      "specRef": "SPEC-KC-03",
+      "type": "automated",
+      "priority": "critical",
+      "title": "T-KC-6b — une épreuve LIÉE devient automatisée ; non liée, elle reste MANUELLE",
+      "autoRef": "test-scripts/unit/catalogue.test.mjs::T-KC-6b",
+      "steps": [
+        {
+          "action": "projeter une fiche à deux épreuves, dont une seule liée à un essai réel",
+          "expected": "la liée est `automated` avec son renvoi ; l'autre est `manual` sans renvoi — la déclarer automatisée prétendrait qu'un essai la couvre, et ouvrirait un trou dans la porte qualité de l'application"
+        }
+      ]
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/kind-catalog",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Catalogue de KINDS — fiches d'exigence réutilisables, projetables en plan mostajs-devtest/1 lisible par qatrax. N'exécute rien, ne stocke rien.",
   "type": "module",
   "license": "AGPL-3.0-or-later",

package/src/projection.js

@@ -27,8 +27,20 @@ const corps = (ref) => propre(ref).replace(/^KIND-/, '');
  * @param {{key:string,name:string,description?:string}} o.project  le projet, au sens qatrax
  * @param {string} o.prefix  préfixe des références — `ATC`, `RESTO`… ISOLE deux applications qui
  *   reprennent la même fiche : sans lui, leurs plans se marcheraient dessus dans le même qatrax.
+ * @param {object} [o.bind]  ce que l'application COUVRE DÉJÀ : `{ 'KIND-X': [autoRef|null, …] }`,
+ *   une entrée par épreuve de la fiche, dans l'ordre.
+ *
+ * ⚠️ POURQUOI `bind` EXISTE — constaté le 03/09/2026, en instanciant pour la première fois.
+ * Une application qui reprend une fiche l'éprouve DÉJÀ, la plupart du temps : ATC vérifiait la
+ * garde de périmètre par cinq essais avant que la fiche n'existe. Sans `bind`, la projection
+ * ajoutait cinq essais `automated` SANS renvoi — c'est-à-dire cinq trous dans la porte qualité,
+ * et une invitation à réécrire ce qui existe.
+ *
+ * ⚠️ UNE ÉPREUVE NON LIÉE DEVIENT `manual`, ET C'EST VOULU. Elle reste visible dans le suivi
+ * comme un travail à faire, sans mentir sur son état : la déclarer `automated` sans renvoi
+ * prétendrait qu'un essai la couvre.
  */
-export function toDevtest(kinds = [], { project, prefix = 'APP' } = {}) {
+export function toDevtest(kinds = [], { project, prefix = 'APP', bind = {} } = {}) {
   if (!project?.key || !project?.name) throw new Error('toDevtest: `project` { key, name } requis');
   const p = propre(prefix).toUpperCase();
   const plan = { plan: PLAN_VERSION, project: { ...project }, specs: [], realisations: [], tests: [] };
@@ -61,13 +73,18 @@ export function toDevtest(kinds = [], { project, prefix = 'APP' } = {}) {
       status: 'todo',
     });
 
+    const lie = Array.isArray(bind?.[k.ref]) ? bind[k.ref] : [];
     k.test.forEach((t, i) => {
+      const renvoi = propre(lie[i]) || null;
       plan.tests.push({
         ref: `T-${p}-${corps(k.ref)}-${i + 1}`,
         specRef,
         title: `T-${p}-${corps(k.ref)}-${i + 1} — ${t.action}`,
-        type: 'automated',
+        // Lié à un essai réel → automatisé. Non lié → MANUEL : un travail à faire, pas un
+        // essai qu'on prétend avoir écrit.
+        type: renvoi ? 'automated' : 'manual',
         priority: 'critical',
+        ...(renvoi ? { autoRef: renvoi } : {}),
         steps: [{ action: t.action, expected: t.attendu }],
       });
     });