@jterrazz/test 12.1.0 → 13.0.0

package/dist/match.js

@@ -1,3 +1,75 @@
+import { basename, dirname, resolve } from "node:path";
+//#region src/core/specification/shared/fixtures.ts
+/**
+* Fixture path resolution + copy semantics for the `cli` facet's `.fixture()`.
+*
+* A fixture path is one of two shapes:
+*
+*  - `$FIXTURES/<rest>` — the shared pool at `<specs-root>/fixtures/<rest>`,
+*    where `<specs-root>` is the nearest ancestor directory named `specs`.
+*  - `<path>` (no marker) — feature-local, at `<test-dir>/fixtures/<path>`.
+*
+* Any other `$`-prefixed marker is a usage error (listed against the known
+* markers). Copy semantics mirror rsync's trailing-slash rule (see
+* {@link copyPlan}).
+*/
+/**
+* Markers understood in a `.fixture()` path. Extend here + in
+* {@link resolveFixtureSource}. Exported so the lint layer (rule
+* `jterrazz/b2-known-fixture-marker`) validates literals against the same list.
+*/
+const KNOWN_FIXTURE_MARKERS = ["$FIXTURES"];
+/**
+* Walk up from `startDir` to the nearest ancestor directory named `specs`.
+* Throws with guidance if none is found up to the filesystem root — the
+* `$FIXTURES` marker is meaningless without a specs root.
+*/
+function discoverSpecsRoot(startDir) {
+	let dir = startDir;
+	for (;;) {
+		if (basename(dir) === "specs") return dir;
+		const parent = dirname(dir);
+		if (parent === dir) break;
+		dir = parent;
+	}
+	throw new Error(`.fixture(): the $FIXTURES marker resolves to <specs-root>/fixtures, but no directory named "specs" was found walking up from ${startDir}. Move the specification under a specs/ directory, or use a feature-local fixtures/ path (no $FIXTURES marker).`);
+}
+/**
+* Resolve the absolute source path of a fixture, applying marker resolution.
+* The trailing slash (spread semantics) is preserved by callers via
+* {@link copyPlan} — it is irrelevant to source resolution.
+*/
+function resolveFixtureSource(path, testDir) {
+	const clean = path.replace(/\/+$/, "");
+	if (clean === "$FIXTURES" || path.startsWith("$FIXTURES/")) {
+		const rest = clean.slice(9).replace(/^\/+/, "");
+		return resolve(discoverSpecsRoot(testDir), "fixtures", rest);
+	}
+	if (path.startsWith("$")) {
+		const marker = clean.split("/")[0];
+		throw new Error(`.fixture("${path}"): unknown marker "${marker}". Known markers: ${KNOWN_FIXTURE_MARKERS.join(", ")}. A path without a marker is feature-local (resolved under <test-dir>/fixtures/).`);
+	}
+	return resolve(testDir, "fixtures", clean);
+}
+/**
+* Compute the source + destination for copying a fixture into the working
+* directory. Copy semantics follow rsync's trailing-slash rule:
+*
+*  - `dir/` (trailing slash) — the CONTENTS are spread into the cwd.
+*  - `dir`  (no slash, a directory) — the directory is copied as `<cwd>/<basename>`.
+*  - `file` — copied as `<cwd>/<basename>`.
+*
+* Chained `.fixture()` calls layer in order: a later fixture overwrites files
+* written by an earlier one.
+*/
+function copyPlan(path, testDir, workDir) {
+	const src = resolveFixtureSource(path, testDir);
+	return {
+		dest: /\/+$/.test(path) ? workDir : resolve(workDir, basename(src)),
+		src
+	};
+}
+//#endregion
 //#region src/core/matching/match.ts
 /** Every kind usable as a `{{token}}` in fixture files (all but ref/regex/includes). */
 const TOKEN_KINDS = [
@@ -161,4 +233,4 @@ var CaptureScope = class {
 	}
 };
 //#endregion
-export { match as i, Matcher as n, TOKEN_KINDS as r, CaptureScope as t };
+export { copyPlan as a, match as i, Matcher as n, resolveFixtureSource as o, TOKEN_KINDS as r, CaptureScope as t };

package/dist/oxlint.cjs

@@ -4,6 +4,7 @@ Object.defineProperties(exports, {
 });
 let node_path = require("node:path");
 let node_fs = require("node:fs");
+let node_url = require("node:url");
 //#region src/lint/fs-cache.ts
 /**
 * Cached filesystem probes for the fs-anchored rules (a9w, c2, c6, c7, i2).
@@ -305,7 +306,7 @@ const RULE_DOCS = {
 	},
 	"b4-given-then": {
 		channel: "statique",
-		convention: "Chaque test contient `// Given -` puis `// Then -` (les deux, dans cet ordre) ; Given déclaré après Then est une erreur.",
+		convention: "Chaque test contient `// Given -` puis `// Then -` (les deux, dans cet ordre) ; Given déclaré après Then est une erreur. Un document `<cas>.spec.yaml` n’a pas de commentaires : sa narration est sa `description:`.",
 		family: "B",
 		id: "B4",
 		rationale: "La narration Given/Then rend l’intention du test lisible sans lire les assertions."
@@ -452,7 +453,7 @@ const RULE_DOCS = {
 	},
 	"f1-no-subpath-import": {
 		channel: "statique",
-		convention: "Tout s’importe depuis `@jterrazz/test` ; un import de `@jterrazz/test/<subpath>` est une erreur, sauf le subpath tool-facing `@jterrazz/test/oxlint` (exempté partout).",
+		convention: "Tout s’importe depuis `@jterrazz/test` ; un import de `@jterrazz/test/<subpath>` est une erreur, sauf les subpaths que la map `exports` du paquet publie — `@jterrazz/test/oxlint` (plugin de lint) et `@jterrazz/test/vitest` (surface de configuration du runner) — exemptés partout. La liste est LUE du manifeste, jamais recopiée dans la règle.",
 		family: "F",
 		id: "F1",
 		rationale: "Un point d’entrée unique garde l’API publique explicite et les subpaths internes invisibles."
@@ -566,7 +567,7 @@ const RULE_DOCS = {
 const CHECKER_PASSES = [
 	{
 		channel: "checker",
-		convention: "Tout `{{token}}` dans une fixture `expected/` appartient au vocabulaire figé ; un token inconnu est une erreur.",
+		convention: "Tout `{{token}}` dans une fixture `expected/` — ou dans un flux attendu d’un document `<cas>.spec.yaml` — appartient au vocabulaire figé ; un token inconnu est une erreur.",
 		family: "D",
 		id: "D4",
 		name: "d4-unknown-token",
@@ -588,6 +589,94 @@ const CHECKER_PASSES = [
 		name: "d4b-http-first-line",
 		rationale: "La ligne d’ouverture distingue une requête d’une réponse — la contraindre attrape les fichiers mal placés."
 	},
+	{
+		channel: "checker",
+		convention: "Un document `<cas>.spec.yaml` respecte sa grammaire : clés fermées au niveau du document (`kind`, `description`, `fixture`, `env`, `serve`, `runs`) comme dans un run (`command`, `stdin`, `timeout`, `waitFor`, `exit`, `stdout`, `stderr`, `files`), `description:` et `runs:` obligatoires, `command:` et `exit:` obligatoires dans chaque run, `exit:` entier littéral, `waitFor:` seulement sur le dernier run et jamais avec `stdin:`, chemin `files:` relatif et sous le workdir.",
+		family: "D",
+		id: "D4b",
+		name: "d4b-spec-shape",
+		rationale: "La grammaire est lue par le parseur du runner lui-même : le document que le lint accepte est exactement celui que le runner exécute."
+	},
+	{
+		channel: "checker",
+		convention: "Les clés d’un `<cas>.spec.yaml` suivent l’ordre canonique — `kind, description, fixture, env, serve, runs` au niveau du document, `command, stdin, timeout, waitFor, exit, stdout, stderr, files` dans un run. Corrigeable (`--fix`).",
+		family: "D",
+		id: "D4b",
+		name: "d4b-spec-key-order",
+		rationale: "Le décor avant la session, l’entrée avant la sortie : un ordre unique rend les documents comparables et supprime les diffs qui ne changent rien."
+	},
+	{
+		channel: "checker",
+		convention: "`stdout`, `stderr`, `stdin` et `files.*.equals` d’un `<cas>.spec.yaml` s’écrivent en scalaire bloc (`|` garde le saut de ligne final, `|-` le supprime), jamais en chaîne entre guillemets avec des `\\n`. Corrigeable (`--fix`).",
+		family: "D",
+		id: "D4b",
+		name: "d4b-spec-block-scalar",
+		rationale: "Une sortie attendue doit ressembler à une sortie — une golden sur une ligne est illisible et aucun diff ne peut la montrer."
+	},
+	{
+		channel: "checker",
+		convention: "Un document se nomme `<cas>.spec.yaml` : `<cas>` en kebab-case, sans les mots `test`/`spec`/`cli` que le suffixe porte déjà, et jamais le nom nu de son dossier.",
+		family: "C",
+		id: "C12",
+		name: "c12-spec-file-name",
+		rationale: "Le nom du fichier est la première phrase que le lecteur lit ; `rm/rm.spec.yaml` ne dit rien deux fois."
+	},
+	{
+		channel: "checker",
+		convention: "La `description:` d’un document est un titre : une seule ligne, initiale minuscule (identifiant tout en majuscules exempté), sans point final, moins de 100 caractères.",
+		family: "J",
+		id: "J5",
+		name: "j5-spec-description",
+		rationale: "La description EST le titre vitest — les règles du titre s’y appliquent, pas celles d’un paragraphe."
+	},
+	{
+		channel: "checker",
+		convention: "Deux `<cas>.spec.yaml` d’un même dossier ne partagent pas leur `description:`.",
+		family: "J",
+		id: "J4",
+		name: "j4-spec-description-unique",
+		rationale: "Le rapporteur nomme le titre : deux titres identiques laissent deux fichiers à ouvrir."
+	},
+	{
+		channel: "checker",
+		convention: "Un flux attendu ne contient pas de valeur volatile littérale : origine loopback avec port (`127.0.0.1:8080`, `localhost:3000`), chemin temporaire absolu (`/tmp/`, `/private/tmp/`, `/var/folders/`) ou chemin home (`/Users/…`, `/home/…`). Le message nomme le token à écrire.",
+		family: "D",
+		id: "D5",
+		name: "d5-spec-volatile-literal",
+		rationale: "C’est exactement la forme qu’un `TEST_UPDATE` aurait tokenisée : en trouver une signifie qu’un token a été écrasé à la main."
+	},
+	{
+		channel: "checker",
+		convention: "Un horodatage ISO-8601 ou un uuid littéral dans un flux attendu → warning, sauf si la même valeur apparaît dans un `fixture:` ou un `stdin:` du même document (elle est alors fixée, pas volatile).",
+		family: "D",
+		id: "D5",
+		name: "d5w-spec-pinned-value",
+		rationale: "Le défaut n’est pas le littéral : c’est le littéral que rien n’a fixé."
+	},
+	{
+		channel: "checker",
+		convention: "Un flux attendu dont tout le contenu est `{{any}}` → warning : le run s’exécute et ne prouve rien.",
+		family: "J",
+		id: "J3",
+		name: "j3w-spec-empty-assertion",
+		rationale: "Le miroir de J3 pour les documents — une assertion qui accepte tout est une assertion absente."
+	},
+	{
+		channel: "checker",
+		convention: "Un run dont `exit:` est non nul sans `stdout:` ni `stderr:` → warning : le document ne dit pas pourquoi la commande a refusé.",
+		family: "D",
+		id: "D11",
+		name: "d11w-spec-silent-refusal",
+		rationale: "Un refus muet est soit un défaut du produit, soit une golden qui a oublié que les mots partaient sur stderr."
+	},
+	{
+		channel: "checker",
+		convention: "Les mots nus d’`env:` et les noms de `serve:` d’un document sont des clés des objets `env`/`serve` d’un `specification.cli(…)` du plus proche dossier portant des `*.specification.ts` (lecture statique des littéraux ; ignoré sinon).",
+		family: "C",
+		id: "C8",
+		name: "c8-spec-registered-name",
+		rationale: "Une faute de frappe (`serve: dashbord`) échoue aujourd’hui à l’exécution, un fichier de test plus tard ; ici c’est une ligne de lint."
+	},
 	{
 		channel: "checker",
 		convention: "Un token connu dans un fichier sous `requests/` → warning : les requêtes sont des entrées, jamais matchées.",
@@ -598,7 +687,7 @@ const CHECKER_PASSES = [
 	},
 	{
 		channel: "checker",
-		convention: "Aucune fixture morte : tout fichier sous `seeds/`/`requests/`/`fixtures/` et toute entrée de premier niveau de `expected/` doit être référencée ; un dossier de feature sans `*.test.ts` est orphelin (warning si argument non littéral).",
+		convention: "Aucune fixture morte : tout fichier sous `seeds/`/`requests/`/`fixtures/` et toute entrée de premier niveau de `expected/` doit être référencée ; un dossier de feature sans `*.test.ts` ni `*.spec.yaml` est orphelin (warning si argument non littéral). Un `<cas>.spec.yaml` référence les fixtures nommées par ses entrées `fixture:`.",
 		family: "C",
 		id: "C9",
 		name: "c9-dead-fixtures",
@@ -2625,22 +2714,88 @@ const d9wSingleUseRef = {
 	}
 };
 //#endregion
+//#region src/lint/package-exports.ts
+/**
+* The subpaths this package actually publishes, read from its OWN
+* `package.json` `exports` map.
+*
+* Rule F1 forbids importing `@jterrazz/test/<subpath>` — but a subpath the
+* package DECLARES is, by definition, part of its public contract
+* (`/oxlint` for the lint plugin, `/vitest` for the runner-config surface).
+* Deriving the exemption from the manifest rather than listing it in the rule
+* is what keeps the two from drifting: a subpath is exempt the moment it is
+* published, and stops being exempt the moment it is withdrawn — there is
+* nothing to remember to update.
+*
+* The manifest is found by walking up from THIS module, so the answer does not
+* depend on where the linted file sits: `<pkg>/dist/oxlint.js` in an install,
+* `<repo>/src/lint/` when the framework lints itself. `import.meta.url` is
+* safe in both bundle formats — the CJS build shims it to `__filename`.
+*/
+const PACKAGE$2 = "@jterrazz/test";
+/** Manifests are read once per lint process. */
+let cached = null;
+/**
+* Walk up from `startDir` for the `package.json` that declares {@link PACKAGE}.
+* The FIRST manifest found decides: if it names another package, the walk has
+* already left this package's tree and there is nothing to find above it.
+*/
+function findOwnManifest(startDir) {
+	let dir = startDir;
+	for (;;) {
+		const text = readFileCached((0, node_path.join)(dir, "package.json"));
+		if (text !== null) try {
+			const manifest = JSON.parse(text);
+			return manifest.name === PACKAGE$2 ? manifest : null;
+		} catch {
+			return null;
+		}
+		const parent = (0, node_path.dirname)(dir);
+		if (parent === dir) return null;
+		dir = parent;
+	}
+}
+/**
+* Every subpath specifier the package publishes — `@jterrazz/test/oxlint`,
+* `@jterrazz/test/vitest`, … The root export (`.`) is not a subpath and is
+* absent from the list.
+*
+* An unreadable manifest yields an EMPTY list: with no contract to read, no
+* subpath can be vouched for, and F1's plain rule applies.
+*
+* @internal Exported for unit tests.
+*/
+function declaredSubpaths(startDir) {
+	if (startDir === void 0 && cached !== null) return cached;
+	const exports = findOwnManifest(startDir ?? (0, node_path.dirname)((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href)))?.exports;
+	const subpaths = exports !== null && typeof exports === "object" ? Object.keys(exports).filter((key) => key.startsWith("./") && key !== ".").map((key) => `${PACKAGE$2}/${key.slice(2)}`).sort() : [];
+	if (startDir === void 0) cached = subpaths;
+	return subpaths;
+}
+//#endregion
 //#region src/lint/rules/f1-no-subpath-import.ts
 const PACKAGE$1 = "@jterrazz/test";
-const TOOL_SUBPATH$2 = "@jterrazz/test/oxlint";
 /**
-* CONVENTIONS F1 — everything is imported from `@jterrazz/test`; subpaths do
-* not exist. Sanctioned exception: `@jterrazz/test/oxlint`, the tool-facing,
-* zero-runtime plugin entry — exempt from any file (an oxlint config, a shared
-* preset, whatever wires the lint layer).
+* CONVENTIONS F1 — everything a SPEC needs is imported from `@jterrazz/test`;
+* internal subpaths do not exist.
+*
+* The exception is not a list kept here: it is the package's own `exports` map
+* (`/oxlint`, the tool-facing plugin entry; `/vitest`, the runner-config
+* surface `vitest.config.ts` imports). A published subpath IS the public
+* contract, so reading the manifest is what keeps the rule from outlawing an
+* import the package itself prescribes. Each is exempt from any file — an
+* oxlint config, a shared preset, a vitest config.
 */
 const f1NoSubpathImport = {
 	create(context) {
+		const allowed = new Set(declaredSubpaths());
 		return { ...importSourceVisitor(({ node, source }) => {
-			if (!source.startsWith(`${PACKAGE$1}/`)) return;
-			if (source === TOOL_SUBPATH$2) return;
+			if (!source.startsWith(`${PACKAGE$1}/`) || allowed.has(source)) return;
 			context.report({
-				data: { source },
+				data: {
+					published: allowed.size === 0 ? "none" : [...allowed].sort().join(", "),
+					source
+				},
 				messageId: "subpath",
 				node
 			});
@@ -2648,7 +2803,7 @@ const f1NoSubpathImport = {
 	},
 	meta: {
 		docs: RULE_DOCS["f1-no-subpath-import"],
-		messages: { subpath: "Import from \"@jterrazz/test\", not \"{{source}}\" — subpaths do not exist (F1 — see docs/10-linting.md; only the tool-facing @jterrazz/test/oxlint is exempt)." },
+		messages: { subpath: "Import from \"@jterrazz/test\", not \"{{source}}\" — internal subpaths do not exist (F1 — see docs/10-linting.md). Published subpaths, exempt everywhere: {{published}}." },
 		type: "problem"
 	}
 };

package/dist/oxlint.js

@@ -1,5 +1,6 @@
 import { basename, dirname, join, resolve } from "node:path";
 import { readFileSync, readdirSync, statSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 //#region src/lint/fs-cache.ts
 /**
 * Cached filesystem probes for the fs-anchored rules (a9w, c2, c6, c7, i2).
@@ -301,7 +302,7 @@ const RULE_DOCS = {
 	},
 	"b4-given-then": {
 		channel: "statique",
-		convention: "Chaque test contient `// Given -` puis `// Then -` (les deux, dans cet ordre) ; Given déclaré après Then est une erreur.",
+		convention: "Chaque test contient `// Given -` puis `// Then -` (les deux, dans cet ordre) ; Given déclaré après Then est une erreur. Un document `<cas>.spec.yaml` n’a pas de commentaires : sa narration est sa `description:`.",
 		family: "B",
 		id: "B4",
 		rationale: "La narration Given/Then rend l’intention du test lisible sans lire les assertions."
@@ -448,7 +449,7 @@ const RULE_DOCS = {
 	},
 	"f1-no-subpath-import": {
 		channel: "statique",
-		convention: "Tout s’importe depuis `@jterrazz/test` ; un import de `@jterrazz/test/<subpath>` est une erreur, sauf le subpath tool-facing `@jterrazz/test/oxlint` (exempté partout).",
+		convention: "Tout s’importe depuis `@jterrazz/test` ; un import de `@jterrazz/test/<subpath>` est une erreur, sauf les subpaths que la map `exports` du paquet publie — `@jterrazz/test/oxlint` (plugin de lint) et `@jterrazz/test/vitest` (surface de configuration du runner) — exemptés partout. La liste est LUE du manifeste, jamais recopiée dans la règle.",
 		family: "F",
 		id: "F1",
 		rationale: "Un point d’entrée unique garde l’API publique explicite et les subpaths internes invisibles."
@@ -562,7 +563,7 @@ const RULE_DOCS = {
 const CHECKER_PASSES = [
 	{
 		channel: "checker",
-		convention: "Tout `{{token}}` dans une fixture `expected/` appartient au vocabulaire figé ; un token inconnu est une erreur.",
+		convention: "Tout `{{token}}` dans une fixture `expected/` — ou dans un flux attendu d’un document `<cas>.spec.yaml` — appartient au vocabulaire figé ; un token inconnu est une erreur.",
 		family: "D",
 		id: "D4",
 		name: "d4-unknown-token",
@@ -584,6 +585,94 @@ const CHECKER_PASSES = [
 		name: "d4b-http-first-line",
 		rationale: "La ligne d’ouverture distingue une requête d’une réponse — la contraindre attrape les fichiers mal placés."
 	},
+	{
+		channel: "checker",
+		convention: "Un document `<cas>.spec.yaml` respecte sa grammaire : clés fermées au niveau du document (`kind`, `description`, `fixture`, `env`, `serve`, `runs`) comme dans un run (`command`, `stdin`, `timeout`, `waitFor`, `exit`, `stdout`, `stderr`, `files`), `description:` et `runs:` obligatoires, `command:` et `exit:` obligatoires dans chaque run, `exit:` entier littéral, `waitFor:` seulement sur le dernier run et jamais avec `stdin:`, chemin `files:` relatif et sous le workdir.",
+		family: "D",
+		id: "D4b",
+		name: "d4b-spec-shape",
+		rationale: "La grammaire est lue par le parseur du runner lui-même : le document que le lint accepte est exactement celui que le runner exécute."
+	},
+	{
+		channel: "checker",
+		convention: "Les clés d’un `<cas>.spec.yaml` suivent l’ordre canonique — `kind, description, fixture, env, serve, runs` au niveau du document, `command, stdin, timeout, waitFor, exit, stdout, stderr, files` dans un run. Corrigeable (`--fix`).",
+		family: "D",
+		id: "D4b",
+		name: "d4b-spec-key-order",
+		rationale: "Le décor avant la session, l’entrée avant la sortie : un ordre unique rend les documents comparables et supprime les diffs qui ne changent rien."
+	},
+	{
+		channel: "checker",
+		convention: "`stdout`, `stderr`, `stdin` et `files.*.equals` d’un `<cas>.spec.yaml` s’écrivent en scalaire bloc (`|` garde le saut de ligne final, `|-` le supprime), jamais en chaîne entre guillemets avec des `\\n`. Corrigeable (`--fix`).",
+		family: "D",
+		id: "D4b",
+		name: "d4b-spec-block-scalar",
+		rationale: "Une sortie attendue doit ressembler à une sortie — une golden sur une ligne est illisible et aucun diff ne peut la montrer."
+	},
+	{
+		channel: "checker",
+		convention: "Un document se nomme `<cas>.spec.yaml` : `<cas>` en kebab-case, sans les mots `test`/`spec`/`cli` que le suffixe porte déjà, et jamais le nom nu de son dossier.",
+		family: "C",
+		id: "C12",
+		name: "c12-spec-file-name",
+		rationale: "Le nom du fichier est la première phrase que le lecteur lit ; `rm/rm.spec.yaml` ne dit rien deux fois."
+	},
+	{
+		channel: "checker",
+		convention: "La `description:` d’un document est un titre : une seule ligne, initiale minuscule (identifiant tout en majuscules exempté), sans point final, moins de 100 caractères.",
+		family: "J",
+		id: "J5",
+		name: "j5-spec-description",
+		rationale: "La description EST le titre vitest — les règles du titre s’y appliquent, pas celles d’un paragraphe."
+	},
+	{
+		channel: "checker",
+		convention: "Deux `<cas>.spec.yaml` d’un même dossier ne partagent pas leur `description:`.",
+		family: "J",
+		id: "J4",
+		name: "j4-spec-description-unique",
+		rationale: "Le rapporteur nomme le titre : deux titres identiques laissent deux fichiers à ouvrir."
+	},
+	{
+		channel: "checker",
+		convention: "Un flux attendu ne contient pas de valeur volatile littérale : origine loopback avec port (`127.0.0.1:8080`, `localhost:3000`), chemin temporaire absolu (`/tmp/`, `/private/tmp/`, `/var/folders/`) ou chemin home (`/Users/…`, `/home/…`). Le message nomme le token à écrire.",
+		family: "D",
+		id: "D5",
+		name: "d5-spec-volatile-literal",
+		rationale: "C’est exactement la forme qu’un `TEST_UPDATE` aurait tokenisée : en trouver une signifie qu’un token a été écrasé à la main."
+	},
+	{
+		channel: "checker",
+		convention: "Un horodatage ISO-8601 ou un uuid littéral dans un flux attendu → warning, sauf si la même valeur apparaît dans un `fixture:` ou un `stdin:` du même document (elle est alors fixée, pas volatile).",
+		family: "D",
+		id: "D5",
+		name: "d5w-spec-pinned-value",
+		rationale: "Le défaut n’est pas le littéral : c’est le littéral que rien n’a fixé."
+	},
+	{
+		channel: "checker",
+		convention: "Un flux attendu dont tout le contenu est `{{any}}` → warning : le run s’exécute et ne prouve rien.",
+		family: "J",
+		id: "J3",
+		name: "j3w-spec-empty-assertion",
+		rationale: "Le miroir de J3 pour les documents — une assertion qui accepte tout est une assertion absente."
+	},
+	{
+		channel: "checker",
+		convention: "Un run dont `exit:` est non nul sans `stdout:` ni `stderr:` → warning : le document ne dit pas pourquoi la commande a refusé.",
+		family: "D",
+		id: "D11",
+		name: "d11w-spec-silent-refusal",
+		rationale: "Un refus muet est soit un défaut du produit, soit une golden qui a oublié que les mots partaient sur stderr."
+	},
+	{
+		channel: "checker",
+		convention: "Les mots nus d’`env:` et les noms de `serve:` d’un document sont des clés des objets `env`/`serve` d’un `specification.cli(…)` du plus proche dossier portant des `*.specification.ts` (lecture statique des littéraux ; ignoré sinon).",
+		family: "C",
+		id: "C8",
+		name: "c8-spec-registered-name",
+		rationale: "Une faute de frappe (`serve: dashbord`) échoue aujourd’hui à l’exécution, un fichier de test plus tard ; ici c’est une ligne de lint."
+	},
 	{
 		channel: "checker",
 		convention: "Un token connu dans un fichier sous `requests/` → warning : les requêtes sont des entrées, jamais matchées.",
@@ -594,7 +683,7 @@ const CHECKER_PASSES = [
 	},
 	{
 		channel: "checker",
-		convention: "Aucune fixture morte : tout fichier sous `seeds/`/`requests/`/`fixtures/` et toute entrée de premier niveau de `expected/` doit être référencée ; un dossier de feature sans `*.test.ts` est orphelin (warning si argument non littéral).",
+		convention: "Aucune fixture morte : tout fichier sous `seeds/`/`requests/`/`fixtures/` et toute entrée de premier niveau de `expected/` doit être référencée ; un dossier de feature sans `*.test.ts` ni `*.spec.yaml` est orphelin (warning si argument non littéral). Un `<cas>.spec.yaml` référence les fixtures nommées par ses entrées `fixture:`.",
 		family: "C",
 		id: "C9",
 		name: "c9-dead-fixtures",
@@ -2621,22 +2710,88 @@ const d9wSingleUseRef = {
 	}
 };
 //#endregion
+//#region src/lint/package-exports.ts
+/**
+* The subpaths this package actually publishes, read from its OWN
+* `package.json` `exports` map.
+*
+* Rule F1 forbids importing `@jterrazz/test/<subpath>` — but a subpath the
+* package DECLARES is, by definition, part of its public contract
+* (`/oxlint` for the lint plugin, `/vitest` for the runner-config surface).
+* Deriving the exemption from the manifest rather than listing it in the rule
+* is what keeps the two from drifting: a subpath is exempt the moment it is
+* published, and stops being exempt the moment it is withdrawn — there is
+* nothing to remember to update.
+*
+* The manifest is found by walking up from THIS module, so the answer does not
+* depend on where the linted file sits: `<pkg>/dist/oxlint.js` in an install,
+* `<repo>/src/lint/` when the framework lints itself. `import.meta.url` is
+* safe in both bundle formats — the CJS build shims it to `__filename`.
+*/
+const PACKAGE$2 = "@jterrazz/test";
+/** Manifests are read once per lint process. */
+let cached = null;
+/**
+* Walk up from `startDir` for the `package.json` that declares {@link PACKAGE}.
+* The FIRST manifest found decides: if it names another package, the walk has
+* already left this package's tree and there is nothing to find above it.
+*/
+function findOwnManifest(startDir) {
+	let dir = startDir;
+	for (;;) {
+		const text = readFileCached(join(dir, "package.json"));
+		if (text !== null) try {
+			const manifest = JSON.parse(text);
+			return manifest.name === PACKAGE$2 ? manifest : null;
+		} catch {
+			return null;
+		}
+		const parent = dirname(dir);
+		if (parent === dir) return null;
+		dir = parent;
+	}
+}
+/**
+* Every subpath specifier the package publishes — `@jterrazz/test/oxlint`,
+* `@jterrazz/test/vitest`, … The root export (`.`) is not a subpath and is
+* absent from the list.
+*
+* An unreadable manifest yields an EMPTY list: with no contract to read, no
+* subpath can be vouched for, and F1's plain rule applies.
+*
+* @internal Exported for unit tests.
+*/
+function declaredSubpaths(startDir) {
+	if (startDir === void 0 && cached !== null) return cached;
+	const exports = findOwnManifest(startDir ?? dirname(fileURLToPath(import.meta.url)))?.exports;
+	const subpaths = exports !== null && typeof exports === "object" ? Object.keys(exports).filter((key) => key.startsWith("./") && key !== ".").map((key) => `${PACKAGE$2}/${key.slice(2)}`).sort() : [];
+	if (startDir === void 0) cached = subpaths;
+	return subpaths;
+}
+//#endregion
 //#region src/lint/rules/f1-no-subpath-import.ts
 const PACKAGE$1 = "@jterrazz/test";
-const TOOL_SUBPATH$2 = "@jterrazz/test/oxlint";
 /**
-* CONVENTIONS F1 — everything is imported from `@jterrazz/test`; subpaths do
-* not exist. Sanctioned exception: `@jterrazz/test/oxlint`, the tool-facing,
-* zero-runtime plugin entry — exempt from any file (an oxlint config, a shared
-* preset, whatever wires the lint layer).
+* CONVENTIONS F1 — everything a SPEC needs is imported from `@jterrazz/test`;
+* internal subpaths do not exist.
+*
+* The exception is not a list kept here: it is the package's own `exports` map
+* (`/oxlint`, the tool-facing plugin entry; `/vitest`, the runner-config
+* surface `vitest.config.ts` imports). A published subpath IS the public
+* contract, so reading the manifest is what keeps the rule from outlawing an
+* import the package itself prescribes. Each is exempt from any file — an
+* oxlint config, a shared preset, a vitest config.
 */
 const f1NoSubpathImport = {
 	create(context) {
+		const allowed = new Set(declaredSubpaths());
 		return { ...importSourceVisitor(({ node, source }) => {
-			if (!source.startsWith(`${PACKAGE$1}/`)) return;
-			if (source === TOOL_SUBPATH$2) return;
+			if (!source.startsWith(`${PACKAGE$1}/`) || allowed.has(source)) return;
 			context.report({
-				data: { source },
+				data: {
+					published: allowed.size === 0 ? "none" : [...allowed].sort().join(", "),
+					source
+				},
 				messageId: "subpath",
 				node
 			});
@@ -2644,7 +2799,7 @@ const f1NoSubpathImport = {
 	},
 	meta: {
 		docs: RULE_DOCS["f1-no-subpath-import"],
-		messages: { subpath: "Import from \"@jterrazz/test\", not \"{{source}}\" — subpaths do not exist (F1 — see docs/10-linting.md; only the tool-facing @jterrazz/test/oxlint is exempt)." },
+		messages: { subpath: "Import from \"@jterrazz/test\", not \"{{source}}\" — internal subpaths do not exist (F1 — see docs/10-linting.md). Published subpaths, exempt everywhere: {{published}}." },
 		type: "problem"
 	}
 };