paperlint 4.0.0 → 4.1.0

package/dist/tex-venue-rules.js

@@ -0,0 +1,254 @@
+/**
+ * THE VENUE-CONFORMANCE RULES OVER THE SOURCE — `paper.tex` judged against what its venue preset
+ * requires of the LaTeX itself, before any build:
+ *
+ *   tex/template          error  the `\documentclass` is the preset's class, with every option it names
+ *   tex/required-section  error  each section the preset requires is there, titled exactly, and
+ *                                where the preset says (`last`: after every section of the body)
+ *   tex/venue-leftover    warn   the text a reader sees names ANOTHER shipped venue — its `name`
+ *                                or one of its `aliases` — than the one the paper extends
+ *
+ * ── WHY THEY LIVE HERE AND NOT IN `eslint-rules/` ────────────────────────────────
+ * Like the `pdf/*` venue rules (`venue-rules.ts`), they need the paper's resolved preset —
+ * `paperPreset`, the one answer to "which venue is this paper judged against" — and read it through
+ * the `Files` port. What they read of the source comes through the `LatexReader` port
+ * (`src/ports/latex.ts`, implemented over unified-latex in `src/adapters/latex/`): the parse tree of
+ * `sourceCode.raw`, never a search of the text.
+ *
+ * ── WHO SPEAKS WHEN THERE IS NOTHING TO JUDGE ───────────────────────────────────
+ * No `paperlint.json`, no `extends`, or a preset that does not resolve: silent. `pdf/measured` and
+ * `pdf/profile` already say so, once. A preset that names no template: silent — there is nothing to
+ * compare, and a template-family preset is where it is named.
+ */
+import { basename, dirname, join } from "node:path";
+import { CONFIG_FILE } from "#lib/paper-config";
+import { collapse, documentClassLine, missingOptions, runText, spanIn, } from "./domain/tex-document.js";
+import { paperPreset, resolvePreset, SHIPPED_PREFIX, shippedPresets, } from "./presets.js";
+// ── the judges: what the source says + a resolved preset → findings. Pure. ─────────
+/** A place as a finding points at it: its span, or null — the top of the file — when unplaced. */
+const spanOf = (p) => (p.kind === "at" ? p.span : null);
+/** A class line that names a class, against the template's: the same class, with every option. */
+function judgeClass(line, want, data) {
+    const at = spanOf(line.place);
+    if (line.cls !== want.cls)
+        return [{ messageId: "wrongClass", data: { ...data, got: line.cls }, at }];
+    return missingOptions(line, want).map((option) => ({
+        messageId: "missingOption",
+        data: { ...data, option },
+        at,
+    }));
+}
+/** The paper's class line against a template that was read: present, naming a class, that class. */
+function judgeClassLine(line, want, data) {
+    switch (line.kind) {
+        case "missing":
+            return [{ messageId: "noClass", data, at: null }];
+        case "empty":
+            return [{ messageId: "emptyClass", data, at: spanOf(line.place) }];
+        case "class":
+            return judgeClass(line, want, data);
+    }
+}
+/**
+ * The paper's class line against the preset's template: a template the reader cannot read is said
+ * once; then the class must be there, name a class, be the template's class, and carry every
+ * option the template names.
+ */
+export function judgeTemplate(line, preset, latex) {
+    const t = preset.template;
+    if (t === null)
+        return [];
+    const want = latex.template(t.text);
+    if (want === null) {
+        const data = { file: t.file, text: JSON.stringify(t.text) };
+        return [{ messageId: "badTemplate", data, at: null }];
+    }
+    const data = { venue: preset.label, template: documentClassLine(want) };
+    return judgeClassLine(line, want, data);
+}
+/** Where a heading starts, or null when the parser gave it no place. */
+const startOf = (p) => p.kind === "at" ? p.span.start : null;
+/** A required section that is absent, reported where the document ends — where it would go. */
+const missingSection = (outline, data) => ({
+    messageId: "missing",
+    data,
+    at: outline.end === null ? null : { start: outline.end, end: outline.end },
+});
+/** The first section of the body that starts after `start` and is not titled `title`. */
+function bodySectionAfter(outline, start, title) {
+    const backMatter = outline.backMatter ?? Number.POSITIVE_INFINITY;
+    return outline.sections.find((h) => {
+        const s = startOf(h.place);
+        return s !== null && s > start && s < backMatter && h.title !== title;
+    });
+}
+/**
+ * One required section against the outline: missing (reported where the document ends, where it
+ * would go), or — for `last` — standing before a section of the body. The body is every section
+ * before the appendix and the bibliography, so the required one may follow the bibliography. A
+ * heading without a place cannot be ordered, so it is never reported as out of order.
+ */
+function judgeSection(outline, want, venue) {
+    const title = collapse(want.title);
+    const last = outline.sections.filter((h) => h.title === title).at(-1);
+    const data = { venue, title };
+    if (last === undefined)
+        return [missingSection(outline, data)];
+    const lastStart = startOf(last.place);
+    if (want.position !== "last" || lastStart === null)
+        return [];
+    const after = bodySectionAfter(outline, lastStart, title);
+    if (after === undefined)
+        return [];
+    const notLast = { ...data, after: after.title };
+    return [{ messageId: "notLast", data: notLast, at: spanOf(last.place) }];
+}
+/** Every section the preset requires, against the paper's outline. */
+export function judgeRequiredSections(outline, preset) {
+    if (preset.requiredSections.length === 0)
+        return [];
+    const o = outline();
+    return preset.requiredSections.flatMap((r) => judgeSection(o, r, preset.label));
+}
+/** `s` as a pattern that matches it literally. */
+const literal = (s) => s.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+/**
+ * Each place the rendered text names another venue — one of its aliases as a whole word, case
+ * and all — unless that alias is also this paper's venue's own (a shared parent conference).
+ */
+export function judgeLeftover(runs, preset, others) {
+    const own = new Set(preset.aliases);
+    const names = others.flatMap((o) => o.aliases
+        .filter((a) => !own.has(a))
+        .map((alias) => ({
+        other: o.label,
+        re: new RegExp(`(?<![\\p{L}\\p{N}])${literal(alias)}(?![\\p{L}\\p{N}])`, "gu"),
+    })));
+    return runs.flatMap((run) => names.flatMap(({ other, re }) => [...runText(run).matchAll(re)].map((m) => ({
+        messageId: "leftover",
+        data: { name: m[0], other, venue: preset.label },
+        at: spanIn(run, m.index, m.index + m[0].length),
+    }))));
+}
+/** Where a rule's page lives: `docs/rules/tex/<name>.md` on the default branch. */
+export const ruleDocsUrl = (name) => `https://github.com/zernie/paperlint/blob/main/docs/rules/tex/${name}.md`;
+const RULES = {
+    template: {
+        judge: (r) => judgeTemplate(r.latex.documentClass(r.src), r.preset, r.latex),
+        meta: {
+            type: "problem",
+            docs: {
+                description: "the \\documentclass is the venue preset's class, with every option the preset names",
+                url: ruleDocsUrl("template"),
+            },
+            schema: [],
+            messages: {
+                noClass: "paper.tex has no \\documentclass; {{venue}} requires `{{template}}`",
+                emptyClass: "the \\documentclass names no class; {{venue}} requires `{{template}}`",
+                badTemplate: '{{file}}: the preset\'s "template" {{text}} is neither a \\documentclass line nor a class name, so the class cannot be checked',
+                wrongClass: "the class is `{{got}}`, and {{venue}} requires `{{template}}` — the page size, fonts and layout the venue checks come from the class",
+                missingOption: "the class option `{{option}}` is missing: {{venue}} requires `{{template}}`",
+            },
+        },
+    },
+    "required-section": {
+        judge: (r) => judgeRequiredSections(() => r.latex.outline(r.src), r.preset),
+        meta: {
+            type: "problem",
+            docs: {
+                description: "every section the venue preset requires is there, titled exactly, and where the preset says",
+                url: ruleDocsUrl("required-section"),
+            },
+            schema: [],
+            messages: {
+                missing: "{{venue}} requires a section titled «{{title}}» and there is none — add `\\section*{{{title}}}` (the title exactly; a bold paragraph does not count)",
+                notLast: "«{{title}}» must close the paper at {{venue}}, and the section «{{after}}» comes after it — move it after the last section of the body (after the bibliography is fine)",
+            },
+        },
+    },
+    "venue-leftover": {
+        judge: (r) => judgeLeftover(r.latex.renderedRuns(r.src), r.preset, r.others()),
+        meta: {
+            type: "suggestion",
+            docs: {
+                description: "the text names another shipped venue than the one the paper extends — a leftover from an earlier submission",
+                url: ruleDocsUrl("venue-leftover"),
+            },
+            schema: [],
+            messages: {
+                leftover: "«{{name}}» names {{other}}, and this paper extends {{venue}} — a leftover from an earlier submission? A reviewer reads it before the abstract. Comments and citation keys are not reported; a sentence that names the other venue on purpose can keep it with a disable directive",
+            },
+        },
+    },
+};
+/** The level each rule is on at in paperlint's own config, for every `paper.tex`. */
+export const TEX_VENUE_RULE_LEVELS = {
+    "tex/template": "error",
+    "tex/required-section": "error",
+    "tex/venue-leftover": "warn",
+};
+/**
+ * Every shipped venue but the ones on this paper's own chain, each resolved the way a paper
+ * extending it would be. A preset that does not resolve is skipped: `pdf/profile` owns that.
+ */
+export function otherVenues(preset, fromFile, deps) {
+    return shippedPresets(deps.venuesDir).flatMap((name) => {
+        const r = resolvePreset(`${SHIPPED_PREFIX}${name}`, fromFile, deps);
+        // A preset all of whose files are on this paper's chain is this venue or one it extends.
+        return r.ok && !r.value.chain.every((f) => preset.chain.includes(f))
+            ? [{ label: r.value.label, aliases: r.value.aliases }]
+            : [];
+    });
+}
+/**
+ * What a judge reads for the paper whose `paper.tex` is `filename`, or null when the paper has no
+ * resolved preset (`pdf/measured` and `pdf/profile` already say so).
+ */
+function readingOf(filename, src, deps) {
+    const dir = dirname(filename);
+    const p = paperPreset(dir, deps);
+    if (p.kind !== "resolved")
+        return null;
+    const preset = p.preset;
+    const others = () => otherVenues(preset, join(dir, CONFIG_FILE), deps);
+    return { src, latex: deps.latex, preset, others };
+}
+/** Each finding reported at its span, or at the top of the file when it has none. */
+function reportAll(context, findings) {
+    const at = (i) => context.sourceCode.getLocFromIndex(i);
+    findings.forEach((f) => {
+        context.report({
+            loc: { start: at(f.at?.start ?? 0), end: at(f.at?.end ?? 0) },
+            messageId: f.messageId,
+            data: f.data,
+        });
+    });
+}
+function rule(name, deps) {
+    const { judge, meta } = RULES[name];
+    return {
+        meta,
+        create(context) {
+            // Judged once per paper, on its paper.tex: the paper directory is the file's directory.
+            if (basename(context.filename) !== "paper.tex")
+                return {};
+            return {
+                root() {
+                    const sc = context.sourceCode;
+                    const reading = readingOf(context.filename, sc.raw ?? sc.text, deps);
+                    if (reading !== null)
+                        reportAll(context, judge(reading));
+                },
+            };
+        },
+    };
+}
+/** The venue-conformance rules, as rules of the `tex` plugin (beside `tex/future-promise`). */
+export function texVenueRules(deps) {
+    return {
+        template: rule("template", deps),
+        "required-section": rule("required-section", deps),
+        "venue-leftover": rule("venue-leftover", deps),
+    };
+}
+//# sourceMappingURL=tex-venue-rules.js.map

package/dist/tex-venue-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tex-venue-rules.js","sourceRoot":"","sources":["../src/tex-venue-rules.ts"],"names":[],"mappings":"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"}

package/dist/venue-rules.d.ts

@@ -42,7 +42,7 @@ export type Assessment = {
 };
 export interface VenueRuleDeps {
     readonly files: Files;
-    /** The package's venues directory (`packageVenuesDir()`): the shipped presets and their schema. */
+    /** The package's presets directory (`presetsDir()`): the shipped presets and their schema. */
     readonly venuesDir: string;
 }
 /** One paper, assessed. Reads through `deps.files` only; never throws on a paper's files. */

package/dist/venue-rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"venue-rules.d.ts","sourceRoot":"","sources":["../src/venue-rules.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"venue-rules.d.ts","sourceRoot":"","sources":["../src/venue-rules.ts"],"names":[],"mappings":"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"}

package/docs/configuration.md

@@ -15,7 +15,8 @@ venues/usenix-sec.jsonc      (optional, your own) a VENUE PRESET: format, page l
 ```
 
 The shipped presets (`paperlint:<name>`) live in the package, under
-`skills/submit-paper/references/venues/`: `acm-sigconf`, `agenticdev`, `aisec`, `realm`.
+`presets/`: `acm-sigconf`, `agenticdev`, `aidc`, `aisec`,
+`ieee-conference`, `realm`.
 
 ## The root `paperlint.json`
 
@@ -229,7 +230,7 @@ write. It prints its plan first, one line per step, then runs it:
 
 ```
 papers/my-paper
-  inputs: TEXINPUTS += <paperlint>/skills/submit-paper/references/venues
+  inputs: TEXINPUTS += <paperlint>/presets/tex
   compile: paper.tex (\documentclass[sigconf,screen]{acmart}, venue agenticdev)
   measure: pdf.js → _build/paper.facts.json (facts for the lint rules; nothing is judged here)
   ✓ paper.pdf — 4 pdflatex passes, 1 bibtex run; facts: _build/paper.facts.json, last page 621.5 / 264.8 pt

package/docs/e2e.md

@@ -1,37 +1,50 @@
 # End-to-end tests
 
-They are `test/e2e/install.ts` and `test/e2e/build.ts`. Both are
-part of `npm run check`, so nobody has to remember to call them. `npm run test:e2e` runs just
-these, install first; if the install e2e fails or is skipped, the build e2e does not run.
+They are vitest tests named `*.e2e.ts` under `test/e2e/`, one vitest project per environment they
+need, found by the project's glob — no list of files exists in `package.json`, `scripts/check.ts`
+or CI:
+
+| script                     | project       | what it needs                                | files                       |
+| -------------------------- | ------------- | -------------------------------------------- | --------------------------- |
+| `npm run test:e2e:install` | `e2e-install` | npm and pnpm, and the network for `npm pack` | `test/e2e/install/*.e2e.ts` |
+| `npm run test:e2e:tex`     | `e2e-tex`     | TeX Live from `paperlint toolchain`, banal   | `test/e2e/tex/*.e2e.ts`     |
+| `npm run test:e2e`         | both          |                                              |                             |
+
+Both areas are part of `npm run check`, so nobody has to remember to call them. CI runs each in the
+job that has its environment: `test:e2e:install` in `gates`, `test:e2e:tex` in `build-e2e`.
 
 This page says what they prove, what they deliberately do not, and when a change owes a new one.
 
-## The line between a harness and an end-to-end run
+## The line between the other tests and an end-to-end run
 
-Most of this package is tested by harnesses, described in [`CONTRIBUTING.md`](../CONTRIBUTING.md):
-a rule is handed a file with a defect and must find it, then a clean file and must stay silent.
-That is the right shape for a rule, and it cannot answer a different kind of question.
+The rest of the package is tested by unit and integration tests and, for what an agent sees, by
+harnesses — [`testing.md`](testing.md) says which is which. A rule is tested twice before any e2e:
+unit tests beside it hand its logic a defect and a clean input, and `src/rule-cases.test.ts` runs
+every registered rule through real ESLint on a small paper tree, the way `paperlint lint` does.
+That is still an integration test: no TeX, no install, the working tree as it is.
 
-A harness runs **in this repository's process, against this repository's working tree**. It
-imports the module directly. Every path resolves, every dependency is already installed, and the
-file it reads is the file in `git`. An end-to-end run exists because all three of those are
+Those tests run **in this repository's process, against this repository's working tree**. They
+import the modules directly. Every path resolves, every dependency is already installed, and the
+file they read is the file in `git`. An end-to-end run exists because all three of those are
 assumptions that stop holding the moment somebody else installs the package.
 
-| question                                                                             | answered by                                               |
-| ------------------------------------------------------------------------------------ | --------------------------------------------------------- |
-| does this rule find this defect, and stay quiet otherwise                            | harness                                                   |
-| does the CLI pick the right script, with the right interpreter                       | harness (`src/build.harness.mjs` substitutes `spawnSync`) |
-| does the tarball, installed into a tree that is not this one, contain what it claims | **e2e**                                                   |
-| do the paths written inside a skill resolve where the package actually lands         | **e2e**                                                   |
-| did a PDF come out, and is it typeset in the fonts the venue requires                | **e2e**                                                   |
+| question                                                                             | answered by                                                   |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------- |
+| does this rule find this defect, and stay quiet otherwise                            | unit, beside the rule                                         |
+| does the rule run through ESLint, wired, on the file it is for                       | integration (`src/rule-cases.test.ts`)                        |
+| does the CLI pick the right script, with the right interpreter                       | integration (`src/build.harness.mjs` substitutes `spawnSync`) |
+| does the tarball, installed into a tree that is not this one, contain what it claims | **e2e**                                                       |
+| do the paths written inside a skill resolve where the package actually lands         | **e2e**                                                       |
+| did a PDF come out, and is it typeset in the fonts the venue requires                | **e2e**                                                       |
 
-The third and fourth rows are the ones a harness cannot reach even in principle: the defect only
-exists once the code is somewhere else.
+The last three rows are the ones no other test can reach even in principle: the defect only exists
+once the code is somewhere else, or once a real TeX has typeset it.
 
-## `test/e2e/install.ts` — the package, installed
+## `test/e2e/install/install.e2e.ts` — the package, installed
 
-`test/e2e/install.ts`. It runs `npm pack`, then installs the resulting tarball into a fresh
-temporary tree, **under npm and under pnpm separately**, and drives the installed binary:
+It runs `npm pack`, then installs the resulting tarball into a fresh temporary tree, **under npm
+and under pnpm separately** — one test per manager, each the whole scenario, because its steps
+depend on each other — and drives the installed binary:
 
 - the install itself finishes
 - `paperlint --help` answers with zero
@@ -55,13 +68,21 @@ that works under npm can be dead under pnpm with no error anywhere. The same run
 binary **directly** rather than through `node <path>`: under npm `.bin` holds a symlink, under
 pnpm a shell wrapper, and calling `node bin` measures the caller's habit instead of the package.
 
-## `test/e2e/build.ts` — a real `pdflatex`
+## `test/e2e/tex/build.e2e.ts` — a real `pdflatex`
 
-`test/e2e/build.ts`. It copies `fixtures/build-e2e/` — eight papers, none with a build script paperlint
-would run — into a temporary tree, points a config at it, and runs `paperlint build --all`. paperlint compiles
-each paper itself with the real `pdflatex` and `bibtex`; the artifacts are then measured with
+It copies `fixtures/build-e2e/` — nine papers, none with a build script paperlint would run — into
+a temporary tree, points a config at it, and runs `paperlint build --all`. paperlint compiles each
+paper itself with the real `pdflatex` and `bibtex`; the artifacts are then measured with
 paperlint's own pdf.js reader from `dist/`, and the fonts are cross-checked against the list of
-programs pdfTeX writes into `paper.log`:
+programs pdfTeX writes into `paper.log`.
+
+**Each fixture declares what it must produce** in `fixtures/build-e2e/<name>/expect.json`, parsed
+with the schema in `test/e2e/tex/build-expect.ts`: whether it builds (`build.outcome`), what its
+lines of the build output say, its fonts, its last page's text, files in its directory, the facts
+the build measured, and — for `paperlint lint` after the build — the exit code and **exactly** the
+findings for each rule it names (`[]` is "none"). One `describe` per fixture directory turns each
+declared field into a test. A folder without `expect.json`, or with one the schema rejects, fails.
+A new venue fixture is a new folder: its paper, its `paperlint.json`, its `expect.json`.
 
 | fixture      | what it is there to prove                                                                                                                                                                                                                                                                        |
 | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
@@ -72,6 +93,8 @@ programs pdfTeX writes into `paper.log`:
 | `unbalanced` | a two-column acmart paper whose last page comes out 621.5 / 264.8 pt builds **green** — the build does not judge the layout and rewrites nothing — while `_build/paper.facts.json` records both heights, and `paperlint lint` with `pdf/last-page-balance` turned on in `rules` reports the page |
 | `broken`     | a failing build names pdflatex and its exit code, quotes the error line and its `l.NNN` context, and deletes the stale `paper.pdf` planted before the run                                                                                                                                        |
 | `no-source`  | a paper with no `paper.tex` is named separately, and the run as a whole is a failure                                                                                                                                                                                                             |
+| `empty`      | a document with no pages: pdflatex exits 0 and writes no PDF, and that is a failure, not a green `paper.pdf`                                                                                                                                                                                     |
+| `aidc`       | a real `[conference,compsoc]{IEEEtran}` paper builds on paperlint's TeX Live in NimbusRomNo9L, `tex/template`, `tex/required-section` and the `pdf/*` rules find nothing, and `tex/venue-leftover` warns once, on its planted line                                                               |
 
 The `fallback` row is the point of the whole file. `acmart.cls` checks for `libertine.sty`,
 `zi4.sty` and `newtxmath.sty`, and failing to find any of them sets `\@ACM@newfontsfalse` and
@@ -79,28 +102,30 @@ typesets the paper in Computer Modern. The build is green, the PDF looks fine, t
 and therefore so does the pagination. A submitted paper went out that way. **An exit code cannot
 see it, so the content of the artifact is what gets measured.**
 
-Before the fixtures, the run proves the refusal with no TeX at all: PATH holds `node` alone, the
+Beside the fixtures, one test proves the refusal with no TeX at all: PATH holds `node` alone, the
 cache directory is empty and `CI` is set, and `paperlint build` must exit 1 with one line naming
-`npx paperlint toolchain` and the venue's packages, print no plan and create no PDF and no cache. It then
-asks `paperlint build --dry-run` which TeX Live the real run will use; under `--strict` (CI) that must be
-paperlint's own cache, because the runner has no other.
+`npx paperlint toolchain` and the venue's packages, print no plan and create no PDF and no cache.
+The rest asks `paperlint build --dry-run` which TeX Live the real run will use; under CI that must
+be paperlint's own cache, because the runner has no other.
 
-## `test/e2e/toolchain.ts` — real TeX Live, and only it
+## `test/e2e/tex/toolchain.e2e.ts` — real TeX Live, and only it
 
 `paperlint toolchain` into `$PAPERLINT_TEXLIVE_DIR` against real CTAN; a second run must say "nothing to do"
 within seconds; `--check` must exit 0; then the `acmart` fixture is built with PATH holding `node`
 only, so no other TeX Live and no PDF tool can stand in, and the PDF must carry Libertine and Biolinum
-and no Computer Modern face. Without `PAPERLINT_TEXLIVE_DIR` it is a declared skip: installing ~270 MB
+and no Computer Modern face. Without `PAPERLINT_TEXLIVE_DIR` its tests are skipped: installing ~270 MB
 into a home directory as a side effect of `npm run check` is the unasked install rule 11 forbids.
 `src/toolchain.harness.mjs` covers the installer's logic (mirror fallback, archive check, time
 limit, verification, idempotence) against a fake mirror on disk, without the network.
 
-## Skips are declared, never silent
+## Skips are reported, never passed
 
 A clone without TeX Live genuinely cannot run the build e2e; a machine without pnpm cannot run
-half of the install e2e. Each says so and exits **77** — the skip code vigiles' own runner uses —
-not zero, and `npm run check` reports it as `SKIPPED — not run, not passed`. In CI the same absence
-means a broken environment, so `--strict` turns the skip into a failure.
+half of the install e2e. Their tests are then `skipIf`'d, and vitest reports them as skipped.
+`npm run check` reads that count from vitest's JSON report and prints the gate as
+`SKIPPED — not run, not passed`. In CI the same absence means a broken environment: with `CI` set
+(or `PAPERLINT_E2E_STRICT=1`) each such file registers one more test that fails and names what is
+missing (`test/e2e/need.ts`).
 
 A skipped step and a passed one look identical in a CI interface. That is the class this whole
 package is written against, so it is not allowed to happen inside it either.
@@ -115,9 +140,13 @@ Not every change does. The trigger is countable — ask whether the change touch
 - anything read through `package.json` fields — `bin`, `files`, `exports`
 - a new external program the pipeline shells out to
 - a new artifact the pipeline produces whose **content** can be wrong while the exit code is zero
+- a new template-family preset: the TeX packages it declares, and the page size and fonts measured
+  from a real build of its class → one fixture folder in `fixtures/build-e2e/`, with its
+  `expect.json`
 
-If none of those apply, a harness beside the changed module is the right test, and an e2e run
-would only make the suite slower without making it stricter.
+If none of those apply, a unit or integration test beside the changed module is the right test,
+and an e2e run would only make the suite slower without making it stricter. A new rule is not a
+trigger by itself: its cases in `src/rule-cases.test.ts` already run it through real ESLint.
 
 ## What these two do NOT cover
 
@@ -142,7 +171,7 @@ everything.
 
 ## The corpus
 
-`stageCorpus()` in `test/e2e/install.ts` writes a small paper by hand — a declared stage, its
+`stageCorpus()` in `test/e2e/install/install.e2e.ts` writes a small paper by hand — a declared stage, its
 PDF, its byte counts, the cross-check between them — and copies `fixtures/build-e2e/acmart` beside
 it so the LaTeX rules see LaTeX rather than a placeholder.
 

package/docs/install.md

@@ -121,7 +121,7 @@ a CI workflow and a heavy toolchain), asks two questions and guesses the rest.
 
 **npm and pnpm are covered; Yarn Plug'n'Play is not supported.**
 
-`test/e2e/install.ts` packs the tarball, installs it into a clean project with each manager that
+`test/e2e/install/install.e2e.ts` packs the tarball, installs it into a clean project with each manager that
 launches on the machine, and runs the hook command to see whether it resolves. A grep over
 `hooks.json` would not do: the string is right under any manager, and whether it resolves depends
 on the tree the manager laid out. It also checks that every shipped skill is reachable as

package/docs/prior-art/README.md

@@ -1,7 +1,7 @@
 # Prior art — how comparable tools are shaped
 
 **Why this folder lives in the repository.** These are technical records that code and other docs
-cite by path: `test/e2e/install.ts` cites `package-location.md`, `scripts/marketplace-shape.mjs`
+cite by path: `test/e2e/install/install.e2e.ts` cites `package-location.md`, `scripts/marketplace-shape.mjs`
 and `docs/install.md` point at the probes in `repro/`, and `eslint.config.mjs` excludes `repro/`
 by name. Moving the folder out would leave those references pointing nowhere. The notes are for
 contributors and maintainers, not for someone checking a paper, which is why the README does not

package/docs/prior-art/package-location.md

@@ -1,6 +1,6 @@
 # How a package finds its own installed files, and its own bin
 
-**Question this file answers:** `test/e2e/install.ts` inspects the tree it just installed by
+**Question this file answers:** `test/e2e/install/install.e2e.ts` inspects the tree it just installed by
 spelling the layout out — `node_modules/research-paper-pipeline` (line 172),
 `node_modules/.bin/rpp` (line 276), and `node_modules/.../plugin/hooks/hooks.json` (line 135).
 `contentDelivery()` separately tries THREE candidate base directories for a path written as prose
@@ -54,7 +54,7 @@ argument of `import.meta.resolve` is the non-standard part:
 
 ### 🔴 `import.meta.resolve` is the wrong tool here, and it fails SILENTLY
 
-`test/e2e/install.ts` runs from the repository and inspects a consumer somewhere in `os.tmpdir()`.
+`test/e2e/install/install.e2e.ts` runs from the repository and inspects a consumer somewhere in `os.tmpdir()`.
 `import.meta.resolve` always resolves from **the file that calls it** — `cwd` is irrelevant and
 the `parent` argument is ignored without the flag rather than rejected:
 
@@ -165,7 +165,7 @@ literal node_modules/ : <WORK>/consumer-pnpm/node_modules/research-paper-pipelin
 Under pnpm the hardcode addresses the **symlink** and resolution addresses the **store realpath**
 (Node realpaths by default; `--preserve-symlinks` flips it, and `resolve-package-path` carries
 `lib/should-preserve-symlinks.js` for exactly that). `realpathSync` of one equals the other, so
-every `existsSync` / `readdirSync` / `readFileSync` in `test/e2e/install.ts` gives the same answer
+every `existsSync` / `readdirSync` / `readFileSync` in `test/e2e/install/install.e2e.ts` gives the same answer
 either way. Two interesting asymmetries, both measured:
 
 - `module.findPackageJSON` returns the **symlink** path under pnpm, not the store path — the
@@ -348,7 +348,7 @@ node_modules present? NO
    today the npm channel is the one that delivers the runnable code — but it is not impossible.
 3. 🔴 **The blocker the note does NOT name is the immovable one, and no resolution API fixes it.**
    PnP resolves to a path **inside a zip**. Line 3: the outside process gets `existsSync: false`
-   for the very path PnP just handed it; only PnP's patched `fs` can open it. `test/e2e/install.ts`
+   for the very path PnP just handed it; only PnP's patched `fs` can open it. `test/e2e/install/install.e2e.ts`
    inspects the installed tree with `existsSync`, `readdirSync` and `readFileSync` **from its own
    process**. Under PnP those read nothing, whatever API produced the path — and `yarn bin rpp`
    (line 4) hands back the same unreadable path, so the supported bin lookup does not help either.
@@ -359,7 +359,7 @@ and it should be recorded as such rather than as "PnP has no node_modules".
 
 ## 9. The second guess: the base directory for a path written in prose
 
-`contentDelivery()` (in `test/e2e/install.ts`) tries three bases per reference.
+`contentDelivery()` (in `test/e2e/install/install.e2e.ts`) tries three bases per reference.
 Measured over the real corpus with `claim6-doc-path-candidates.mjs`:
 
 ```console

package/docs/prior-art/repro/README.md

@@ -56,7 +56,7 @@ $ claude plugin validate /tmp/m --strict; echo "RC=$?"
 ## The CLAIM 4–6 probes — where an installed package is, and how to find it
 
 These back [`../package-location.md`](../package-location.md). They measure the two hardcodes in
-`test/e2e/install.ts` (`node_modules/<name>` and `node_modules/.bin/rpp`) against the
+`test/e2e/install/install.e2e.ts` (`node_modules/<name>` and `node_modules/.bin/rpp`) against the
 resolution APIs Node actually offers, under npm, pnpm and Yarn Berry (PnP).
 
 Build the consumer trees once — it packs this repository and installs the SAME tarball twice:

package/docs/prior-art/test-tooling.md

@@ -27,16 +27,27 @@ So the genuinely agent-facing harnesses are three: `hooks/hooks.harness.ts` (`ru
 (`runHarnessTest`, which spawns the real `claude` binary against a scripted model), and the skill
 contract checks. Everything else is ordinary Node testing that happens to carry the suffix.
 
-## Why the install e2e stays a script
-
-`test/e2e/install.ts` is one linear scenario per package manager with strictly dependent steps
-— install, bin, `init`, `lint`, hook commands, content delivery — and a summary. A runner adds
-named subtests and a reporter; the script already prints per-check `✓`/`✗` and a per-manager
-verdict. The pack-and-install work stays in our code under any host, so the host buys only the
-reporter, at the cost of a second exit-code path.
-
-It also stays OUT of `npm test`: it needs the network for the consumer's transitive dependencies
-and takes minutes. It is its own CI step with its own timeout.
+## The e2e runs are vitest projects
+
+The end-to-end runs are vitest tests (`test/e2e/<area>/*.e2e.ts`), one project per environment
+they need — `e2e-install` (npm and pnpm) and `e2e-tex` (TeX Live) — found by the project's glob, so
+no list of files exists in `package.json`, `scripts/check.ts` or CI (#132). What the runner buys is
+not the reporter alone:
+
+- **the fixture table.** `fixtures/build-e2e/` is a table of independent cases, and each fixture's
+  `expect.json` becomes its own tests through one `describe.each` over the directory. A new venue
+  fixture is a folder, not a block of test code.
+- **a skip the aggregate can read.** A missing tool is `skipIf`, and vitest's JSON report counts it,
+  which is what `npm run check` reads to print a gate as skipped rather than passed. Under CI the
+  same absence fails (`test/e2e/need.ts`).
+
+`install.e2e.ts` stays ONE test per package manager, each the whole scenario — install, bin,
+`init`, `lint`, hook commands, content delivery — because its steps depend on each other: a
+failure in the install makes every later step meaningless. Inside it, each check is a soft
+expectation, so a run reports every mismatch, not the first.
+
+The e2e projects stay OUT of `npm test` (project `unit`): they need the network, TeX Live or
+several minutes. Each runs in its own CI job, with its own timeout.
 
 ## Tarball-by-path versus a local registry