@poleski/quality-tools 0.1.3

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@poleski/quality-tools",
+  "version": "0.1.3",
+  "type": "module",
+  "description": "Portable TypeScript quality checks for project structure, complexity, mutation, and test health",
+  "license": "MIT",
+  "bin": {
+    "quality-tools": "./dist/cli/main.js"
+  },
+  "files": [
+    "dist/",
+    "stryker/",
+    "stryker.config.cjs",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.22.0"
+  },
+  "dependencies": {
+    "@stryker-mutator/api": "^9.6.1",
+    "@stryker-mutator/core": "^9.6.1",
+    "@stryker-mutator/vitest-runner": "^9.6.1",
+    "glob": "^13.0.6",
+    "semver": "^7.7.4",
+    "typescript": "^5.3.3"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.30.0",
+    "@eslint/js": "^9.0.0",
+    "@types/node": "^20.11.0",
+    "@vitest/coverage-istanbul": "^3.2.4",
+    "esbuild": "^0.25.0",
+    "eslint": "^9.0.0",
+    "tsx": "^4.21.0",
+    "vitest": "^3.0.0",
+    "typescript-eslint": "^8.0.0"
+  },
+  "scripts": {
+    "build": "esbuild src/cli/main.ts --bundle --platform=node --format=esm --packages=external --outfile=dist/cli/main.js",
+    "ci": "pnpm run typecheck && pnpm run lint && pnpm run test && pnpm run build",
+    "release": "pnpm run ci && pnpm publish --access public",
+    "changeset": "changeset",
+    "cli": "tsx src/cli/main.ts",
+    "quality-tools": "pnpm run cli",
+    "boundaries": "tsx src/cli/boundaries.ts",
+    "reachability": "tsx src/cli/reachability.ts",
+    "crap": "tsx src/cli/crap.ts",
+    "mutate": "tsx src/cli/mutate.ts",
+    "scrap": "tsx src/cli/scrap.ts",
+    "organize": "tsx src/cli/organize.ts",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --config vitest.config.ts",
+    "lint": "eslint src tests",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "version-packages": "changeset version"
+  }
+}

package/stryker/quality-tools-vitest-runner.mjs

@@ -0,0 +1,83 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import semver from 'semver';
+import { createRequire } from 'node:module';
+import { INSTRUMENTER_CONSTANTS } from '@stryker-mutator/api/core';
+import { declareFactoryPlugin, PluginKind, commonTokens, tokens } from '@stryker-mutator/api/plugin';
+
+const require = createRequire(import.meta.url);
+const vitestRunnerRoot = path.dirname(require.resolve('@stryker-mutator/vitest-runner/package.json'));
+const { VitestTestRunner } = await import(path.join(vitestRunnerRoot, 'dist/src/vitest-test-runner.js'));
+const { vitestWrapper } = await import(path.join(vitestRunnerRoot, 'dist/src/vitest-wrapper.js'));
+
+const STRYKER_SETUP = path.join(vitestRunnerRoot, 'dist/src/stryker-setup.js');
+const STRYKER_SETUP_SOURCE_MAP = 'stryker-setup.js.map';
+
+function createStrykerSetupSourceMap(setupFilePath) {
+  return JSON.stringify({
+    version: 3,
+    file: path.basename(setupFilePath),
+    sources: [],
+    names: [],
+    mappings: '',
+  });
+}
+
+class QualityToolsVitestTestRunner extends VitestTestRunner {
+  async init() {
+    this.setEnv();
+    await fs.promises.copyFile(STRYKER_SETUP, this.localSetupFile);
+    await fs.promises.writeFile(
+      path.resolve(path.dirname(this.localSetupFile), STRYKER_SETUP_SOURCE_MAP),
+      createStrykerSetupSourceMap(this.localSetupFile),
+    );
+
+    this.ctx = await vitestWrapper.createVitest('test', {
+      config: this.options.vitest?.configFile,
+      pool: 'forks',
+      coverage: { enabled: false },
+      watch: false,
+      dir: this.options.vitest?.dir,
+      bail: this.options.disableBail ? 0 : 1,
+      onConsoleLog: () => false,
+    });
+    this.ctx.provide('globalNamespace', this.globalNamespace);
+    this.ctx.provide(
+      'isGreaterThanVitest4Point1',
+      semver.satisfies(vitestWrapper.version, '>=4.1.0'),
+    );
+    this.ctx.config.browser.screenshotFailures = false;
+    this.ctx.projects.forEach((project) => {
+      project.config.setupFiles = [
+        this.localSetupFile,
+        ...project.config.setupFiles,
+      ];
+      project.config.browser.screenshotFailures = false;
+    });
+    if (this.log.isDebugEnabled()) {
+      this.log.debug(`vitest final config: ${JSON.stringify(this.ctx.config, null, 2)}`);
+    }
+  }
+}
+
+function createQualityToolsVitestTestRunnerFactory(
+  namespace = INSTRUMENTER_CONSTANTS.NAMESPACE,
+) {
+  createQualityToolsVitestTestRunner.inject = tokens(commonTokens.injector);
+  function createQualityToolsVitestTestRunner(injector) {
+    return injector
+      .provideValue('globalNamespace', namespace)
+      .injectClass(QualityToolsVitestTestRunner);
+  }
+  return createQualityToolsVitestTestRunner;
+}
+
+export const qualityToolsVitestTestRunnerFactory = createQualityToolsVitestTestRunnerFactory();
+
+export const strykerPlugins = [
+  declareFactoryPlugin(
+    PluginKind.TestRunner,
+    'quality-tools-vitest',
+    qualityToolsVitestTestRunnerFactory,
+  ),
+];

package/stryker.config.cjs

@@ -0,0 +1,65 @@
+const path = require('node:path');
+
+const packageRoot = __dirname;
+const hostRoot = process.cwd();
+const vitestConfig = process.env.QUALITY_TOOLS_VITEST_CONFIG ?? 'vitest.config.ts';
+const vitestDir = process.env.QUALITY_TOOLS_VITEST_DIR;
+const reportsDir = process.env.QUALITY_TOOLS_REPORTS_DIR ?? 'reports/quality-tools';
+const mutationReportsDir = path.join(reportsDir, 'mutation');
+const numberFromEnv = (name, fallback) => {
+  const rawValue = process.env[name];
+  if (!rawValue) {
+    return fallback;
+  }
+  const parsed = Number(rawValue);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+};
+
+module.exports = {
+  $schema: 'https://raw.githubusercontent.com/stryker-mutator/stryker-js/master/packages/core/schema/stryker-core.schema.json',
+  packageManager: process.env.QUALITY_TOOLS_PACKAGE_MANAGER ?? 'pnpm',
+  testRunner: 'quality-tools-vitest',
+  plugins: [
+    path.join(packageRoot, 'stryker/quality-tools-vitest-runner.mjs'),
+    '@stryker-mutator/vitest-runner',
+  ],
+  vitest: {
+    configFile: path.isAbsolute(vitestConfig) ? vitestConfig : path.join(hostRoot, vitestConfig),
+    dir: vitestDir,
+    related: false,
+  },
+  reporters: [
+    'progress',
+    'clear-text',
+    'json',
+    'html',
+  ],
+  jsonReporter: {
+    fileName: path.join(mutationReportsDir, 'mutation.json'),
+  },
+  htmlReporter: {
+    fileName: path.join(mutationReportsDir, 'mutation.html'),
+  },
+  concurrency: numberFromEnv('QUALITY_TOOLS_STRYKER_CONCURRENCY', 2),
+  coverageAnalysis: 'perTest',
+  maxTestRunnerReuse: numberFromEnv('QUALITY_TOOLS_STRYKER_MAX_TEST_RUNNER_REUSE', 0),
+  testRunnerNodeArgs: [
+    '--max-old-space-size=8192',
+  ],
+  dryRunTimeoutMinutes: 30,
+  incremental: true,
+  incrementalFile: path.join(mutationReportsDir, 'stryker-incremental.json'),
+  ignorePatterns: [
+    '/coverage',
+    '/.vscode-test',
+    '/.vscode-test/**',
+    '/.stryker-tmp',
+    '/.stryker-tmp/**',
+  ],
+  ignoreStatic: true,
+  thresholds: {
+    high: 90,
+    low: 80,
+    break: null,
+  },
+};