pasika 0.5.18 → 0.6.0

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

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

package/dist/eslint/pasika/index.js

@@ -5786,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: [],
@@ -5804,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,
@@ -5836,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: {
@@ -5880,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 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 +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) {
@@ -5908,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 = 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 +6193,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 +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: {
@@ -5983,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 = readFileSync10(configPath, "utf8");
+        const config = readFileSync11(configPath, "utf8");
         if (!config.includes(PASIKA_REPO)) {
           context.report({
             node,
@@ -6009,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."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pasika",
-  "version": "0.5.18",
+  "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"
   },