@jterrazz/test 9.0.0 → 9.2.0

package/dist/oxlint.js

@@ -162,7 +162,7 @@ const RULE_DOCS = {
 	},
 	"a2-known-constructors": {
 		channel: "statique",
-		convention: "Trois constructeurs et seulement trois : `specification.api()`, `specification.jobs()`, `specification.cli(bin)` ; tout autre membre (`.app`, `.http`, `.stack`…) est une erreur.",
+		convention: "Quatre constructeurs et seulement quatre : `specification.api()`, `specification.jobs()`, `specification.cli(bin)`, `specification.website()` ; tout autre membre (`.app`, `.http`, `.stack`…) est une erreur.",
 		family: "A",
 		id: "A2",
 		rationale: "Une surface fermée empêche l’invention de constructeurs parallèles et garde l’API mémorisable."
@@ -432,6 +432,22 @@ const RULE_DOCS = {
 		family: "J",
 		id: "J5",
 		rationale: "Un titre est un fragment de prose, pas une phrase — la casse minuscule le garde fragmentaire ; minusculiser un symbole nommé le mal-orthographierait."
+	},
+	"w1-scenario-pure": {
+		channel: "statique",
+		convention: "Un scénario de visite est le When : le visiteur agit, la capture reflète l’état final ; aucun `expect()` dans le callback — les assertions vivent dans le Then, sur le résultat retourné.",
+		facet: "website",
+		family: "W",
+		id: "W1",
+		rationale: "Séparer l’interaction de l’assertion garde la grammaire setup → action → résultat intacte et les scénarios rejouables."
+	},
+	"w2w-user-facing-elements": {
+		channel: "statique",
+		convention: "Les éléments d’un scénario sont user-facing (`button`, `link`, `field`, `heading`, `content`) ; `testId()` est l’unique échappatoire et déclenche un avertissement.",
+		facet: "website",
+		family: "W",
+		id: "W2",
+		rationale: "Tester ce que l’utilisateur voit (rôles, labels) rend les specs robustes aux refontes DOM ; un test-id contourne cette garantie."
 	}
 };
 /**
@@ -653,7 +669,7 @@ const a1SpecificationFile = {
 	},
 	meta: {
 		docs: RULE_DOCS["a1-specification-file"],
-		messages: { outsideSpecification: "specification.{{member}}() must be called from a `*.specification.ts` file under specs/ (CONVENTIONS A1)." },
+		messages: { outsideSpecification: "specification.{{member}}() must be called from a `*.specification.ts` file under specs/ (A1 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
@@ -730,22 +746,24 @@ const a10DuplicateBinding = {
 	},
 	meta: {
 		docs: RULE_DOCS["a10-duplicate-binding"],
-		messages: { duplicate: "Service keys \"{{first}}\" and \"{{key}}\" both bind to compose service \"{{binding}}\" — one shadows the other; rename a key or set distinct composeService values (CONVENTIONS A10)." },
+		messages: { duplicate: "Service keys \"{{first}}\" and \"{{key}}\" both bind to compose service \"{{binding}}\" — one shadows the other; rename a key or set distinct composeService values (A10 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
 //#endregion
 //#region src/lint/rules/a2-known-constructors.ts
-/** The three constructors, and only three (CONVENTIONS A2). */
+/** The four constructors, and only four (A2 — see docs/10-linting.md). */
 const KNOWN_CONSTRUCTORS = /* @__PURE__ */ new Set([
 	"api",
 	"cli",
-	"jobs"
+	"jobs",
+	"website"
 ]);
 /**
-* CONVENTIONS A2 — `specification.api()`, `specification.jobs()` and
-* `specification.cli()` are the only members. Any other access
-* (`specification.app`, `.http`, `.stack`, …) is flagged at the member site.
+* CONVENTIONS A2 — `specification.api()`, `specification.jobs()`,
+* `specification.cli()` and `specification.website()` are the only members.
+* Any other access (`specification.app`, `.http`, `.stack`, …) is flagged at
+* the member site.
 */
 const a2KnownConstructors = {
 	create(context) {
@@ -762,7 +780,7 @@ const a2KnownConstructors = {
 	},
 	meta: {
 		docs: RULE_DOCS["a2-known-constructors"],
-		messages: { unknownConstructor: "specification.{{member}} does not exist — the only constructors are specification.api(), specification.jobs() and specification.cli() (CONVENTIONS A2)." },
+		messages: { unknownConstructor: "specification.{{member}} does not exist — the only constructors are specification.api(), specification.jobs(), specification.cli() and specification.website() (A2 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
@@ -807,7 +825,7 @@ const a3NoDestructureAlias = {
 	},
 	meta: {
 		docs: RULE_DOCS["a3-no-destructure-alias"],
-		messages: { aliased: "Destructure the specification result with its canonical name: `{{key}}`, not `{{key}}: {{alias}}` (CONVENTIONS A3). Rename at the import site if a different local name is needed." },
+		messages: { aliased: "Destructure the specification result with its canonical name: `{{key}}`, not `{{key}}: {{alias}}` (A3 — see docs/10-linting.md). Rename at the import site if a different local name is needed." },
 		type: "problem"
 	}
 };
@@ -859,7 +877,7 @@ const a4CleanupAfterall = {
 	},
 	meta: {
 		docs: RULE_DOCS["a4-cleanup-afterall"],
-		messages: { unregistered: "`cleanup` is destructured but never passed to afterAll — add `afterAll(cleanup)` to the specification file (CONVENTIONS A4)." },
+		messages: { unregistered: "`cleanup` is destructured but never passed to afterAll — add `afterAll(cleanup)` to the specification file (A4 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
@@ -889,7 +907,7 @@ const a5ModeWithServer = {
 	},
 	meta: {
 		docs: RULE_DOCS["a5-mode-with-server"],
-		messages: { hardcodedMode: "`mode` must not be hardcoded when `server` is defined — the node/compose switch lives in vitest.config.ts via `env: { TEST_MODE: \"compose\" }` (CONVENTIONS A5)." },
+		messages: { hardcodedMode: "`mode` must not be hardcoded when `server` is defined — the node/compose switch lives in vitest.config.ts via `env: { TEST_MODE: \"compose\" }` (A5 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
@@ -930,7 +948,7 @@ const a6wRedundantComposeService = {
 	},
 	meta: {
 		docs: RULE_DOCS["a6w-redundant-compose-service"],
-		messages: { redundant: "composeService: \"{{name}}\" is redundant — the key \"{{key}}\" already binds to it (exact name or kebab-case derivation, CONVENTIONS A6)." },
+		messages: { redundant: "composeService: \"{{name}}\" is redundant — the key \"{{key}}\" already binds to it (exact name or kebab-case derivation, A6 — see docs/10-linting.md)." },
 		type: "suggestion"
 	}
 };
@@ -994,7 +1012,7 @@ function readFileCached(path) {
 //#endregion
 //#region src/lint/rules/a9w-redundant-root.ts
 /**
-* The root the convention would derive (CONVENTIONS A9): walk up from the
+* The root the convention would derive (A9 — see docs/10-linting.md): walk up from the
 * specification file to the first directory containing
 * `docker/compose.test.yaml`, else the first containing `package.json`.
 */
@@ -1033,7 +1051,7 @@ const a9wRedundantRoot = {
 	},
 	meta: {
 		docs: RULE_DOCS["a9w-redundant-root"],
-		messages: { redundant: "root: \"{{root}}\" is redundant — walking up from the specification file already resolves to that directory (CONVENTIONS A9)." },
+		messages: { redundant: "root: \"{{root}}\" is redundant — walking up from the specification file already resolves to that directory (A9 — see docs/10-linting.md)." },
 		type: "suggestion"
 	}
 };
@@ -1097,7 +1115,7 @@ const b2KnownFixtureMarker = {
 	},
 	meta: {
 		docs: RULE_DOCS["b2-known-fixture-marker"],
-		messages: { unknownMarker: "Unknown fixture marker \"{{marker}}\" — known markers: {{known}}. A path without a marker is feature-local (CONVENTIONS B2)." },
+		messages: { unknownMarker: "Unknown fixture marker \"{{marker}}\" — known markers: {{known}}. A path without a marker is feature-local (B2 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
@@ -1162,8 +1180,8 @@ const b4GivenThen = {
 	meta: {
 		docs: RULE_DOCS["b4-given-then"],
 		messages: {
-			givenAfterThen: "The `// Given -` marker comes after `// Then -` — Given describes the setup and must precede Then (CONVENTIONS B4).",
-			missing: "Test is missing a `// {{marker}} -` comment (CONVENTIONS B4 — every test needs both `// Given -` and `// Then -`)."
+			givenAfterThen: "The `// Given -` marker comes after `// Then -` — Given describes the setup and must precede Then (B4 — see docs/10-linting.md).",
+			missing: "Test is missing a `// {{marker}} -` comment (B4 — see docs/10-linting.md — every test needs both `// Given -` and `// Then -`)."
 		},
 		type: "problem"
 	}
@@ -1204,7 +1222,7 @@ const b5AwaitUsing = {
 	meta: {
 		docs: RULE_DOCS["b5-await-using"],
 		defaultOptions: [{ runners: [] }],
-		messages: { requireAwaitUsing: "The result of docker-aware runner \"{{runner}}\" must be bound with `await using` so its containers are disposed (CONVENTIONS B5)." },
+		messages: { requireAwaitUsing: "The result of docker-aware runner \"{{runner}}\" must be bound with `await using` so its containers are disposed (B5 — see docs/10-linting.md)." },
 		schema: [{
 			additionalProperties: false,
 			properties: { runners: {
@@ -1247,7 +1265,7 @@ const b6wRedundantEnvUrl = {
 	},
 	meta: {
 		docs: RULE_DOCS["b6w-redundant-env-url"],
-		messages: { redundant: ".env({ {{key}}: ….connectionString }) is redundant — the framework already injects <KEY>_URL (and the DATABASE_URL/REDIS_URL aliases) for every service (CONVENTIONS B6)." },
+		messages: { redundant: ".env({ {{key}}: ….connectionString }) is redundant — the framework already injects <KEY>_URL (and the DATABASE_URL/REDIS_URL aliases) for every service (B6 — see docs/10-linting.md)." },
 		type: "suggestion"
 	}
 };
@@ -1276,7 +1294,7 @@ const b8KebabTrigger = {
 	},
 	meta: {
 		docs: RULE_DOCS["b8-kebab-trigger"],
-		messages: { notKebab: "Job name \"{{name}}\" must be a stable kebab-case identifier (e.g. \"nightly-report\") — it is a contract between the app and its tests (CONVENTIONS B8)." },
+		messages: { notKebab: "Job name \"{{name}}\" must be a stable kebab-case identifier (e.g. \"nightly-report\") — it is a contract between the app and its tests (B8 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
@@ -1331,7 +1349,7 @@ const b9wProductCommand = {
 	},
 	meta: {
 		docs: RULE_DOCS["b9w-product-command"],
-		messages: { thirdPartyBinary: "specification.cli() points at a third-party binary in node_modules/.bin — a spec should exercise your product command (cli.exec(\"check\"), …), not the tool underneath (CONVENTIONS B9). Suppress with a reason if the product genuinely is this binary." },
+		messages: { thirdPartyBinary: "specification.cli() points at a third-party binary in node_modules/.bin — a spec should exercise your product command (cli.exec(\"check\"), …), not the tool underneath (B9 — see docs/10-linting.md). Suppress with a reason if the product genuinely is this binary." },
 		type: "suggestion"
 	}
 };
@@ -1387,9 +1405,9 @@ const c1DomainStructure = {
 	meta: {
 		docs: RULE_DOCS["c1-domain-structure"],
 		messages: {
-			specNotAtFacetRoot: "A `*.specification.ts` must sit at the facet root: `specs/<facet>/<name>.specification.ts` (CONVENTIONS C1).",
-			testAtFacetRoot: "A `*.test.ts` must live in a domain folder: `specs/<facet>/<domain>/<aspect>.test.ts` — tests directly at the facet root are forbidden (CONVENTIONS C1).",
-			testTooDeep: "A `*.test.ts` must sit at facet/domain depth: `specs/<facet>/<domain>/<aspect>.test.ts` — no deeper nesting (CONVENTIONS C1)."
+			specNotAtFacetRoot: "A `*.specification.ts` must sit at the facet root: `specs/<facet>/<name>.specification.ts` (C1 — see docs/10-linting.md).",
+			testAtFacetRoot: "A `*.test.ts` must live in a domain folder: `specs/<facet>/<domain>/<aspect>.test.ts` — tests directly at the facet root are forbidden (C1 — see docs/10-linting.md).",
+			testTooDeep: "A `*.test.ts` must sit at facet/domain depth: `specs/<facet>/<domain>/<aspect>.test.ts` — no deeper nesting (C1 — see docs/10-linting.md)."
 		},
 		type: "problem"
 	}
@@ -1419,13 +1437,13 @@ const c2HttpOnlyRequests = {
 	},
 	meta: {
 		docs: RULE_DOCS["c2-http-only-requests"],
-		messages: { notHttp: "requests/{{entry}} is not a .http file — requests/ contains only complete .http request files (CONVENTIONS C2)." },
+		messages: { notHttp: "requests/{{entry}} is not a .http file — requests/ contains only complete .http request files (C2 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
 //#endregion
 //#region src/lint/rules/c4-contract-shape.ts
-/** Providers a contract file may declare (CONVENTIONS C4). */
+/** Providers a contract file may declare (C4 — see docs/10-linting.md). */
 const PROVIDERS = /* @__PURE__ */ new Set([
 	"anthropic",
 	"http",
@@ -1491,12 +1509,12 @@ const c4ContractShape = {
 	meta: {
 		docs: RULE_DOCS["c4-contract-shape"],
 		messages: {
-			badName: "Contract file \"{{base}}\" must be named <name>.<provider>.ts with provider ∈ openai | anthropic | http (CONVENTIONS C4).",
-			foreignImport: "Contract imports \"{{source}}\" — a contract imports only from the public entry (@jterrazz/test) (CONVENTIONS C4).",
-			missingDefault: "Contract file has no `export default defineContract(...)` (CONVENTIONS C4).",
-			namedExport: "Contract files have no named exports — only `export default defineContract(...)` (CONVENTIONS C4).",
-			notDefineContract: "The default export of a contract file must be `defineContract(...)` syntactically (CONVENTIONS C4).",
-			subfolder: "Contract file \"{{base}}\" is nested — contracts/ is flat, no subfolders (CONVENTIONS C4)."
+			badName: "Contract file \"{{base}}\" must be named <name>.<provider>.ts with provider ∈ openai | anthropic | http (C4 — see docs/10-linting.md).",
+			foreignImport: "Contract imports \"{{source}}\" — a contract imports only from the public entry (@jterrazz/test) (C4 — see docs/10-linting.md).",
+			missingDefault: "Contract file has no `export default defineContract(...)` (C4 — see docs/10-linting.md).",
+			namedExport: "Contract files have no named exports — only `export default defineContract(...)` (C4 — see docs/10-linting.md).",
+			notDefineContract: "The default export of a contract file must be `defineContract(...)` syntactically (C4 — see docs/10-linting.md).",
+			subfolder: "Contract file \"{{base}}\" is nested — contracts/ is flat, no subfolders (C4 — see docs/10-linting.md)."
 		},
 		type: "problem"
 	}
@@ -1547,7 +1565,7 @@ const c6ToMatchExtension = {
 	},
 	meta: {
 		docs: RULE_DOCS["c6-tomatch-extension"],
-		messages: { missingExtension: "toMatch(\"{{name}}\") is missing its extension — the extension is part of the fixture name (\"help.txt\", never \"help\"); only directory-tree snapshots (expected/<name>/) omit it (CONVENTIONS C6)." },
+		messages: { missingExtension: "toMatch(\"{{name}}\") is missing its extension — the extension is part of the fixture name (\"help.txt\", never \"help\"); only directory-tree snapshots (expected/<name>/) omit it (C6 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
@@ -1575,7 +1593,7 @@ const c7SeedsSqlOnly = {
 	},
 	meta: {
 		docs: RULE_DOCS["c7-seeds-sql-only"],
-		messages: { notSql: "seeds/{{entry}} is not a .sql file — seeds/ carries database state only; file state goes through .fixture() (CONVENTIONS C7)." },
+		messages: { notSql: "seeds/{{entry}} is not a .sql file — seeds/ carries database state only; file state goes through .fixture() (C7 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
@@ -1664,7 +1682,7 @@ const c8ReferencedFixtureExists = {
 	},
 	meta: {
 		docs: RULE_DOCS["c8-referenced-fixture-exists"],
-		messages: { missing: "Referenced fixture \"{{path}}\" does not exist on disk under its conventional {{root}}/ root (CONVENTIONS C8). Create it or fix the reference." },
+		messages: { missing: "Referenced fixture \"{{path}}\" does not exist on disk under its conventional {{root}}/ root (C8 — see docs/10-linting.md). Create it or fix the reference." },
 		type: "problem"
 	}
 };
@@ -1733,7 +1751,7 @@ const d12wResponseBodyProbe = {
 	meta: {
 		docs: RULE_DOCS["d12w-response-body-probe"],
 		defaultOptions: [{ threshold: DEFAULT_THRESHOLD }],
-		messages: { bodyProbeCluster: "{{count}} body probes in one test — this wants a full golden: expect(result.response).toMatch('x.http') (CONVENTIONS D12)." },
+		messages: { bodyProbeCluster: "{{count}} body probes in one test — this wants a full golden: expect(result.response).toMatch('x.http') (D12 — see docs/10-linting.md)." },
 		schema: [{
 			additionalProperties: false,
 			properties: { threshold: {
@@ -1816,7 +1834,7 @@ const d13wUnfrozenNegativeFixture = {
 	},
 	meta: {
 		docs: RULE_DOCS["d13w-unfrozen-negative-fixture"],
-		messages: { unfrozenNegativeFixture: "This toMatch asserts a mismatch (wrapped in expect(…).toThrow/.rejects) — pass { frozen: true } so TEST_UPDATE=1 never overwrites the deliberately-wrong fixture (CONVENTIONS D13)." },
+		messages: { unfrozenNegativeFixture: "This toMatch asserts a mismatch (wrapped in expect(…).toThrow/.rejects) — pass { frozen: true } so TEST_UPDATE=1 never overwrites the deliberately-wrong fixture (D13 — see docs/10-linting.md)." },
 		type: "suggestion"
 	}
 };
@@ -1892,7 +1910,7 @@ const d15wStatusOnlyProbe = {
 	},
 	meta: {
 		docs: RULE_DOCS["d15w-status-only-probe"],
-		messages: { statusOnlyProbe: "The test's only assertion(s) are status probes — pin the full response: expect(result.response).toMatch('case.http') (CONVENTIONS D11)." },
+		messages: { statusOnlyProbe: "The test's only assertion(s) are status probes — pin the full response: expect(result.response).toMatch('case.http') (D11 — see docs/10-linting.md)." },
 		type: "suggestion"
 	}
 };
@@ -1947,7 +1965,7 @@ const d2AwaitIoMatcher = {
 	},
 	meta: {
 		docs: RULE_DOCS["d2-await-io-matcher"],
-		messages: { mustAwait: "expect(…).{{matcher}}(…) is IO-backed and returns a promise — it must be awaited or returned, else the assertion never runs (CONVENTIONS D2)." },
+		messages: { mustAwait: "expect(…).{{matcher}}(…) is IO-backed and returns a promise — it must be awaited or returned, else the assertion never runs (D2 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
@@ -2001,7 +2019,7 @@ const d2wAwaitSyncMatcher = {
 	},
 	meta: {
 		docs: RULE_DOCS["d2w-await-sync-matcher"],
-		messages: { redundantAwait: "await on expect(…).{{matcher}}(…) is redundant — that matcher is synchronous; only IO-backed matchers (toMatchRows/toBeEmpty/toBeRunning) are awaited (CONVENTIONS D2)." },
+		messages: { redundantAwait: "await on expect(…).{{matcher}}(…) is redundant — that matcher is synchronous; only IO-backed matchers (toMatchRows/toBeEmpty/toBeRunning) are awaited (D2 — see docs/10-linting.md)." },
 		type: "suggestion"
 	}
 };
@@ -2078,7 +2096,7 @@ const d6wTransformTokenEquivalent = {
 	},
 	meta: {
 		docs: RULE_DOCS["d6w-transform-token-equivalent"],
-		messages: { tokenEquivalent: "This transform only rewrites output into known token literals — write the tokens in the expected/ fixture instead; transform is an escape hatch for uncovered noise (CONVENTIONS D6)." },
+		messages: { tokenEquivalent: "This transform only rewrites output into known token literals — write the tokens in the expected/ fixture instead; transform is an escape hatch for uncovered noise (D6 — see docs/10-linting.md)." },
 		type: "suggestion"
 	}
 };
@@ -2112,7 +2130,7 @@ const d8wTextBypass = {
 	},
 	meta: {
 		docs: RULE_DOCS["d8w-text-bypass"],
-		messages: { textBypass: "expect(x.text).{{matcher}}(…) asserts on the raw stream — prefer the typed accessor subject (expect(x)) so the token grammar and fixture resolution apply (CONVENTIONS D8)." },
+		messages: { textBypass: "expect(x.text).{{matcher}}(…) asserts on the raw stream — prefer the typed accessor subject (expect(x)) so the token grammar and fixture resolution apply (D8 — see docs/10-linting.md)." },
 		type: "suggestion"
 	}
 };
@@ -2195,7 +2213,7 @@ const d9wSingleUseRef = {
 	},
 	meta: {
 		docs: RULE_DOCS["d9w-single-use-ref"],
-		messages: { singleUse: "Capture ref \"{{ref}}\" is used only once in this spec — a ref earns its name by asserting equality across occurrences; use a plain matcher instead (CONVENTIONS D9)." },
+		messages: { singleUse: "Capture ref \"{{ref}}\" is used only once in this spec — a ref earns its name by asserting equality across occurrences; use a plain matcher instead (D9 — see docs/10-linting.md)." },
 		type: "suggestion"
 	}
 };
@@ -2223,7 +2241,7 @@ const f1NoSubpathImport = {
 	},
 	meta: {
 		docs: RULE_DOCS["f1-no-subpath-import"],
-		messages: { subpath: "Import from \"@jterrazz/test\", not \"{{source}}\" — subpaths do not exist (CONVENTIONS F1; only the tool-facing @jterrazz/test/oxlint is exempt)." },
+		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)." },
 		type: "problem"
 	}
 };
@@ -2271,7 +2289,7 @@ const f2NoTestImportsInProd = {
 	},
 	meta: {
 		docs: RULE_DOCS["f2-no-test-imports-in-prod"],
-		messages: { testImport: "Production code must not import the test artefact \"{{source}}\" — test imports are only legal from specs/, *.test.ts, *.fixtures.ts or *.specification.ts (CONVENTIONS F2)." },
+		messages: { testImport: "Production code must not import the test artefact \"{{source}}\" — test imports are only legal from specs/, *.test.ts, *.fixtures.ts or *.specification.ts (F2 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
@@ -2335,7 +2353,7 @@ const f3SpecsPublicEntry = {
 	},
 	meta: {
 		docs: RULE_DOCS["f3-specs-public-entry"],
-		messages: { deepImport: "specs/ must not deep-import framework internals — reach the framework via its public entry (@jterrazz/test, or src/index.js in this repo), not \"{{source}}\" (CONVENTIONS F3; only @jterrazz/test/oxlint, and src/integrations/** from specs/integrations/, are exempt)." },
+		messages: { deepImport: "specs/ must not deep-import framework internals — reach the framework via its public entry (@jterrazz/test, or src/index.js in this repo), not \"{{source}}\" (F3 — see docs/10-linting.md; only @jterrazz/test/oxlint, and src/integrations/** from specs/integrations/, are exempt)." },
 		type: "problem"
 	}
 };
@@ -2361,7 +2379,7 @@ const f4NoTestToTestImport = {
 	},
 	meta: {
 		docs: RULE_DOCS["f4-no-test-to-test-import"],
-		messages: { testToTest: "A test file must not import another test file (\"{{source}}\") — share data via a *.fixtures.ts neighbour or a *.specification.ts runner (CONVENTIONS F4)." },
+		messages: { testToTest: "A test file must not import another test file (\"{{source}}\") — share data via a *.fixtures.ts neighbour or a *.specification.ts runner (F4 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
@@ -2387,14 +2405,14 @@ const f5FixturesOnlyFromTests = {
 	},
 	meta: {
 		docs: RULE_DOCS["f5-fixtures-only-from-tests"],
-		messages: { fixturesImport: "A *.fixtures.ts module (\"{{source}}\") is only importable from *.test.ts files (CONVENTIONS F5)." },
+		messages: { fixturesImport: "A *.fixtures.ts module (\"{{source}}\") is only importable from *.test.ts files (F5 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
 //#endregion
 //#region src/lint/rules/i1-layer-boundaries.ts
 /**
-* One folder = one external dependency (CONVENTIONS I1): the packages each
+* One folder = one external dependency (I1 — see docs/10-linting.md): the packages each
 * `src/integrations/<folder>/` may import.
 */
 const INTEGRATION_DEPS = {
@@ -2404,6 +2422,7 @@ const INTEGRATION_DEPS = {
 	hono: ["hono", "@hono/node-server"],
 	msw: ["msw"],
 	openai: ["openai"],
+	playwright: ["playwright"],
 	postgres: ["pg"],
 	redis: ["redis"],
 	sqlite: ["better-sqlite3"],
@@ -2474,6 +2493,7 @@ const i1LayerBoundaries = {
 			if (layer === "core") {
 				if (target.startsWith("core/") || target.startsWith("integrations/docker/") || target.startsWith("integrations/hono/") || withoutExtension(target) === "vitest/matchers") return null;
 				if (target.startsWith("integrations/msw/") && inside === "core/specification/shared/builder.ts") return null;
+				if (target.startsWith("integrations/playwright/") && inside === "core/specification/website/start-website.ts") return null;
 				return "crossLayer";
 			}
 			if (layer === "integrations") return target.startsWith("core/") || target.startsWith(`integrations/${integrationFolder}/`) ? null : "crossLayer";
@@ -2500,10 +2520,10 @@ const i1LayerBoundaries = {
 	meta: {
 		docs: RULE_DOCS["i1-layer-boundaries"],
 		messages: {
-			coreExternal: "core/ imports nothing external — \"{{source}}\" is not allowed (CONVENTIONS I1).",
-			crossLayer: "Layer \"{{layer}}\" must not import \"{{source}}\" — outside the sanctioned layer edges (CONVENTIONS I1).",
-			foreignDependency: "\"{{source}}\" is not this folder's own dependency — one integrations folder = one external dependency (CONVENTIONS I1).",
-			lintRuntime: "The lint layer imports nothing from the framework runtime — \"{{source}}\" is outside its pure-helper whitelist (CONVENTIONS I1)."
+			coreExternal: "core/ imports nothing external — \"{{source}}\" is not allowed (I1 — see docs/10-linting.md).",
+			crossLayer: "Layer \"{{layer}}\" must not import \"{{source}}\" — outside the sanctioned layer edges (I1 — see docs/10-linting.md).",
+			foreignDependency: "\"{{source}}\" is not this folder's own dependency — one integrations folder = one external dependency (I1 — see docs/10-linting.md).",
+			lintRuntime: "The lint layer imports nothing from the framework runtime — \"{{source}}\" is outside its pure-helper whitelist (I1 — see docs/10-linting.md)."
 		},
 		type: "problem"
 	}
@@ -2556,9 +2576,9 @@ const i2SiblingTestNaming = {
 	meta: {
 		docs: RULE_DOCS["i2-sibling-test-naming"],
 		messages: {
-			orphanTest: "A src/ module test must sit NEXT to the module it tests — no neighbour \"{{expected}}\" found (CONVENTIONS I2). A test needing more than its module is a specification: move it to specs/.",
-			rootTests: "A root-level tests/ directory is banned — module tests are siblings under src/, product specifications live in specs/ (CONVENTIONS I2).",
-			testsDir: "__tests__/ directories are banned under src/ — the test of <file>.ts is its neighbour <file>.test.ts (CONVENTIONS I2)."
+			orphanTest: "A src/ module test must sit NEXT to the module it tests — no neighbour \"{{expected}}\" found (I2 — see docs/10-linting.md). A test needing more than its module is a specification: move it to specs/.",
+			rootTests: "A root-level tests/ directory is banned — module tests are siblings under src/, product specifications live in specs/ (I2 — see docs/10-linting.md).",
+			testsDir: "__tests__/ directories are banned under src/ — the test of <file>.ts is its neighbour <file>.test.ts (I2 — see docs/10-linting.md)."
 		},
 		type: "problem"
 	}
@@ -2617,9 +2637,9 @@ const i4NoViMockInSrc = {
 	meta: {
 		docs: RULE_DOCS["i4-no-vi-mock-in-src"],
 		messages: {
-			assetImport: "A src/ module test must not import the data asset \"{{source}}\" — inline it as code or move the test to specs/ (CONVENTIONS I4).",
-			bannedDir: "`{{dir}}/` directories are banned under src/ — mocks and data are code: mockOf/mockOfDate inline, payloads in a *.fixtures.ts neighbour (CONVENTIONS I4).",
-			viMock: "`vi.mock` is banned under src/ — use mockOf/mockOfDate (CONVENTIONS I4)."
+			assetImport: "A src/ module test must not import the data asset \"{{source}}\" — inline it as code or move the test to specs/ (I4 — see docs/10-linting.md).",
+			bannedDir: "`{{dir}}/` directories are banned under src/ — mocks and data are code: mockOf/mockOfDate inline, payloads in a *.fixtures.ts neighbour (I4 — see docs/10-linting.md).",
+			viMock: "`vi.mock` is banned under src/ — use mockOf/mockOfDate (I4 — see docs/10-linting.md)."
 		},
 		type: "problem"
 	}
@@ -2663,7 +2683,7 @@ const j1NoOnlySkip = {
 	},
 	meta: {
 		docs: RULE_DOCS["j1-no-only-skip"],
-		messages: { forbidden: "Committed `{{runner}}.{{modifier}}` is not allowed (CONVENTIONS J1). Remove it before committing." },
+		messages: { forbidden: "Committed `{{runner}}.{{modifier}}` is not allowed (J1 — see docs/10-linting.md). Remove it before committing." },
 		type: "problem"
 	}
 };
@@ -2706,8 +2726,8 @@ const j2NoSleepInSpecs = {
 	meta: {
 		docs: RULE_DOCS["j2-no-sleep-in-specs"],
 		messages: {
-			sleep: "No arbitrary sleeps in specs — synchronise via `waitFor` or the framework (CONVENTIONS J2).",
-			timersImport: "No timer-based sleeps in specs — synchronise via `waitFor` or the framework (CONVENTIONS J2)."
+			sleep: "No arbitrary sleeps in specs — synchronise via `waitFor` or the framework (J2 — see docs/10-linting.md).",
+			timersImport: "No timer-based sleeps in specs — synchronise via `waitFor` or the framework (J2 — see docs/10-linting.md)."
 		},
 		type: "problem"
 	}
@@ -2747,7 +2767,7 @@ const j3NoExpectlessTest = {
 	},
 	meta: {
 		docs: RULE_DOCS["j3-no-expectless-test"],
-		messages: { noExpect: "Test has no `expect(…)` — a test must assert something (CONVENTIONS J3). Use `test.todo` for a pending test." },
+		messages: { noExpect: "Test has no `expect(…)` — a test must assert something (J3 — see docs/10-linting.md). Use `test.todo` for a pending test." },
 		type: "problem"
 	}
 };
@@ -2783,7 +2803,7 @@ const j4UniqueTestNames = {
 	},
 	meta: {
 		docs: RULE_DOCS["j4-unique-test-names"],
-		messages: { duplicate: "Duplicate test name \"{{name}}\" in this file — the test name is the sole description of behaviour, so it must be unique (CONVENTIONS J4)." },
+		messages: { duplicate: "Duplicate test name \"{{name}}\" in this file — the test name is the sole description of behaviour, so it must be unique (J4 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
@@ -2879,9 +2899,55 @@ const plugin = {
 			},
 			meta: {
 				docs: RULE_DOCS["j5-lowercase-title"],
-				messages: { uppercase: "A {{runner}}() title must start lowercase — the test name is a prose fragment, not a sentence (CONVENTIONS J5)." },
+				messages: { uppercase: "A {{runner}}() title must start lowercase — the test name is a prose fragment, not a sentence (J5 — see docs/10-linting.md)." },
 				type: "problem"
 			}
+		},
+		"w1-scenario-pure": {
+			create(context) {
+				return { CallExpression(node) {
+					const callee = node.callee;
+					if (!callee || memberPropertyName(callee) !== "visit") return;
+					const scenario = node.arguments?.[1];
+					if (scenario?.type !== "ArrowFunctionExpression" && scenario?.type !== "FunctionExpression") return;
+					walk(scenario, (inner) => {
+						if (inner.type !== "CallExpression") return;
+						const innerCallee = inner.callee;
+						if (innerCallee?.type === "Identifier" && innerCallee.name === "expect") context.report({
+							messageId: "expectInScenario",
+							node: inner
+						});
+					});
+				} };
+			},
+			meta: {
+				docs: RULE_DOCS["w1-scenario-pure"],
+				messages: { expectInScenario: "No expect() inside a visit scenario — the scenario is the When; assert the final state on the returned result in the Then (W1 — see docs/10-linting.md)." },
+				type: "problem"
+			}
+		},
+		"w2w-user-facing-elements": {
+			create(context) {
+				return { CallExpression(node) {
+					const callee = node.callee;
+					if (!callee || memberPropertyName(callee) !== "visit") return;
+					const scenario = node.arguments?.[1];
+					if (scenario?.type !== "ArrowFunctionExpression" && scenario?.type !== "FunctionExpression") return;
+					walk(scenario, (inner) => {
+						if (inner.type !== "CallExpression") return;
+						const innerCallee = inner.callee;
+						if (innerCallee?.type === "Identifier" && innerCallee.name === "testId") context.report({
+							messageId: "testIdElement",
+							node: inner
+						});
+					});
+				} };
+			},
+			meta: {
+				docs: RULE_DOCS["w2w-user-facing-elements"],
+				messages: { testIdElement: "Prefer a user-facing element (button, link, field, heading, content) over testId() — the escape hatch hides what the user actually sees (W2 — see docs/10-linting.md)." },
+				type: "suggestion"
+			}
 		}
 	}
 };