pasika 0.5.18 → 0.6.1

package/README.md

@@ -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

@@ -98,6 +98,7 @@ declare const documentationRules: {
     "no-nested-how-to": _eslint_markdown.MarkdownRuleDefinition;
     "glossary-term-linking": _eslint_markdown.MarkdownRuleDefinition;
     "guide-mentions-documents": _eslint_markdown.MarkdownRuleDefinition;
+    "guide-section-shape": _eslint_markdown.MarkdownRuleDefinition;
 };
 
 declare const tailwindRules: {
@@ -119,6 +120,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 +150,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;
@@ -182,6 +187,7 @@ declare const pasikaPlugin: {
         "no-nested-how-to": _eslint_markdown.MarkdownRuleDefinition;
         "glossary-term-linking": _eslint_markdown.MarkdownRuleDefinition;
         "guide-mentions-documents": _eslint_markdown.MarkdownRuleDefinition;
+        "guide-section-shape": _eslint_markdown.MarkdownRuleDefinition;
         "filename-case": eslint.Rule.RuleModule;
         "import-boundaries": eslint.Rule.RuleModule;
         "named-exports": eslint.Rule.RuleModule;

package/dist/eslint/pasika/index.js

@@ -174,7 +174,9 @@ function findSimpleRoot(component, _text, _filename) {
   };
   visit(body);
   const rendered = returns.filter((statement) => statement.expression?.kind !== ts.SyntaxKind.NullKeyword);
-  const roots = rendered.map((statement) => statement.expression && ts.isExpression(statement.expression) ? rootFromExpression(statement.expression) : void 0).filter((root) => root !== void 0);
+  const roots = rendered.map(
+    (statement) => statement.expression && ts.isExpression(statement.expression) ? rootFromExpression(statement.expression) : void 0
+  ).filter((root) => root !== void 0);
   if (roots.length !== rendered.length || roots.length === 0) return void 0;
   const firstTag = roots[0]?.tagName;
   if (roots.some((root) => root.tagName !== firstTag)) return void 0;
@@ -2302,7 +2304,17 @@ var NEXT_ROUTING_FILES3 = /* @__PURE__ */ new Set([
   "sitemap",
   "twitter-image"
 ]);
-var INTERACTIVE_ATTRIBUTES = /* @__PURE__ */ new Set(["onClick", "onChange", "onSubmit", "href", "onKeyDown", "onKeyUp", "onFocus", "onBlur", "htmlFor"]);
+var INTERACTIVE_ATTRIBUTES = /* @__PURE__ */ new Set([
+  "onClick",
+  "onChange",
+  "onSubmit",
+  "href",
+  "onKeyDown",
+  "onKeyUp",
+  "onFocus",
+  "onBlur",
+  "htmlFor"
+]);
 function tagName(node) {
   const name = node.openingElement?.name;
   if (name?.type !== "JSXIdentifier") return void 0;
@@ -2375,7 +2387,9 @@ function isDecorative(node) {
   return !meaningfulText && !isContentElement(name);
 }
 function isContentElement(name) {
-  return /^(?:h[1-6]|p|li|dt|dd|blockquote|pre|code|figcaption|caption|th|td|form|fieldset|select|textarea)$/.test(name);
+  return /^(?:h[1-6]|p|li|dt|dd|blockquote|pre|code|figcaption|caption|th|td|form|fieldset|select|textarea)$/.test(
+    name
+  );
 }
 function isSoleContentOfWrapper(node) {
   const parent = node.parent;
@@ -4153,7 +4167,7 @@ var overviewRule = {
   meta: {
     type: "problem",
     docs: {
-      description: "Overview must exist, contain at most two sentences, and not link to other documents.",
+      description: "Required documentation overviews must exist, contain at most two sentences, and not link to other documents.",
       recommended: true
     }
   },
@@ -4196,6 +4210,41 @@ var overviewRule = {
         if (!found) {
           context.report({ node, message: "no overview follows the title" });
         }
+        const validateHeadedOverview = (heading, index, label) => {
+          const overview = node.children[index + 1];
+          if (overview?.type !== "paragraph") {
+            context.report({
+              node: heading,
+              message: `no overview follows ${label}`
+            });
+            return;
+          }
+          if (containsLink(overview)) {
+            context.report({
+              node: overview,
+              message: `overview of ${label} links another document`
+            });
+          }
+          const sectionSentenceCount = countSentences(getTextContent(overview).trim());
+          if (sectionSentenceCount > 2) {
+            context.report({
+              node: overview,
+              message: `overview of ${label} uses ${String(sectionSentenceCount)} sentences, at most two are allowed`
+            });
+          }
+        };
+        const isGuide = filename.endsWith("-guide.md");
+        const isReference = filename.endsWith("-reference.md");
+        if (!isGuide && !isReference) return;
+        for (const [index, child] of node.children.entries()) {
+          if (child.type !== "heading" || child.depth === 1) continue;
+          const title = getTextContent(child).trim();
+          if (isGuide && child.depth === 2 && /^How To \S/.test(title)) {
+            validateHeadedOverview(child, index, `guide section "${title}"`);
+          } else if (isReference) {
+            validateHeadedOverview(child, index, `reference block "${title}"`);
+          }
+        }
       }
     };
   }
@@ -5049,6 +5098,56 @@ var guideMentionsDocumentsRule = {
   }
 };
 
+// eslint/rules/documentation/guide-section-shape.ts
+var guideSectionShapeRule = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Guide sections use How To headings, an overview, and numbered steps.",
+      recommended: true
+    }
+  },
+  create(context) {
+    return {
+      root(node) {
+        if (!getFilename(context).endsWith("-guide.md")) return;
+        const sections = [];
+        for (const [index, child] of node.children.entries()) {
+          if (child.type !== "heading" || child.depth === 1) continue;
+          sections.push({ heading: child, index, title: getTextContent(child).trim() });
+        }
+        if (sections.length === 0) {
+          context.report({ node, message: "guide must contain at least one How To section" });
+          return;
+        }
+        for (const [sectionIndex, section] of sections.entries()) {
+          if (section.heading.depth !== 2) {
+            context.report({
+              node: section.heading,
+              message: `guide section heading "${section.title}" must be level two`
+            });
+          }
+          if (!/^How To \S/.test(section.title)) {
+            context.report({
+              node: section.heading,
+              message: `guide section heading "${section.title}" must start with "How To "`
+            });
+          }
+          const nextSection = sections[sectionIndex + 1];
+          const content = node.children.slice(section.index + 1, nextSection?.index ?? node.children.length);
+          const hasOverviewThenNumberedList = content.length === 2 && content[0]?.type === "paragraph" && content[1]?.type === "list" && content[1].ordered === true;
+          if (!hasOverviewThenNumberedList) {
+            context.report({
+              node: section.heading,
+              message: `guide section "${section.title}" must consist of its overview followed by one numbered list`
+            });
+          }
+        }
+      }
+    };
+  }
+};
+
 // eslint/rules/documentation/index.ts
 var documentationRules = {
   "doc-kind-suffix": docKindSuffixRule,
@@ -5073,7 +5172,8 @@ var documentationRules = {
   "guide-link-anchors": guideLinkAnchorsRule,
   "no-nested-how-to": noNestedHowToRule,
   "glossary-term-linking": glossaryTermLinkingRule,
-  "guide-mentions-documents": guideMentionsDocumentsRule
+  "guide-mentions-documents": guideMentionsDocumentsRule,
+  "guide-section-shape": guideSectionShapeRule
 };
 
 // eslint/rules/tailwind/helpers.ts
@@ -5786,10 +5886,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: [],
@@ -5804,9 +6002,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,
@@ -5836,15 +6034,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: {
@@ -5880,19 +6082,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 readFileSync9 } 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 = {
@@ -5900,7 +6234,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) {
@@ -5908,29 +6242,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 = readFileSync9(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,
@@ -5949,8 +6293,8 @@ var huskyRules = {
 };
 
 // eslint/rules/vulyk/vulyk-docs.ts
-import { existsSync as existsSync3, readFileSync as readFileSync10 } 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" },
@@ -5961,13 +6305,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: {
@@ -5983,16 +6327,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 = readFileSync10(configPath, "utf8");
+        const config = readFileSync11(configPath, "utf8");
         if (!config.includes(PASIKA_REPO)) {
           context.report({
             node,
@@ -6009,8 +6353,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."
@@ -6130,9 +6474,7 @@ var tailwindStructureRules = {
   },
   language: "css/css",
   languageOptions: { tolerant: true },
-  rules: Object.fromEntries(
-    tailwindRuleIds.filter((id) => id !== "pasika/css-entry-point").map((id) => [id, "error"])
-  )
+  rules: Object.fromEntries(tailwindRuleIds.filter((id) => id !== "pasika/css-entry-point").map((id) => [id, "error"]))
 };
 var tailwindImportGraph = {
   files: ["src/**/*.css"],
@@ -6180,11 +6522,7 @@ var documentationConfig = {
   language: "markdown/gfm",
   rules: Object.fromEntries(documentationRuleIds.map((id) => [id, "error"]))
 };
-var pasikaApp = [
-  pasikaAppPackageJsonConfig,
-  zirkaConfig,
-  documentationConfig
-];
+var pasikaApp = [pasikaAppPackageJsonConfig, zirkaConfig, documentationConfig];
 var pasikaNextjsAppWithDiagnostic = (preset) => {
   let checked = false;
   return new Proxy(preset, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pasika",
-  "version": "0.5.18",
+  "version": "0.6.1",
   "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,7 +61,8 @@
     "tsup": "8.5.1",
     "tsx": "4.23.12",
     "typescript": "6.0.3",
-    "zirka": "0.0.48",
+    "vitest": "5.0.0",
+    "zirka": "0.0.65",
     "zod": "4.4.3"
   },
   "peerDependencies": {