pasika 0.5.17 → 0.6.0

package/README.md

@@ -88,8 +88,8 @@ The script refuses a hash no requirement has, a `ref` naming a rule that does no
 
 ```bash
 npm run build
-npm run dogfood -- ../some/repo                 # nextjsApp preset (default)
-npm run dogfood -- ../some/repo --preset=typescriptApp
+npm run dogfood -- ../some/repo                 # pasikaNextjsApp preset (default)
+npm run dogfood -- ../some/repo --preset=pasikaApp
 npm run dogfood -- ../some/repo --pasika-only   # tally only pasika/* rules
 npm run dogfood -- ../some/repo --rule=css-entry-point --findings
 npm run dogfood -- ../some/repo --json          # machine-readable report
@@ -115,18 +115,18 @@ const { eslintConfig } = styleguide({
 export default eslintConfig;
 ```
 
-For a plain TypeScript repository, enable `pasikaTypescriptApp` instead of `pasikaNextjsApp`; that preset covers the manifest, the zirka contract, and the docs only — the `src/**` source rules belong to the Next.js app preset. `zirka` composes the pasika ruleset over four file scopes: TS/TSX under `src/**`, `globals.css` and other stylesheets, `package.json`, and markdown — each with its own ESLint language.
+For a plain TypeScript repository, enable `pasikaApp` instead of `pasikaNextjsApp`; that preset covers the manifest, the zirka contract, and the docs only — the `src/**` source rules belong to the Next.js app preset. `zirka` composes the pasika ruleset over four file scopes: TS/TSX under `src/**`, `globals.css` and other stylesheets, `package.json`, and markdown — each with its own ESLint language.
 
 ### Without Zirka
 
 ```ts
 // eslint.config.ts — plain TypeScript repository
-import { typescriptApp } from "pasika/eslint";
+import { pasikaApp } from "pasika/eslint";
 
-export default typescriptApp;
+export default pasikaApp;
 ```
 
-`typescriptApp` is the plain-TypeScript-repository preset — the package.json manifest, the zirka configuration contract, and the docs. It carries no `src/**` source block: source linting is the Next.js app's job. `nextjsApp` is the full framework preset: everything in `typescriptApp` plus the Next.js-stack manifest requirement, the `src/**` app source rules, and the Tailwind stylesheet blocks. The granular rule objects (`tailwindRules`, `repoPackageJsonRules`, `documentationRules`) stay exported for manual wiring.
+`pasikaApp` is the plain-TypeScript-repository preset — the package.json manifest, the zirka configuration contract, and the docs. It carries no `src/**` source block: source linting is the Next.js app's job. `pasikaNextjsApp` is the full framework preset: everything in `pasikaApp` plus the Next.js-stack manifest requirement, the `src/**` app source rules, and the Tailwind stylesheet blocks. The granular rule objects (`tailwindRules`, `repoPackageJsonRules`, `documentationRules`) stay exported for manual wiring.
 
 The `src/**` blocks ship `@typescript-eslint/parser` themselves, so a standalone preset parses `.ts`/`.tsx` correctly on its own (`pasika` lists it as a runtime dependency).
 
@@ -231,7 +231,7 @@ Many of the TS/TSX rules call the TypeScript compiler API directly at lint time,
 ```bash
 npm run lint
 npm run typecheck
-npm run test
+npm run test:unit
 npm run coverage
 npm run build
 npm run dogfood -- ../some/repo   # requires a build; see Dogfooding above

package/dist/eslint/pasika/index.d.ts

@@ -119,6 +119,8 @@ declare const tailwindRules: {
 declare const repoPackageJsonRules: {
     "no-vulyk-dependency": _eslint_json.JSONRuleDefinition;
     "exact-version": _eslint_json.JSONRuleDefinition;
+    "lint-setup": _eslint_json.JSONRuleDefinition;
+    "vitest-coverage": _eslint_json.JSONRuleDefinition;
 };
 /** Package.json rules specific to a Next.js (or React) application. */
 declare const nextjsPackageJsonRules: {
@@ -147,6 +149,8 @@ declare const pasikaPlugin: {
         "nextjs-stack": _eslint_json.JSONRuleDefinition;
         "no-vulyk-dependency": _eslint_json.JSONRuleDefinition;
         "exact-version": _eslint_json.JSONRuleDefinition;
+        "lint-setup": _eslint_json.JSONRuleDefinition;
+        "vitest-coverage": _eslint_json.JSONRuleDefinition;
         "theme-reset": _eslint_css.CSSRuleDefinition;
         "root-variables": _eslint_css.CSSRuleDefinition;
         "apply-usage": _eslint_css.CSSRuleDefinition;
@@ -246,13 +250,16 @@ declare const allPasikaRuleIds: string[];
  * source block: source linting is the Next.js app's job.
  * Use this for a plain TypeScript repository that does not adopt the framework.
  */
-declare const typescriptApp: Linter.Config[];
+declare const pasikaApp: Linter.Config[];
 /**
  * Next.js app preset: the full adopted-to-the-framework stack. Anything in
- * `typescriptApp` plus the framework-only blocks — the Next.js-stack manifest
+ * `pasikaApp` plus the framework-only blocks — the Next.js-stack manifest
  * requirement, the `src/**` app source rules, and the Tailwind stylesheet
- * rules. `typescriptApp` is a strict subset of `nextjsApp`.
+ * rules. `pasikaApp` is a strict subset of `pasikaNextjsApp`. Consuming this
+ * preset (spreading or iterating it) runs the TypeScript alignment diagnostic
+ * first, so a mismatched compiler major fails config load with an actionable
+ * error instead of crashing every type-aware rule later.
  */
-declare const nextjsApp: Linter.Config[];
+declare const pasikaNextjsApp: Linter.Config[];
 
-export { allPasikaRuleIds, documentationRules, huskyRules, nextjsApp, nextjsPackageJsonRules, pasikaPlugin, repoPackageJsonRules, tailwindRules, typescriptApp, vulykRules };
+export { allPasikaRuleIds, documentationRules, huskyRules, nextjsPackageJsonRules, pasikaApp, pasikaNextjsApp, pasikaPlugin, repoPackageJsonRules, tailwindRules, vulykRules };

package/dist/eslint/pasika/index.js

@@ -4,6 +4,53 @@ import jsonPlugin from "@eslint/json";
 import markdown from "@eslint/markdown";
 import tsParser from "@typescript-eslint/parser";
 
+// eslint/ts-alignment.ts
+import { readFileSync } from "fs";
+import { createRequire } from "module";
+import { join } from "path";
+var ownRequire = createRequire(import.meta.url);
+var majorOf = (version) => Number(version.split(".")[0]);
+function versionOf(packagePath) {
+  try {
+    const parsed = JSON.parse(readFileSync(packagePath, "utf8"));
+    if (typeof parsed !== "object" || parsed === null || !("version" in parsed)) return null;
+    return typeof parsed.version === "string" ? parsed.version : null;
+  } catch {
+    return null;
+  }
+}
+function resolveTypescriptAlignment() {
+  let bundled = null;
+  try {
+    bundled = versionOf(ownRequire.resolve("typescript/package.json"));
+  } catch {
+    bundled = null;
+  }
+  let resolved = null;
+  try {
+    const consumerRequire = createRequire(join(process.cwd(), "package.json"));
+    resolved = versionOf(consumerRequire.resolve("typescript/package.json"));
+  } catch {
+    resolved = null;
+  }
+  return { bundled, resolved };
+}
+function alignmentError(bundled, resolved) {
+  if (bundled === null || resolved === null) return null;
+  const bundledMajor = majorOf(bundled);
+  const resolvedMajor = majorOf(resolved);
+  if (bundledMajor === resolvedMajor) return null;
+  const direction = resolvedMajor < bundledMajor ? `Upgrade your typescript to ^${String(bundledMajor)} (pinned exact) so a single hoisted copy serves the whole pipeline.` : `Your repository is ahead of the compiler pasika ships. Pin typescript to ^${String(bundledMajor)} for now and upgrade pasika when it bundles the newer major.`;
+  return new Error(
+    `[pasika] TypeScript major mismatch: the pasikaNextjsApp preset parses src/** with its bundled @typescript-eslint/parser, which runs on typescript ${bundled}; your repository resolves typescript ${resolved} for the type-aware rules. Two TypeScript majors mean the types the parser builds use a different TypeFlags layout than the rules expect, so every type-aware rule crashes (e.g. "undefined is not iterable" in ts-api-utils). Align them on ${String(bundledMajor)}, then lint will run again. ${direction}`
+  );
+}
+function assertTypescriptAlignment() {
+  const { bundled, resolved } = resolveTypescriptAlignment();
+  const error = alignmentError(bundled, resolved);
+  if (error) throw error;
+}
+
 // eslint/rules/filename-case.ts
 import path2 from "path";
 
@@ -473,7 +520,7 @@ var noArbitraryTailwindRule = {
 };
 
 // eslint/rules/unknown-utility.ts
-import { readdirSync, readFileSync, statSync } from "fs";
+import { readdirSync, readFileSync as readFileSync2, statSync } from "fs";
 import path5 from "path";
 var PREFIX_NAMESPACES = {
   bg: ["color"],
@@ -752,7 +799,7 @@ function readInventory(files) {
   for (const file of files) {
     let css2;
     try {
-      css2 = readFileSync(file, "utf8");
+      css2 = readFileSync2(file, "utf8");
     } catch {
       continue;
     }
@@ -922,7 +969,7 @@ import path7 from "path";
 
 // eslint/project/parse-module.ts
 import path6 from "path";
-import { readFileSync as readFileSync2 } from "fs";
+import { readFileSync as readFileSync3 } from "fs";
 import ts2 from "typescript";
 var isPascalCase3 = (name) => /^[A-Z][A-Za-z0-9]*$/.test(name);
 var isHookName = (name) => /^use[A-Z]/.test(name);
@@ -959,7 +1006,7 @@ function classifyValue(name, initializer, isTsx) {
   return "constant";
 }
 function parseModule(file) {
-  const text = readFileSync2(file, "utf8");
+  const text = readFileSync3(file, "utf8");
   const isTsx = file.endsWith(".tsx") || file.endsWith(".jsx");
   const sourceFile = ts2.createSourceFile(file, text, ts2.ScriptTarget.Latest, true, ts2.ScriptKind.TSX);
   const imports = [];
@@ -3207,7 +3254,7 @@ var typeExtractionRule = {
 
 // eslint/rules/locale-placement.ts
 import path32 from "path";
-import { readFileSync as readFileSync3 } from "fs";
+import { readFileSync as readFileSync4 } from "fs";
 import ts5 from "typescript";
 var LOCALE_ACCESS = /\blocales\.(?<key>[A-Za-z_$][\w$]*)/g;
 var camelCase = (name) => name.replace(/-[a-z]/g, (match) => match.slice(1).toUpperCase());
@@ -3264,7 +3311,7 @@ var localePlacementRule = {
       return candidateSegments.length === 2 && candidateSegments[0] === "locales" && candidateSegments[1]?.startsWith("index.");
     });
     if (!localesFile || file !== localesFile) return {};
-    const placement = localePlacement(readFileSync3(localesFile, "utf8"));
+    const placement = localePlacement(readFileSync4(localesFile, "utf8"));
     if (!placement) return {};
     const keyReaders = /* @__PURE__ */ new Map();
     const keyFeatures = /* @__PURE__ */ new Map();
@@ -3276,7 +3323,7 @@ var localePlacementRule = {
       );
       if (!importsLocales) continue;
       const candidateSegments = segmentsOf(candidateFile, sourceRoot);
-      for (const match of readFileSync3(candidateFile, "utf8").matchAll(LOCALE_ACCESS)) {
+      for (const match of readFileSync4(candidateFile, "utf8").matchAll(LOCALE_ACCESS)) {
         const key = match.groups?.key;
         if (key === void 0) continue;
         const readers = keyReaders.get(key) ?? /* @__PURE__ */ new Set();
@@ -3613,7 +3660,7 @@ var localeKeyShapeRule = {
 
 // eslint/rules/shared-style-dedup.ts
 import path35 from "path";
-import { readFileSync as readFileSync4, statSync as statSync3 } from "fs";
+import { readFileSync as readFileSync5, statSync as statSync3 } from "fs";
 var CLASS_NAME = /className="(?<classes>[^"]+)"/g;
 var comboCache;
 function combosFor(index) {
@@ -3631,7 +3678,7 @@ function combosFor(index) {
   }
   const combos = /* @__PURE__ */ new Map();
   for (const file of files) {
-    const text = readFileSync4(file, "utf8");
+    const text = readFileSync5(file, "utf8");
     for (const match of text.matchAll(CLASS_NAME)) {
       const classes = (match.groups?.classes ?? "").split(/\s+/).filter(Boolean);
       if (classes.length < 2) continue;
@@ -4541,7 +4588,7 @@ var noTemplatePromptRule = {
 import path41 from "path";
 
 // eslint/rules/documentation/project-index.ts
-import { readdirSync as readdirSync3, readFileSync as readFileSync5, statSync as statSync4 } from "fs";
+import { readdirSync as readdirSync3, readFileSync as readFileSync6, statSync as statSync4 } from "fs";
 import path40 from "path";
 var KIND_BY_SUFFIX = [
   ["-rule.md", "rule"],
@@ -4559,7 +4606,7 @@ function listMarkdownFiles(dir) {
   });
 }
 function extractTitle(filePath) {
-  const content = readFileSync5(filePath, "utf8");
+  const content = readFileSync6(filePath, "utf8");
   const match = /^# (?<title>.+)$/m.exec(content);
   return match?.groups?.title?.trim() ?? "";
 }
@@ -4842,10 +4889,10 @@ var noNestedHowToRule = {
 };
 
 // eslint/rules/documentation/glossary-term-linking.ts
-import { readFileSync as readFileSync6 } from "fs";
+import { readFileSync as readFileSync7 } from "fs";
 import path42 from "path";
 function extractGlossaryTerms(filePath) {
-  const content = readFileSync6(filePath, "utf8");
+  const content = readFileSync7(filePath, "utf8");
   const terms = [];
   const headingPattern = /^## (?<term>.+)$/gm;
   let match;
@@ -5444,7 +5491,7 @@ import { statSync as statSync6 } from "fs";
 import path46 from "path";
 
 // eslint/rules/tailwind/source-files.ts
-import { readdirSync as readdirSync4, readFileSync as readFileSync7, statSync as statSync5 } from "fs";
+import { readdirSync as readdirSync4, readFileSync as readFileSync8, statSync as statSync5 } from "fs";
 import path44 from "path";
 var CSS_EXTENSIONS = [".css"];
 var MODULE_EXTENSIONS3 = [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"];
@@ -5475,7 +5522,7 @@ function cachedTextReader() {
     let text = texts.get(file);
     if (text === void 0) {
       try {
-        text = readFileSync7(file, "utf8");
+        text = readFileSync8(file, "utf8");
       } catch {
         text = "";
       }
@@ -5739,10 +5786,108 @@ var exactVersionRule = {
   }
 };
 
-// eslint/rules/package-json/no-vulyk-dependency.ts
+// eslint/rules/package-json/lint-setup.ts
 function memberName2(member) {
   return member.name.type === "String" ? member.name.value : member.name.name;
 }
+function memberValue2(member) {
+  return member?.value.type === "String" ? member.value.value : void 0;
+}
+function stringValues(value) {
+  if (value.type === "String") return [value.value];
+  if (value.type !== "Array") return [];
+  return value.elements.flatMap((element) => element.value.type === "String" ? [element.value.value] : []);
+}
+var SOURCE_GLOB_PATTERN = /(?:^|[^a-z])(?:[cm]?[jt]sx?)(?:[^a-z]|$)/i;
+var DIRECT_ESLINT_PATTERN = /(?:^|&&|\|\||;)\s*(?:npx\s+)?eslint(?:\s|$)/;
+var REPOSITORY_ARGUMENT_PATTERN = /(?:^|\s)\.(?=\s|$)/;
+var PRETTIER_PATTERN = /\bprettier\b/;
+var CHECK_FLAG_PATTERN = /(?:^|\s)(?:--check|-c)(?:\s|$)/;
+function runsEslintDirectly(command) {
+  return DIRECT_ESLINT_PATTERN.test(command);
+}
+function runsPrettier(command) {
+  return PRETTIER_PATTERN.test(command);
+}
+function runsNamedScript(command, name) {
+  return command.includes(`npm run ${name}`);
+}
+var lintSetupRule = {
+  meta: {
+    schema: [],
+    type: "problem",
+    docs: {
+      description: "Require full-repository lint/format scripts and argument-free staged-file scripts that lint-staged runs by name."
+    }
+  },
+  create(context) {
+    return {
+      Document(node) {
+        const root = node.body;
+        if (root.type !== "Object") return;
+        const scripts = root.members.find((member) => memberName2(member) === "scripts");
+        const scriptMembers = scripts?.value.type === "Object" ? scripts.value.members : [];
+        const findScript = (name) => scriptMembers.find((member) => memberName2(member) === name);
+        const lint = findScript("lint");
+        const lintCommand = memberValue2(lint);
+        if (lintCommand === void 0 || !runsEslintDirectly(lintCommand) || !REPOSITORY_ARGUMENT_PATTERN.test(lintCommand)) {
+          context.report({
+            node: lint ?? node,
+            message: 'package.json must declare a "lint" script that runs ESLint across the repository (e.g. "eslint .").'
+          });
+        }
+        const format = findScript("format");
+        const formatCommand = memberValue2(format);
+        if (formatCommand === void 0 || !runsPrettier(formatCommand) || !CHECK_FLAG_PATTERN.test(formatCommand) || !REPOSITORY_ARGUMENT_PATTERN.test(formatCommand)) {
+          context.report({
+            node: format ?? node,
+            message: 'package.json must declare a "format" script that runs prettier --check across the repository.'
+          });
+        }
+        const lintStaged = findScript("lint:staged");
+        const lintStagedCommand = memberValue2(lintStaged);
+        if (lintStagedCommand === void 0 || !runsEslintDirectly(lintStagedCommand) || REPOSITORY_ARGUMENT_PATTERN.test(lintStagedCommand)) {
+          context.report({
+            node: lintStaged ?? node,
+            message: 'package.json must declare a "lint:staged" script that runs ESLint with no repository-wide argument (e.g. "eslint --fix").'
+          });
+        }
+        const formatStaged = findScript("format:staged");
+        const formatStagedCommand = memberValue2(formatStaged);
+        if (formatStagedCommand === void 0 || !runsPrettier(formatStagedCommand) || REPOSITORY_ARGUMENT_PATTERN.test(formatStagedCommand)) {
+          context.report({
+            node: formatStaged ?? node,
+            message: 'package.json must declare a "format:staged" script that runs prettier with no repository-wide argument (e.g. "prettier --write").'
+          });
+        }
+        const lintStagedConfig = root.members.find((member) => memberName2(member) === "lint-staged");
+        const runsStagedScript = (name) => lintStagedConfig?.value.type === "Object" && lintStagedConfig.value.members.some(
+          (member) => stringValues(member.value).some((command) => runsNamedScript(command, name))
+        );
+        const hasStagedLintEntry = lintStagedConfig?.value.type === "Object" && lintStagedConfig.value.members.some(
+          (member) => SOURCE_GLOB_PATTERN.test(memberName2(member)) && stringValues(member.value).some((command) => runsNamedScript(command, "lint:staged"))
+        );
+        if (!hasStagedLintEntry) {
+          context.report({
+            node: lintStagedConfig ?? node,
+            message: 'package.json lint-staged must run "npm run lint:staged --" for staged JavaScript or TypeScript files.'
+          });
+        }
+        if (!runsStagedScript("format:staged")) {
+          context.report({
+            node: lintStagedConfig ?? node,
+            message: 'package.json lint-staged must run "npm run format:staged --" for staged files ESLint does not already format.'
+          });
+        }
+      }
+    };
+  }
+};
+
+// eslint/rules/package-json/no-vulyk-dependency.ts
+function memberName3(member) {
+  return member.name.type === "String" ? member.name.value : member.name.name;
+}
 var noVulykDependencyRule = {
   meta: {
     schema: [],
@@ -5757,9 +5902,9 @@ var noVulykDependencyRule = {
         const root = node.body;
         if (root.type !== "Object") return;
         for (const key of ["dependencies", "devDependencies"]) {
-          const section = root.members.find((member) => memberName2(member) === key);
+          const section = root.members.find((member) => memberName3(member) === key);
           if (section?.value.type !== "Object") continue;
-          const vulyk = section.value.members.find((member) => memberName2(member) === "vulyk");
+          const vulyk = section.value.members.find((member) => memberName3(member) === "vulyk");
           if (vulyk) {
             context.report({
               node: vulyk,
@@ -5789,15 +5934,19 @@ var NEXTJS_STACK_DEV_DEPENDENCIES = [
   "prettier",
   "husky",
   "lint-staged",
-  "zirka"
+  "zirka",
+  "jsdom",
+  "@vitejs/plugin-react",
+  "@testing-library/react",
+  "@testing-library/dom"
 ];
-function memberName3(member) {
+function memberName4(member) {
   return member.name.type === "String" ? member.name.value : member.name.name;
 }
 function sectionPackages(root, section) {
-  const member = root.type === "Object" ? root.members.find((entry) => memberName3(entry) === section) : void 0;
+  const member = root.type === "Object" ? root.members.find((entry) => memberName4(entry) === section) : void 0;
   if (member?.value.type !== "Object") return /* @__PURE__ */ new Set();
-  return new Set(member.value.members.map(memberName3));
+  return new Set(member.value.members.map(memberName4));
 }
 var nextjsStackRule = {
   meta: {
@@ -5833,19 +5982,151 @@ var nextjsStackRule = {
   }
 };
 
+// eslint/rules/package-json/vitest-coverage.ts
+import { existsSync as existsSync2, readFileSync as readFileSync9 } from "fs";
+import path47 from "path";
+function memberName5(member) {
+  return member.name.type === "String" ? member.name.value : member.name.name;
+}
+function memberValue3(member) {
+  return member?.value.type === "String" ? member.value.value : void 0;
+}
+function stringValues2(value) {
+  if (value.type === "String") return [value.value];
+  if (value.type !== "Array") return [];
+  return value.elements.flatMap((element) => element.value.type === "String" ? [element.value.value] : []);
+}
+var VITEST_CONFIG_NAMES = [
+  "vitest.config.ts",
+  "vitest.config.mts",
+  "vitest.config.cts",
+  "vitest.config.js",
+  "vitest.config.mjs",
+  "vitest.config.cjs"
+];
+var THRESHOLD_METRICS = ["lines", "functions", "branches", "statements"];
+var SOURCE_GLOB_PATTERN2 = /(?:^|[^a-z])(?:[cm]?[jt]sx?)(?:[^a-z]|$)/i;
+var COVERAGE_FLAG_PATTERN = /(?:^|\s)--coverage(?:[=\s]|$)/;
+var RELATED_PATTERN = /\brelated\b/;
+var AUTO_UPDATE_PATTERN = /autoUpdate\s*:\s*true/;
+var CHANGED_FLAG_PATTERN = /--coverage\.changed\b/;
+var PER_FILE_FLAG_PATTERN = /--coverage\.thresholds\.perFile\b/;
+var AUTO_UPDATE_DISABLED_FLAG_PATTERN = /--coverage\.thresholds\.autoUpdate=false\b/;
+function hasEightyOrAboveFlag(command, metric) {
+  return new RegExp(`--coverage\\.thresholds\\.${metric}=(?:8\\d|9\\d|100)\\b`).test(command);
+}
+var vitestCoverageRule = {
+  meta: {
+    schema: [],
+    type: "problem",
+    docs: {
+      description: "Require Vitest unit-test scripts, the V8 provider, a rising coverage threshold, and an 80% floor on staged files via lint-staged."
+    }
+  },
+  create(context) {
+    return {
+      Document(node) {
+        const root = node.body;
+        if (root.type !== "Object") return;
+        const devDependencies = root.members.find((member) => memberName5(member) === "devDependencies");
+        const devDependencyNames = new Set(
+          devDependencies?.value.type === "Object" ? devDependencies.value.members.map(memberName5) : []
+        );
+        if (!devDependencyNames.has("vitest")) {
+          context.report({ node, message: "vitest must be listed in package.json as a devDependency." });
+        }
+        if (!devDependencyNames.has("@vitest/coverage-v8")) {
+          context.report({
+            node,
+            message: "@vitest/coverage-v8 must be listed in package.json as a devDependency."
+          });
+        }
+        const scripts = root.members.find((member) => memberName5(member) === "scripts");
+        const scriptMembers = scripts?.value.type === "Object" ? scripts.value.members : [];
+        const unit = scriptMembers.find((member) => memberName5(member) === "test:unit");
+        const unitCommand = memberValue3(unit);
+        if (unitCommand === void 0 || !/\bvitest\b/.test(unitCommand) || COVERAGE_FLAG_PATTERN.test(unitCommand)) {
+          context.report({
+            node: unit ?? node,
+            message: 'package.json must declare a "test:unit" script that runs Vitest without coverage.'
+          });
+        }
+        const coverage = scriptMembers.find((member) => memberName5(member) === "test:unit:coverage");
+        const coverageCommand = memberValue3(coverage);
+        if (coverageCommand === void 0 || !/\bvitest\b/.test(coverageCommand) || !COVERAGE_FLAG_PATTERN.test(coverageCommand)) {
+          context.report({
+            node: coverage ?? node,
+            message: 'package.json must declare a "test:unit:coverage" script that runs Vitest with coverage.'
+          });
+        }
+        const configName = VITEST_CONFIG_NAMES.find((name) => existsSync2(path47.join(context.cwd, name)));
+        if (!configName) {
+          context.report({
+            node,
+            message: "No vitest config found. Create one with a coverage threshold above zero for lines, functions, branches, and statements."
+          });
+          return;
+        }
+        const content = readFileSync9(path47.join(context.cwd, configName), "utf8");
+        for (const metric of THRESHOLD_METRICS) {
+          if (!new RegExp(`\\b${metric}\\s*:\\s*[1-9]\\d*`).test(content)) {
+            context.report({ node, message: `${configName} must set a coverage threshold above zero for ${metric}.` });
+          }
+        }
+        if (!AUTO_UPDATE_PATTERN.test(content)) {
+          context.report({
+            node,
+            message: `${configName} must set coverage.thresholds.autoUpdate to true.`
+          });
+        }
+        const changedCoverage = scriptMembers.find((member) => memberName5(member) === "test:unit:coverage:staged");
+        const changedCoverageCommand = memberValue3(changedCoverage);
+        if (changedCoverageCommand === void 0 || !/\bvitest\b/.test(changedCoverageCommand) || !RELATED_PATTERN.test(changedCoverageCommand) || !COVERAGE_FLAG_PATTERN.test(changedCoverageCommand)) {
+          context.report({
+            node: changedCoverage ?? node,
+            message: 'package.json must declare a "test:unit:coverage:staged" script that runs vitest related with coverage.'
+          });
+        }
+        const lintStaged = root.members.find((member) => memberName5(member) === "lint-staged");
+        const hasStagedChangedCoverage = lintStaged?.value.type === "Object" && lintStaged.value.members.some(
+          (member) => SOURCE_GLOB_PATTERN2.test(memberName5(member)) && stringValues2(member.value).some((command) => command.includes("npm run test:unit:coverage:staged"))
+        );
+        if (!hasStagedChangedCoverage) {
+          context.report({
+            node: lintStaged ?? node,
+            message: 'package.json lint-staged must run "npm run test:unit:coverage:staged" for staged JavaScript or TypeScript files.'
+          });
+        }
+        const changedCoverageCommandText = changedCoverageCommand ?? "";
+        const hasEightyFloor = THRESHOLD_METRICS.every(
+          (metric) => hasEightyOrAboveFlag(changedCoverageCommandText, metric)
+        );
+        if (!CHANGED_FLAG_PATTERN.test(changedCoverageCommandText) || !PER_FILE_FLAG_PATTERN.test(changedCoverageCommandText) || !hasEightyFloor || !AUTO_UPDATE_DISABLED_FLAG_PATTERN.test(changedCoverageCommandText)) {
+          context.report({
+            node: changedCoverage ?? node,
+            message: 'package.json "test:unit:coverage:staged" script must pass --coverage.changed, a --coverage.thresholds.perFile of at least 80 for lines, functions, branches, and statements, and --coverage.thresholds.autoUpdate=false.'
+          });
+        }
+      }
+    };
+  }
+};
+
 // eslint/rules/package-json/index.ts
 var repoPackageJsonRules = {
   "no-vulyk-dependency": noVulykDependencyRule,
-  "exact-version": exactVersionRule
+  "exact-version": exactVersionRule,
+  "lint-setup": lintSetupRule,
+  "vitest-coverage": vitestCoverageRule
 };
 var nextjsPackageJsonRules = {
   "nextjs-stack": nextjsStackRule
 };
 
 // eslint/rules/husky/husky-hook.ts
-import { existsSync as existsSync2, readFileSync as readFileSync8 } from "fs";
-import path47 from "path";
-function memberName4(member) {
+import { existsSync as existsSync3, readFileSync as readFileSync10 } from "fs";
+import path48 from "path";
+function memberName6(member) {
   return member.name.type === "String" ? member.name.value : member.name.name;
 }
 var huskyHookRule = {
@@ -5853,7 +6134,7 @@ var huskyHookRule = {
     schema: [],
     type: "problem",
     docs: {
-      description: "Require a pre-commit hook that runs lint-staged, typecheck, and the libyear drift check."
+      description: "Require a pre-commit hook that runs lint-staged and the libyear drift check directly, and the typecheck and suppression-file ratchet through named package.json scripts."
     }
   },
   create(context) {
@@ -5861,29 +6142,39 @@ var huskyHookRule = {
       Document(node) {
         const root = node.body;
         if (root.type !== "Object") return;
-        const scriptName = context.filename;
-        if (!scriptName.endsWith("package.json")) return;
-        const hookPath = path47.join(context.cwd, ".husky", "pre-commit");
-        if (!existsSync2(hookPath)) {
+        if (!context.filename.endsWith("package.json")) return;
+        const hookPath = path48.join(context.cwd, ".husky", "pre-commit");
+        if (!existsSync3(hookPath)) {
           context.report({
             node,
             message: "No .husky/pre-commit hook found. Configure husky to run checks before commits."
           });
           return;
         }
-        const content = readFileSync8(hookPath, "utf8");
+        const content = readFileSync10(hookPath, "utf8");
+        const scripts = root.members.find((member) => memberName6(member) === "scripts");
+        const scriptNames = new Set(scripts?.value.type === "Object" ? scripts.value.members.map(memberName6) : []);
+        const requireNamedScript = (name) => {
+          if (!scriptNames.has(name)) {
+            context.report({ node, message: `package.json must declare a "${name}" script.` });
+          }
+          if (!content.includes(`npm run ${name}`)) {
+            context.report({ node, message: `.husky/pre-commit must run npm run ${name}.` });
+          }
+        };
         if (!content.includes("lint-staged")) {
           context.report({ node, message: ".husky/pre-commit must run lint-staged." });
         }
-        if (!content.includes("typecheck")) {
-          context.report({ node, message: ".husky/pre-commit must run npm run typecheck." });
-        }
+        requireNamedScript("typecheck");
         if (!content.includes("libyear --limit-major-individual=1")) {
           context.report({ node, message: ".husky/pre-commit must run npx libyear --limit-major-individual=1." });
         }
-        const scripts = root.members.find((member) => memberName4(member) === "scripts");
+        const suppressionsPath = path48.join(context.cwd, "eslint-suppressions.json");
+        if (existsSync3(suppressionsPath)) {
+          requireNamedScript("lint:prune");
+        }
         if (scripts?.value.type === "Object") {
-          const prepare = scripts.value.members.find((member) => memberName4(member) === "prepare");
+          const prepare = scripts.value.members.find((member) => memberName6(member) === "prepare");
           if (prepare?.value.type === "String" && !prepare.value.value.includes("husky")) {
             context.report({
               node: prepare,
@@ -5902,8 +6193,8 @@ var huskyRules = {
 };
 
 // eslint/rules/vulyk/vulyk-docs.ts
-import { existsSync as existsSync3, readFileSync as readFileSync9 } from "fs";
-import path48 from "path";
+import { existsSync as existsSync4, readFileSync as readFileSync11 } from "fs";
+import path49 from "path";
 var PASIKA_REPO = "Bredansky/pasika";
 var BASE_REQUIRED_DOCS = [
   { name: "documentation-guide", path: "docs/documentation-guide" },
@@ -5914,13 +6205,13 @@ var NEXTJS_REQUIRED_DOCS = [
   { name: "next-codebase-guide", path: "docs/next-codebase-guide" },
   { name: "next-tailwind-guide", path: "docs/next-tailwind-guide" }
 ];
-function memberName5(member) {
+function memberName7(member) {
   return member.name.type === "String" ? member.name.value : member.name.name;
 }
 function hasDependency(root, name) {
-  const section = root.members.find((member) => memberName5(member) === "dependencies");
+  const section = root.members.find((member) => memberName7(member) === "dependencies");
   if (section?.value.type !== "Object") return false;
-  return section.value.members.some((member) => memberName5(member) === name);
+  return section.value.members.some((member) => memberName7(member) === name);
 }
 var vulykDocsRule = {
   meta: {
@@ -5936,16 +6227,16 @@ var vulykDocsRule = {
         if (!context.filename.endsWith("package.json")) return;
         const root = node.body;
         if (root.type !== "Object") return;
-        const projectRoot = path48.dirname(path48.resolve(context.filename));
-        const configPath = path48.join(projectRoot, "vulyk.config.ts");
-        if (!existsSync3(configPath)) {
+        const projectRoot = path49.dirname(path49.resolve(context.filename));
+        const configPath = path49.join(projectRoot, "vulyk.config.ts");
+        if (!existsSync4(configPath)) {
           context.report({
             node,
             message: "No vulyk.config.ts found. Run npx vulyk@latest init to create one that tracks the framework's docs."
           });
           return;
         }
-        const config = readFileSync9(configPath, "utf8");
+        const config = readFileSync11(configPath, "utf8");
         if (!config.includes(PASIKA_REPO)) {
           context.report({
             node,
@@ -5962,8 +6253,8 @@ var vulykDocsRule = {
             });
           }
         }
-        const agentsPath = path48.join(projectRoot, "AGENTS.md");
-        if (!existsSync3(agentsPath)) {
+        const agentsPath = path49.join(projectRoot, "AGENTS.md");
+        if (!existsSync4(agentsPath)) {
           context.report({
             node,
             message: "No AGENTS.md found. Run npx vulyk@latest agents to generate the agent file that routes to the tracked docs."
@@ -5980,7 +6271,7 @@ var vulykRules = {
 };
 
 // eslint/index.ts
-var nextjsAppRules = {
+var pasikaNextjsAppRules = {
   // Framework-agnostic TypeScript rules.
   "filename-case": filenameCaseRule,
   "import-boundaries": importBoundariesRule,
@@ -6030,7 +6321,7 @@ var pasikaPlugin = {
   rules: {
     // The shared plugin must register every rule the preset blocks reference,
     // so all rule sets live here.
-    ...nextjsAppRules,
+    ...pasikaNextjsAppRules,
     ...documentationRules,
     ...tailwindRules,
     ...repoPackageJsonRules,
@@ -6043,7 +6334,7 @@ var jsonLanguage = { languages: { json: jsonPlugin.languages.json } };
 function ruleIds(rules2) {
   return Object.keys(rules2).map((name) => `pasika/${name}`);
 }
-var nextjsAppRuleIds = ruleIds(nextjsAppRules);
+var pasikaNextjsAppRuleIds = ruleIds(pasikaNextjsAppRules);
 var documentationRuleIds = ruleIds(documentationRules);
 var tailwindRuleIds = ruleIds(tailwindRules);
 var repoPackageJsonRuleIds = ruleIds(repoPackageJsonRules);
@@ -6051,7 +6342,7 @@ var nextjsPackageJsonRuleIds = ruleIds(nextjsPackageJsonRules);
 var huskyRuleIds = ruleIds(huskyRules);
 var vulykRuleIds = ruleIds(vulykRules);
 var allPasikaRuleIds = [
-  ...nextjsAppRuleIds,
+  ...pasikaNextjsAppRuleIds,
   ...documentationRuleIds,
   ...tailwindRuleIds,
   ...repoPackageJsonRuleIds,
@@ -6059,7 +6350,7 @@ var allPasikaRuleIds = [
   ...huskyRuleIds,
   ...vulykRuleIds
 ];
-var typescriptAppLanguageOptions = {
+var pasikaAppLanguageOptions = {
   parser: tsParser,
   parserOptions: {
     ecmaVersion: "latest",
@@ -6067,13 +6358,13 @@ var typescriptAppLanguageOptions = {
     ecmaFeatures: { jsx: true }
   }
 };
-var nextjsAppConfig = {
+var pasikaNextjsAppConfig = {
   files: ["src/**/*.{cjs,cts,js,jsx,mjs,mts,ts,tsx}"],
-  languageOptions: typescriptAppLanguageOptions,
+  languageOptions: pasikaAppLanguageOptions,
   plugins: {
     pasika: pasikaPlugin
   },
-  rules: Object.fromEntries(nextjsAppRuleIds.map((id) => [id, "error"]))
+  rules: Object.fromEntries(pasikaNextjsAppRuleIds.map((id) => [id, "error"]))
 };
 var tailwindStructureRules = {
   files: ["src/**/globals.css"],
@@ -6097,7 +6388,7 @@ var tailwindImportGraph = {
   languageOptions: { tolerant: true },
   rules: { "pasika/css-entry-point": "error" }
 };
-var typescriptAppPackageJsonConfig = {
+var pasikaAppPackageJsonConfig = {
   files: ["package.json"],
   plugins: {
     json: jsonLanguage,
@@ -6106,7 +6397,7 @@ var typescriptAppPackageJsonConfig = {
   language: "json/json",
   rules: Object.fromEntries([...repoPackageJsonRuleIds, ...huskyRuleIds, ...vulykRuleIds].map((id) => [id, "error"]))
 };
-var nextjsAppPackageJsonConfig = {
+var pasikaNextjsAppPackageJsonConfig = {
   files: ["package.json"],
   plugins: {
     json: jsonLanguage,
@@ -6133,27 +6424,39 @@ var documentationConfig = {
   language: "markdown/gfm",
   rules: Object.fromEntries(documentationRuleIds.map((id) => [id, "error"]))
 };
-var typescriptApp = [
-  typescriptAppPackageJsonConfig,
+var pasikaApp = [
+  pasikaAppPackageJsonConfig,
   zirkaConfig,
   documentationConfig
 ];
-var nextjsApp = [
-  ...typescriptApp,
-  nextjsAppPackageJsonConfig,
-  nextjsAppConfig,
+var pasikaNextjsAppWithDiagnostic = (preset) => {
+  let checked = false;
+  return new Proxy(preset, {
+    get(target, property, receiver) {
+      if (!checked && (property === Symbol.iterator || property === "length")) {
+        checked = true;
+        assertTypescriptAlignment();
+      }
+      return Reflect.get(target, property, receiver);
+    }
+  });
+};
+var pasikaNextjsApp = pasikaNextjsAppWithDiagnostic([
+  ...pasikaApp,
+  pasikaNextjsAppPackageJsonConfig,
+  pasikaNextjsAppConfig,
   tailwindStructureRules,
   tailwindImportGraph
-];
+]);
 export {
   allPasikaRuleIds,
   documentationRules,
   huskyRules,
-  nextjsApp,
   nextjsPackageJsonRules,
+  pasikaApp,
+  pasikaNextjsApp,
   pasikaPlugin,
   repoPackageJsonRules,
   tailwindRules,
-  typescriptApp,
   vulykRules
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pasika",
-  "version": "0.5.17",
+  "version": "0.6.0",
   "description": "Reusable agent setup package",
   "repository": {
     "type": "git",
@@ -22,15 +22,23 @@
     "coverage": "tsx scripts/coverage.ts",
     "dogfood": "tsx scripts/dogfood.ts",
     "fix": "eslint . --fix",
+    "format": "prettier --check . --ignore-unknown",
+    "format:staged": "prettier --write --ignore-unknown",
     "lint": "eslint .",
+    "lint:staged": "eslint --fix",
     "prepack": "npm run build",
     "prepare": "husky",
-    "test": "node --import tsx --test 'eslint/**/*.test.ts' 'scripts/**/*.test.ts' 'utils/**/*.test.ts'",
+    "test:unit": "vitest run",
+    "test:unit:coverage": "vitest run --coverage",
+    "test:unit:coverage:staged": "vitest related --run --coverage --coverage.changed --coverage.thresholds.perFile --coverage.thresholds.lines=80 --coverage.thresholds.functions=80 --coverage.thresholds.branches=80 --coverage.thresholds.statements=80 --coverage.thresholds.autoUpdate=false",
     "typecheck": "tsc --noEmit"
   },
   "lint-staged": {
-    "!(*.ts|*.mts|*.cts|*.tsx|*.js|*.cjs|*.mjs|*.jsx)": "prettier --write --ignore-unknown",
-    "*.ts|*.mts|*.cts|*.tsx|*.js|*.cjs|*.mjs|*.jsx": "npx eslint --fix"
+    "!(*.ts|*.mts|*.cts|*.tsx|*.js|*.cjs|*.mjs|*.jsx)": "npm run format:staged --",
+    "*.ts|*.mts|*.cts|*.tsx|*.js|*.cjs|*.mjs|*.jsx": [
+      "npm run lint:staged --",
+      "npm run test:unit:coverage:staged --"
+    ]
   },
   "dependencies": {
     "@typescript-eslint/parser": "8.68.0",
@@ -45,6 +53,7 @@
     "@types/estree": "1.0.9",
     "@types/mdast": "4.0.4",
     "@types/node": "26.4.0",
+    "@vitest/coverage-v8": "5.0.0",
     "eslint": "10.9.1",
     "husky": "9.1.7",
     "lint-staged": "17.4.1",
@@ -52,6 +61,7 @@
     "tsup": "8.5.1",
     "tsx": "4.23.12",
     "typescript": "6.0.3",
+    "vitest": "5.0.0",
     "zirka": "0.0.48",
     "zod": "4.4.3"
   },