pr-checkmate 1.22.7 → 1.22.8

package/dist/config/constants.d.ts

@@ -1,5 +1,20 @@
 /**
- * Common patterns to ignore in all checks
+ * Build output, dependency, tooling, and report directories that are never
+ * product code. Every check excludes them by directory-name segment match (see
+ * `targets.ts`): a match on any segment of a path drops the file. Untracked
+ * build dirs are already excluded because checks read git-tracked files only —
+ * this list additionally covers dirs that repos commonly *commit* (`.github`,
+ * `.vscode`, `.idea`, `.claude`) and any checked-in build artifacts.
+ *
+ * Covers the common ecosystems: Node/JS/web, Python, Java/Kotlin/Gradle/Android,
+ * Swift/iOS/Xcode, and C/C++/CMake. Add more here.
+ */
+export declare const IGNORED_DIRS: string[];
+/**
+ * Glob form of the ignore list, for tools that take glob ignores directly
+ * (ESLint `--ignore-pattern`, cspell `--exclude`, the generated
+ * `.prettierignore`). Combines {@link IGNORED_DIRS} with a few tool-specific
+ * nested report globs that are not plain directory names.
  */
 export declare const IGNORE_PATTERNS: string[];
 /**

package/dist/config/constants.js

@@ -3,57 +3,109 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONFIG_FILE = exports.documentation = exports.DEFAULT_ALLOW_PACKAGES = exports.DEFAULT_COMMANDS = exports.SOURCE_EXTENSIONS = exports.DUPLICATE_CODE_FORMATS = exports.CONFIG_FILE_PATTERNS = exports.DEAD_CODE_IGNORE_DEFAULTS = exports.DUPLICATE_IGNORE_DEFAULTS = exports.IGNORE_PATTERNS = void 0;
+exports.CONFIG_FILE = exports.documentation = exports.DEFAULT_ALLOW_PACKAGES = exports.DEFAULT_COMMANDS = exports.SOURCE_EXTENSIONS = exports.DUPLICATE_CODE_FORMATS = exports.CONFIG_FILE_PATTERNS = exports.DEAD_CODE_IGNORE_DEFAULTS = exports.DUPLICATE_IGNORE_DEFAULTS = exports.IGNORE_PATTERNS = exports.IGNORED_DIRS = void 0;
 const node_path_1 = __importDefault(require("node:path"));
 /**
- * Common patterns to ignore in all checks
+ * Build output, dependency, tooling, and report directories that are never
+ * product code. Every check excludes them by directory-name segment match (see
+ * `targets.ts`): a match on any segment of a path drops the file. Untracked
+ * build dirs are already excluded because checks read git-tracked files only —
+ * this list additionally covers dirs that repos commonly *commit* (`.github`,
+ * `.vscode`, `.idea`, `.claude`) and any checked-in build artifacts.
+ *
+ * Covers the common ecosystems: Node/JS/web, Python, Java/Kotlin/Gradle/Android,
+ * Swift/iOS/Xcode, and C/C++/CMake. Add more here.
+ */
+exports.IGNORED_DIRS = [
+    // VCS, editors, and CI/tooling config
+    '.git',
+    '.github',
+    '.gitlab',
+    '.vscode',
+    '.vs',
+    '.idea',
+    '.claude',
+    '.cursor',
+    '.husky',
+    '.circleci',
+    // Node / JS / web — build output & caches
+    'node_modules',
+    'dist',
+    'build',
+    'build-release',
+    'out',
+    'coverage',
+    '.next',
+    '.nuxt',
+    '.svelte-kit',
+    '.turbo',
+    '.cache',
+    '.parcel-cache',
+    '.vercel',
+    '.wrangler',
+    '.serverless',
+    '.terraform',
+    // Python
+    '__pycache__',
+    '.pytest_cache',
+    '.mypy_cache',
+    '.ruff_cache',
+    '.tox',
+    '.venv',
+    'venv',
+    '.eggs',
+    'htmlcov',
+    // Java / Kotlin / Gradle / Android
+    '.gradle',
+    '.kotlin',
+    'target',
+    'gen',
+    'captures',
+    // Swift / iOS / Xcode
+    '.build',
+    '.swiftpm',
+    'DerivedData',
+    'Pods',
+    'Carthage',
+    // C / C++ / CMake
+    'CMakeFiles',
+    'cmake-build-debug',
+    'cmake-build-release',
+    '_deps',
+    // Test reports / results / logs / release artifacts
+    'reports',
+    'report',
+    'test-reports',
+    'test-report',
+    'test-output',
+    'test-results',
+    'results',
+    'result',
+    'logs',
+    'allure-report',
+    'allure-results',
+    'playwright-report',
+    '.wdio',
+];
+/**
+ * Glob form of the ignore list, for tools that take glob ignores directly
+ * (ESLint `--ignore-pattern`, cspell `--exclude`, the generated
+ * `.prettierignore`). Combines {@link IGNORED_DIRS} with a few tool-specific
+ * nested report globs that are not plain directory names.
  */
 exports.IGNORE_PATTERNS = [
-    '**/node_modules/**',
-    '**/dist/**',
-    '**/.git/**',
-    '**/build/**',
-    '**/coverage/**',
-    '**/.next/**',
-    '**/.nuxt/**',
-    '**/out/**',
-    '**/__pycache__/**',
-    '**/.pytest_cache/**',
-    '**/.venv/**',
-    '**/venv/**',
-    '**/allure-report/**',
-    '**/allure-results/**',
-    '**/reports/**',
-    '**/report/**',
-    '**/test-reports/**',
-    '**/test-report/**',
-    '**/test-output/**',
-    '**/test-results/**',
-    '**/results/**',
-    '**/result/**',
-    '**/logs/**',
-    // Jest
+    ...exports.IGNORED_DIRS.map(dir => `**/${dir}/**`),
+    // Tool-specific nested report dirs / files (not bare directory names)
     '**/jest-html-reporters-*/**',
     '**/jest-stare/**',
-    // Cypress
     '**/cypress/reports/**',
     '**/cypress/videos/**',
     '**/cypress/screenshots/**',
-    // Playwright
-    '**/playwright-report/**',
-    // WebdriverIO
-    '**/.wdio/**',
-    '**/wdio-logs/**',
-    // Mocha / Jasmine
     '**/mochawesome-report/**',
     '**/mochawesome-reports/**',
-    // JUnit / Surefire / Maven
     '**/target/surefire-reports/**',
     '**/target/failsafe-reports/**',
-    // Python testing
-    '**/.pytest_cache/**',
-    '**/htmlcov/**',
-    // Misc reports
+    '**/wdio-logs/**',
     '**/lint-report/**',
     '**/audit-report/**',
 ];

package/dist/config/index.d.ts

@@ -1,10 +1,23 @@
 export * from './constants';
 export { loadProjectConfig } from '../config/loader';
 /**
- * Get SOURCE_PATH dynamically
- * This ensures fresh config is always read
+ * Get the configured source path(s) dynamically as a normalized list.
+ * Accepts a single string or an array in pr-checkmate.json; empty/invalid
+ * values fall back to `['.']` (the whole repo). Clients narrow scanning to a
+ * subdirectory by setting `sourcePath` in their pr-checkmate.json. Always reads
+ * fresh config.
+ */
+export declare function getSourcePaths(): string[];
+/**
+ * Get a single source path (first configured entry) for callers that only
+ * support one directory. Prefer `getSourcePaths()` for scan targets.
  */
 export declare function getSourcePath(): string;
+/**
+ * Get the effective list of directory names excluded from every check
+ * (client `ignoreDirs` in pr-checkmate.json, or the curated default).
+ */
+export declare function getIgnoredDirs(): string[];
 /**
  * Get path to package config files
  */

package/dist/config/index.js

@@ -18,16 +18,19 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadProjectConfig = void 0;
+exports.getSourcePaths = getSourcePaths;
 exports.getSourcePath = getSourcePath;
+exports.getIgnoredDirs = getIgnoredDirs;
 exports.getPackageConfigPath = getPackageConfigPath;
 exports.hasLocalConfig = hasLocalConfig;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
+const loader_1 = require("../config/loader");
 const utils_1 = require("../utils");
 const constants_1 = require("./constants");
 __exportStar(require("./constants"), exports);
-var loader_1 = require("../config/loader");
-Object.defineProperty(exports, "loadProjectConfig", { enumerable: true, get: function () { return loader_1.loadProjectConfig; } });
+var loader_2 = require("../config/loader");
+Object.defineProperty(exports, "loadProjectConfig", { enumerable: true, get: function () { return loader_2.loadProjectConfig; } });
 /**
  * Load configuration dynamically (always reads fresh config)
  */
@@ -41,15 +44,33 @@ function loadConfig() {
     catch (err) {
         utils_1.logger.warn(`⚠️ Failed to read config from ${constants_1.CONFIG_FILE}, using defaults${err}`);
     }
-    return { sourcePath: 'src' };
+    return { sourcePath: '.' };
 }
 /**
- * Get SOURCE_PATH dynamically
- * This ensures fresh config is always read
+ * Get the configured source path(s) dynamically as a normalized list.
+ * Accepts a single string or an array in pr-checkmate.json; empty/invalid
+ * values fall back to `['.']` (the whole repo). Clients narrow scanning to a
+ * subdirectory by setting `sourcePath` in their pr-checkmate.json. Always reads
+ * fresh config.
+ */
+function getSourcePaths() {
+    const { sourcePath } = loadConfig();
+    const paths = (Array.isArray(sourcePath) ? sourcePath : [sourcePath]).filter((p) => typeof p === 'string' && p.trim().length > 0);
+    return paths.length > 0 ? paths : ['.'];
+}
+/**
+ * Get a single source path (first configured entry) for callers that only
+ * support one directory. Prefer `getSourcePaths()` for scan targets.
  */
 function getSourcePath() {
-    const config = loadConfig();
-    return config.sourcePath;
+    return getSourcePaths()[0];
+}
+/**
+ * Get the effective list of directory names excluded from every check
+ * (client `ignoreDirs` in pr-checkmate.json, or the curated default).
+ */
+function getIgnoredDirs() {
+    return (0, loader_1.loadProjectConfig)().ignoreDirs ?? [];
 }
 /**
  * Get path to package config files

package/dist/config/loader.js

@@ -34,6 +34,9 @@ function mergeWithDefaults(userConfig) {
     const defaults = getDefaultConfig();
     return {
         sourcePath: userConfig.sourcePath || defaults.sourcePath,
+        // Replace (not merge): the client sees the full default list in their
+        // generated config and edits it directly, so their list is authoritative.
+        ignoreDirs: userConfig.ignoreDirs ?? defaults.ignoreDirs,
         lint: {
             rules: { ...defaults.lint?.rules, ...userConfig.lint?.rules },
             ignorePatterns: [
@@ -90,7 +93,8 @@ function mergeWithDefaults(userConfig) {
  */
 function getDefaultConfig() {
     return {
-        sourcePath: 'src',
+        sourcePath: '.',
+        ignoreDirs: [...constants_1.IGNORED_DIRS],
         lint: {
             rules: {
                 'no-console': 'warn',

package/dist/core/checks/circular-deps.js

@@ -1,13 +1,10 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.circularDepsCheck = void 0;
-const node_path_1 = __importDefault(require("node:path"));
 const config_1 = require("../../config");
 const utils_1 = require("../../utils");
 const execa_1 = require("../../utils/execa");
+const targets_1 = require("../targets");
 const types_1 = require("../types");
 exports.circularDepsCheck = {
     name: 'Circular Deps',
@@ -16,8 +13,10 @@ exports.circularDepsCheck = {
         return ctx.languages.includes('typescript') || ctx.languages.includes('javascript');
     },
     async run(ctx) {
-        const pattern = node_path_1.default.join(ctx.cwd, (0, config_1.getSourcePath)(), '**/*.{ts,tsx,js,jsx}');
-        const result = await (0, execa_1.execa)('npx', ['dpdm', '--no-warning', '--no-tree', '--circular', pattern], {
+        const files = await (0, targets_1.listTrackedFiles)(ctx, ['*.ts', '*.tsx', '*.js', '*.jsx'], (0, config_1.getSourcePaths)());
+        if (files.length === 0)
+            return (0, types_1.pass)();
+        const result = await (0, execa_1.execa)('npx', ['dpdm', '--no-warning', '--no-tree', '--circular', ...files], {
             cwd: ctx.cwd,
             reject: false,
         });

package/dist/core/checks/duplicate-check.js

@@ -1,15 +1,11 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.duplicateCheck = void 0;
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
+const config_1 = require("../../config");
 const constants_1 = require("../../config/constants");
 const utils_1 = require("../../utils");
-const delta_1 = require("../../utils/delta");
 const execa_1 = require("../../utils/execa");
+const targets_1 = require("../targets");
 const types_1 = require("../types");
 // Always excluded regardless of client config — scanning these never yields
 // meaningful production duplication. Config files (eslint/*.config.*) are data,
@@ -44,11 +40,11 @@ exports.duplicateCheck = {
     async run(ctx) {
         const minLines = ctx.config.duplicate?.minLines ?? 5;
         const minTokens = ctx.config.duplicate?.minTokens ?? 50;
-        const changedFiles = await (0, delta_1.getChangedFiles)(['.ts', '.tsx', '.js', '.jsx']);
-        if (changedFiles !== null && changedFiles.length === 0)
-            return (0, types_1.skip)('no relevant files changed');
-        const srcPath = node_path_1.default.join(ctx.cwd, 'src');
-        const targetPaths = changedFiles ?? (node_fs_1.default.existsSync(srcPath) ? [srcPath] : [ctx.cwd]);
+        const targetPaths = await (0, targets_1.resolveScopedTargetFiles)(ctx, ['*.ts', '*.tsx', '*.js', '*.jsx'], (0, config_1.getSourcePaths)());
+        if (targetPaths === null)
+            return (0, types_1.skip)('git unavailable');
+        if (targetPaths.length === 0)
+            return (0, types_1.skip)('no relevant files');
         const jscpdBin = (0, utils_1.resolvePackageBin)('jscpd', 'run-jscpd.js');
         // Client-configurable exclusions (pr-checkmate.json `duplicate.ignore`),
         // defaulting to test files/folders, appended to the always-on base ignores.

package/dist/core/checks/lint.js

@@ -1,15 +1,24 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.lintCheck = void 0;
-const node_path_1 = __importDefault(require("node:path"));
 const config_1 = require("../../config");
 const utils_1 = require("../../utils");
-const delta_1 = require("../../utils/delta");
 const execa_1 = require("../../utils/execa");
+const targets_1 = require("../targets");
 const types_1 = require("../types");
+/**
+ * Resolve the ESLint binary, preferring the consumer project's own copy so a
+ * repo pinned to ESLint 8 (+ legacy `.eslintrc.*`) keeps working. Falls back to
+ * the version bundled with pr-checkmate when the project has no local install.
+ */
+function resolveESLintBin(cwd) {
+    try {
+        return (0, utils_1.resolvePackageBin)('eslint', 'bin/eslint.js', { paths: [cwd] });
+    }
+    catch {
+        return (0, utils_1.resolvePackageBin)('eslint', 'bin/eslint.js');
+    }
+}
 async function getESLintMajorVersion(eslintBin) {
     try {
         const { stdout } = await (0, execa_1.execa)(process.execPath, [eslintBin, '--version']);
@@ -27,10 +36,12 @@ exports.lintCheck = {
         return ctx.languages.includes('typescript') || ctx.languages.includes('javascript');
     },
     async run(ctx) {
-        const eslintBin = (0, utils_1.resolvePackageBin)('eslint', 'bin/eslint.js');
-        const sourcePath = (0, config_1.getSourcePath)();
-        const changedFiles = await (0, delta_1.getChangedFiles)(['.ts', '.tsx', '.js', '.jsx']);
-        const targets = changedFiles ?? [node_path_1.default.join(ctx.cwd, sourcePath)];
+        const eslintBin = resolveESLintBin(ctx.cwd);
+        const targets = await (0, targets_1.resolveScopedTargetFiles)(ctx, ['*.ts', '*.tsx', '*.js', '*.jsx'], (0, config_1.getSourcePaths)());
+        if (targets === null)
+            return (0, types_1.skip)('git unavailable');
+        if (targets.length === 0)
+            return (0, types_1.pass)('no TypeScript/JavaScript files to lint');
         const hasLocal = (0, config_1.hasLocalConfig)([
             'eslint.config.mjs',
             'eslint.config.js',
@@ -50,7 +61,7 @@ exports.lintCheck = {
         if (ctx.write)
             args.push('--fix');
         if (hasLocal) {
-            utils_1.logger.info(`[ESLint]: Using local config (checking: ${sourcePath})`);
+            utils_1.logger.info(`[ESLint]: Using local config (${targets.length} file(s))`);
         }
         else {
             const configFile = version >= 9 ? 'eslint.config.mjs' : '.eslintrc.js';

package/dist/core/checks/markdown-lint.js

@@ -9,8 +9,8 @@ const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
 const config_1 = require("../../config");
 const utils_1 = require("../../utils");
-const delta_1 = require("../../utils/delta");
 const execa_1 = require("../../utils/execa");
+const targets_1 = require("../targets");
 const types_1 = require("../types");
 function loadUserMarkdownConfig(cwd) {
     const configPath = node_path_1.default.join(cwd, 'pr-checkmate.json');
@@ -31,21 +31,6 @@ function buildMergedConfig(bundledConfigPath, userRules) {
     node_fs_1.default.writeFileSync(tmpFile, JSON.stringify(merged, null, 2));
     return tmpFile;
 }
-async function resolveTargets(cwd) {
-    const changedFiles = await (0, delta_1.getChangedFiles)(['.md', '.mdx']);
-    if (changedFiles !== null)
-        return changedFiles;
-    try {
-        const { stdout } = await (0, execa_1.execa)('git', ['ls-files', '*.md', '**/*.md'], { cwd, reject: false });
-        return stdout
-            .split('\n')
-            .map(f => f.trim())
-            .filter(f => f.endsWith('.md'));
-    }
-    catch {
-        return [`${cwd}/**/*.md`];
-    }
-}
 exports.markdownLintCheck = {
     name: 'Markdown',
     phase: 'informational',
@@ -53,7 +38,9 @@ exports.markdownLintCheck = {
         return true;
     },
     async run(ctx) {
-        const targets = await resolveTargets(ctx.cwd);
+        const targets = await (0, targets_1.resolveTargetFiles)(ctx, ['*.md', '*.mdx']);
+        if (targets === null)
+            return (0, types_1.skip)('git unavailable');
         if (targets.length === 0)
             return (0, types_1.skip)('no markdown files');
         const userConfig = loadUserMarkdownConfig(ctx.cwd);

package/dist/core/checks/prettier.js

@@ -8,8 +8,8 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const config_1 = require("../../config");
 const utils_1 = require("../../utils");
-const delta_1 = require("../../utils/delta");
 const execa_1 = require("../../utils/execa");
+const targets_1 = require("../targets");
 const types_1 = require("../types");
 function loadUserPrettierConfig(cwd) {
     const configPath = node_path_1.default.join(cwd, 'pr-checkmate.json');
@@ -42,11 +42,11 @@ exports.prettierCheck = {
         return ctx.languages.includes('typescript') || ctx.languages.includes('javascript');
     },
     async run(ctx) {
-        const sourcePath = (0, config_1.getSourcePath)();
-        const changedFiles = await (0, delta_1.getChangedFiles)(['.ts', '.tsx', '.js', '.jsx', '.json', '.md']);
-        const targets = changedFiles ?? [
-            `${node_path_1.default.join(ctx.cwd, sourcePath)}/**/*.{ts,tsx,js,jsx,json,md}`,
-        ];
+        const targets = await (0, targets_1.resolveScopedTargetFiles)(ctx, ['*.ts', '*.tsx', '*.js', '*.jsx', '*.json', '*.md'], (0, config_1.getSourcePaths)());
+        if (targets === null)
+            return (0, types_1.skip)('git unavailable');
+        if (targets.length === 0)
+            return (0, types_1.pass)('no files to format');
         const projectIgnore = node_path_1.default.join(ctx.cwd, '.prettierignore');
         const gitignore = node_path_1.default.join(ctx.cwd, '.gitignore');
         let tempIgnore = null;

package/dist/core/checks/spellcheck.js

@@ -8,8 +8,8 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const config_1 = require("../../config");
 const utils_1 = require("../../utils");
-const delta_1 = require("../../utils/delta");
 const execa_1 = require("../../utils/execa");
+const targets_1 = require("../targets");
 const types_1 = require("../types");
 function loadUserCspellConfig(cwd) {
     const configPath = node_path_1.default.join(cwd, 'pr-checkmate.json');
@@ -57,20 +57,12 @@ exports.spellcheckCheck = {
         return true;
     },
     async run(ctx) {
-        const sourcePath = (0, config_1.getSourcePath)();
-        const changedFiles = await (0, delta_1.getChangedFiles)([
-            '.ts',
-            '.tsx',
-            '.js',
-            '.jsx',
-            '.md',
-            '.mdx',
-            '.json',
-        ]);
-        const patterns = changedFiles ?? [
-            node_path_1.default.join(ctx.cwd, sourcePath, '**/*.{ts,tsx,js,jsx,md,mdx,json}'),
-            ...config_1.IGNORE_PATTERNS.map(p => `--exclude=${p}`),
-        ];
+        const files = await (0, targets_1.resolveScopedTargetFiles)(ctx, ['*.ts', '*.tsx', '*.js', '*.jsx', '*.md', '*.mdx', '*.json'], (0, config_1.getSourcePaths)());
+        if (files === null)
+            return (0, types_1.skip)('git unavailable');
+        if (files.length === 0)
+            return (0, types_1.pass)('no files to spellcheck');
+        const patterns = [...files, ...config_1.IGNORE_PATTERNS.map(p => `--exclude=${p}`)];
         const hasLocal = (0, config_1.hasLocalConfig)(['cspell.json', '.cspell.json', 'cspell.config.json']);
         let tempConfigPath = null;
         const cspellBin = (0, utils_1.resolvePackageBin)('cspell', 'bin.mjs');

package/dist/core/context.js

@@ -1,6 +1,10 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildContext = buildContext;
+const node_fs_1 = __importDefault(require("node:fs"));
 const loader_1 = require("../config/loader");
 const utils_1 = require("../utils");
 const detect_language_1 = require("../utils/detect-language");
@@ -10,6 +14,21 @@ const execa_1 = require("../utils/execa");
  * Prefers explicit opts, then GitHub PR event, then Bitbucket PR env, then git HEAD^.
  * Returns undefined SHAs when nothing usable is found → checks fall back to full scan.
  */
+/**
+ * Resolve a git ref to a concrete commit SHA, or undefined when it can't be
+ * resolved in this clone. `--verify --quiet` emits nothing (instead of echoing
+ * the literal ref) and exits non-zero for a missing ref — e.g. `HEAD^` on a
+ * single-commit repo, or a base branch not fetched in a shallow CI clone. That
+ * way an unresolvable base yields `undefined` and callers fall back to a full
+ * scan, rather than diffing against a garbage ref and silently checking nothing.
+ */
+async function resolveRef(cwd, ref) {
+    const { stdout } = await (0, execa_1.execa)('git', ['rev-parse', '--verify', '--quiet', `${ref}^{commit}`], {
+        cwd,
+        reject: false,
+    });
+    return stdout.trim() || undefined;
+}
 async function resolveDiffRange(cwd, opts) {
     if (opts.baseSha || opts.headSha) {
         return { baseSha: opts.baseSha, headSha: opts.headSha };
@@ -22,17 +41,28 @@ async function resolveDiffRange(cwd, opts) {
     catch {
         return {};
     }
-    // Bitbucket exposes the PR destination branch; GitHub delta is handled by utils/delta.
-    const bitbucketTarget = process.env.BITBUCKET_PR_DESTINATION_BRANCH;
-    try {
-        const ref = bitbucketTarget ? `origin/${bitbucketTarget}` : 'HEAD^';
-        const { stdout } = await (0, execa_1.execa)('git', ['rev-parse', ref], { cwd, reject: false });
-        const baseSha = stdout.trim();
-        return { baseSha: baseSha || undefined, headSha };
-    }
-    catch {
-        return { headSha };
+    // GitHub Actions: the PR event payload carries the base branch SHA. Read it
+    // directly so delta works without relying on any client-set variable
+    // (GITHUB_EVENT_* are injected by the runner).
+    if (process.env.GITHUB_EVENT_NAME === 'pull_request' && process.env.GITHUB_EVENT_PATH) {
+        try {
+            const event = JSON.parse(node_fs_1.default.readFileSync(process.env.GITHUB_EVENT_PATH, 'utf-8'));
+            const eventBase = event?.pull_request?.base?.sha;
+            // Only use it if the commit is actually present in this clone; otherwise
+            // fall through so a shallow clone degrades to a full scan, not 0 files.
+            const baseSha = eventBase ? await resolveRef(cwd, eventBase) : undefined;
+            if (baseSha)
+                return { baseSha, headSha };
+        }
+        catch {
+            // Malformed/unreadable event — fall through to the git-based resolution.
+        }
     }
+    // Bitbucket exposes the PR destination branch as an env var (also runner-set).
+    const bitbucketTarget = process.env.BITBUCKET_PR_DESTINATION_BRANCH;
+    const ref = bitbucketTarget ? `origin/${bitbucketTarget}` : 'HEAD^';
+    const baseSha = await resolveRef(cwd, ref);
+    return { baseSha, headSha };
 }
 /**
  * Assemble the shared CheckContext once per run. Language detection is skipped

package/dist/core/targets.d.ts

@@ -9,3 +9,16 @@ import type { CheckContext } from './types';
  * excluded, so every returned path exists on disk and is safe to read.
  */
 export declare function resolveTargetFiles(ctx: CheckContext, globs: string[]): Promise<string[] | null>;
+/**
+ * Like {@link resolveTargetFiles} but restricts results to the configured
+ * `sourcePath`(s). Preserves the semantics of the old `sourcePath` full-scan
+ * fallback while gaining delta support on every platform via `ctx.baseSha`.
+ */
+export declare function resolveScopedTargetFiles(ctx: CheckContext, globs: string[], sourcePaths: string[]): Promise<string[] | null>;
+/**
+ * List ALL tracked files matching `globs` (never delta), scoped to
+ * `sourcePath`(s). For whole-repo analyses like circular-dependency detection
+ * that need the full graph, not just the PR diff. Using `git ls-files` means
+ * untracked `node_modules` is excluded by construction.
+ */
+export declare function listTrackedFiles(ctx: CheckContext, globs: string[], sourcePaths: string[]): Promise<string[]>;

package/dist/core/targets.js

@@ -1,8 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveTargetFiles = resolveTargetFiles;
+exports.resolveScopedTargetFiles = resolveScopedTargetFiles;
+exports.listTrackedFiles = listTrackedFiles;
+const config_1 = require("../config");
 const utils_1 = require("../utils");
 const execa_1 = require("../utils/execa");
+/**
+ * Drop files that live under any excluded directory (client `ignoreDirs` or the
+ * curated default), matched on any path segment so nesting depth doesn't matter.
+ * Applied to every check's file list so build/tooling/report dirs are never
+ * scanned, even when committed.
+ */
+function excludeIgnoredDirs(files) {
+    const ignored = new Set((0, config_1.getIgnoredDirs)());
+    if (ignored.size === 0)
+        return files;
+    return files.filter(f => !f.split('/').some(segment => ignored.has(segment)));
+}
 /**
  * Lists the files a language check should operate on, matched by pathspec `globs`
  * (e.g. `['*.py']`). Uses the PR diff range when available (delta mode), else
@@ -26,10 +41,10 @@ async function resolveTargetFiles(ctx, globs) {
             ]
             : ['ls-files', ...globs];
         const { stdout } = await (0, execa_1.execa)('git', args, { cwd: ctx.cwd, reject: false });
-        const files = stdout
+        const files = excludeIgnoredDirs(stdout
             .split('\n')
             .map(f => f.trim())
-            .filter(Boolean);
+            .filter(Boolean));
         utils_1.logger.info(`[targets]: ${ctx.baseSha ? '📂 Delta' : 'Full scan'}: ${files.length} file(s) for ${globs.join(', ')}`);
         return files;
     }
@@ -38,3 +53,45 @@ async function resolveTargetFiles(ctx, globs) {
         return null;
     }
 }
+/**
+ * Restrict a list of repo-relative paths to the configured `sourcePath`(s).
+ * A source path of `.` (or one that normalizes to empty) imposes no
+ * restriction, so the whole repo is considered.
+ */
+function scopeToSourcePaths(files, sourcePaths) {
+    const scopes = sourcePaths.map(p => p.replace(/^\.\/?/, '').replace(/\/+$/, '')).filter(Boolean);
+    if (scopes.length === 0)
+        return files;
+    return files.filter(f => scopes.some(s => f === s || f.startsWith(`${s}/`)));
+}
+/**
+ * Like {@link resolveTargetFiles} but restricts results to the configured
+ * `sourcePath`(s). Preserves the semantics of the old `sourcePath` full-scan
+ * fallback while gaining delta support on every platform via `ctx.baseSha`.
+ */
+async function resolveScopedTargetFiles(ctx, globs, sourcePaths) {
+    const files = await resolveTargetFiles(ctx, globs);
+    if (files === null)
+        return null;
+    return scopeToSourcePaths(files, sourcePaths);
+}
+/**
+ * List ALL tracked files matching `globs` (never delta), scoped to
+ * `sourcePath`(s). For whole-repo analyses like circular-dependency detection
+ * that need the full graph, not just the PR diff. Using `git ls-files` means
+ * untracked `node_modules` is excluded by construction.
+ */
+async function listTrackedFiles(ctx, globs, sourcePaths) {
+    try {
+        const { stdout } = await (0, execa_1.execa)('git', ['ls-files', ...globs], { cwd: ctx.cwd, reject: false });
+        const files = excludeIgnoredDirs(stdout
+            .split('\n')
+            .map(f => f.trim())
+            .filter(Boolean));
+        return scopeToSourcePaths(files, sourcePaths);
+    }
+    catch (err) {
+        utils_1.logger.warn(`[targets]: ⚠️ Could not list tracked files\n${err}`);
+        return [];
+    }
+}

package/dist/index.d.ts

@@ -6,5 +6,5 @@
 export { runChecks, buildContext, REGISTRY } from './core';
 export { pass, warn, fail, skip, defineCheck } from './core';
 export type { Check, CheckContext, CheckOutcome, CheckReport, CheckResult, CheckStatus, Language, Phase, ReporterFn, ReporterKind, RunOptions, } from './core';
-export { getSourcePath, getPackageConfigPath, hasLocalConfig } from './config';
+export { getSourcePath, getSourcePaths, getIgnoredDirs, getPackageConfigPath, hasLocalConfig, } from './config';
 export type { PRCheckMateConfig } from './interfaces';

package/dist/index.js

@@ -5,7 +5,7 @@
  * @module pr-checkmate
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasLocalConfig = exports.getPackageConfigPath = exports.getSourcePath = exports.defineCheck = exports.skip = exports.fail = exports.warn = exports.pass = exports.REGISTRY = exports.buildContext = exports.runChecks = void 0;
+exports.hasLocalConfig = exports.getPackageConfigPath = exports.getIgnoredDirs = exports.getSourcePaths = exports.getSourcePath = exports.defineCheck = exports.skip = exports.fail = exports.warn = exports.pass = exports.REGISTRY = exports.buildContext = exports.runChecks = void 0;
 // Primary programmatic API: run checks and receive a structured report.
 // Never throws for violations, never calls process.exit — the caller decides.
 var core_1 = require("./core");
@@ -22,5 +22,7 @@ Object.defineProperty(exports, "defineCheck", { enumerable: true, get: function
 // Config helpers for consumers embedding pr-checkmate.
 var config_1 = require("./config");
 Object.defineProperty(exports, "getSourcePath", { enumerable: true, get: function () { return config_1.getSourcePath; } });
+Object.defineProperty(exports, "getSourcePaths", { enumerable: true, get: function () { return config_1.getSourcePaths; } });
+Object.defineProperty(exports, "getIgnoredDirs", { enumerable: true, get: function () { return config_1.getIgnoredDirs; } });
 Object.defineProperty(exports, "getPackageConfigPath", { enumerable: true, get: function () { return config_1.getPackageConfigPath; } });
 Object.defineProperty(exports, "hasLocalConfig", { enumerable: true, get: function () { return config_1.hasLocalConfig; } });

package/dist/init.js

@@ -10,19 +10,33 @@ const inquirer_1 = __importDefault(require("inquirer"));
 const config_1 = require("./config");
 const utils_1 = require("./utils");
 const CONFIG_FILE = path_1.default.resolve(process.cwd(), 'pr-checkmate.json');
+/**
+ * Load the canonical default ESLint rules (the same set eslint.config.mjs
+ * applies) so the generated pr-checkmate.json lists every rule for the user to
+ * change or disable. Falls back to an empty object if the file is unavailable.
+ */
+function loadDefaultEslintRules() {
+    try {
+        return JSON.parse(fs_1.default.readFileSync((0, config_1.getPackageConfigPath)('eslint-default-rules.json'), 'utf-8'));
+    }
+    catch (err) {
+        utils_1.logger.warn(`[init]: ⚠️ Could not load default ESLint rules: ${err}`);
+        return {};
+    }
+}
 /**
  * Default configuration structure with customization options
  */
 const DEFAULT_CONFIG = {
-    sourcePath: 'src',
+    sourcePath: '.',
+    // Directories excluded from every check (matched on any path segment). Edit
+    // freely — add your own generated/vendored dirs or remove ones you want scanned.
+    ignoreDirs: config_1.IGNORED_DIRS,
     commands: config_1.DEFAULT_COMMANDS,
-    // ESLint customization
+    // ESLint — the full default rule set is written out so every rule is visible
+    // and editable. Change any value, or set a rule to "off" to disable it.
     eslint: {
-        rules: {
-            // Off by default: its `--fix` injects empty `/** */` JSDoc stubs into
-            // client source files. Set to 'warn'/'error' to opt into doc enforcement.
-            'jsdoc/require-jsdoc': 'off',
-        },
+        rules: loadDefaultEslintRules(),
         ignorePatterns: [],
     },
     // Prettier customization
@@ -90,7 +104,8 @@ async function promptSourcePath() {
             type: 'list',
             name: 'sourcePath',
             message: 'Where is your project source code?',
-            choices: ['src', 'app', MANUAL_ENTRY],
+            default: '.',
+            choices: [{ name: '. (entire repo — recommended)', value: '.' }, 'src', 'app', MANUAL_ENTRY],
         },
         {
             type: 'input',

package/dist/interfaces/index.d.ts

@@ -21,7 +21,8 @@ export interface CspellConfig {
     ignoreRegExpList: string[];
 }
 export interface PRCheckMateConfig {
-    sourcePath: string;
+    sourcePath: string | string[];
+    ignoreDirs?: string[];
     languages?: Language[];
     lint?: {
         rules?: Record<string, any>;

package/dist/scripts/copy-configs.js

@@ -7,7 +7,11 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const utils_1 = require("../utils");
 const configFiles = [
-    { source: 'src/config/eslint.config.mjs', dest: 'eslint.config.mjs' },
+    // Source is named so ESLint's auto-discovery does NOT treat it as a nested
+    // config for files under src/config/ — it ships to the package root as the
+    // canonical `eslint.config.mjs`.
+    { source: 'src/config/eslint-flat-config.mjs', dest: 'eslint.config.mjs' },
+    { source: 'src/config/eslint-default-rules.json', dest: 'eslint-default-rules.json' },
     { source: 'src/config/.eslintrc.js', dest: '.eslintrc.js' },
     { source: 'src/config/.prettierrc', dest: '.prettierrc' },
     { source: 'src/config/cspell.json', dest: 'cspell.json' },

package/dist/utils/index.d.ts

@@ -1,5 +1,4 @@
 export * from './logger';
-export * from './delta';
 export * from './result-collector';
 export * from './resolve-bin';
 export * from './own-deps';

package/dist/utils/index.js

@@ -21,7 +21,6 @@ exports.cleanupTempFile = cleanupTempFile;
 const node_fs_1 = __importDefault(require("node:fs"));
 const logger_1 = require("./logger");
 __exportStar(require("./logger"), exports);
-__exportStar(require("./delta"), exports);
 __exportStar(require("./result-collector"), exports);
 __exportStar(require("./resolve-bin"), exports);
 __exportStar(require("./own-deps"), exports);

package/eslint-default-rules.json

@@ -0,0 +1,62 @@
+{
+  "no-console": "warn",
+  "no-debugger": "error",
+  "prefer-const": "error",
+  "eqeqeq": ["error", "always"],
+  "@typescript-eslint/no-unused-vars": [
+    "error",
+    { "argsIgnorePattern": "^_", "varsIgnorePattern": "^_" }
+  ],
+  "@typescript-eslint/explicit-function-return-type": ["warn"],
+  "@typescript-eslint/no-explicit-any": ["warn"],
+  "@typescript-eslint/no-floating-promises": ["error"],
+  "space-before-function-paren": "off",
+  "operator-linebreak": "off",
+  "max-len": ["warn", { "code": 100 }],
+  "semi": ["error", "always"],
+  "quotes": ["error", "single", { "avoidEscape": true }],
+  "object-curly-spacing": ["error", "always"],
+  "space-infix-ops": "error",
+  "keyword-spacing": ["error", { "before": true, "after": true }],
+  "padding-line-between-statements": [
+    "error",
+    { "blankLine": "always", "prev": "block", "next": "*" },
+    { "blankLine": "always", "prev": "*", "next": "return" }
+  ],
+  "sonarjs/cognitive-complexity": ["warn", 30],
+  "sonarjs/no-duplicate-string": ["warn", { "threshold": 3 }],
+  "sonarjs/no-identical-functions": "warn",
+  "import/order": [
+    "warn",
+    {
+      "groups": ["builtin", "external", "internal", "parent", "sibling", "index"],
+      "alphabetize": { "order": "asc", "caseInsensitive": true }
+    }
+  ],
+  "import/no-duplicates": "error",
+  "jsdoc/require-jsdoc": [
+    "warn",
+    {
+      "publicOnly": true,
+      "require": {
+        "FunctionDeclaration": true,
+        "MethodDefinition": true,
+        "ClassDeclaration": true,
+        "ArrowFunctionExpression": false
+      }
+    }
+  ],
+  "jsdoc/check-param-names": "warn",
+  "jsdoc/check-tag-names": "warn",
+  "jsdoc/check-types": "warn",
+  "prettier/prettier": [
+    "error",
+    {
+      "semi": true,
+      "singleQuote": true,
+      "bracketSpacing": true,
+      "arrowParens": "avoid",
+      "printWidth": 100
+    }
+  ]
+}

package/eslint.config.mjs

@@ -1,4 +1,5 @@
 import fs from 'fs';
+import { createRequire } from 'module';
 import path from 'path';
 import tsPlugin from '@typescript-eslint/eslint-plugin';
 import tsParser from '@typescript-eslint/parser';
@@ -8,73 +9,12 @@ import importPlugin from 'eslint-plugin-import-x';
 import jsdocPlugin from 'eslint-plugin-jsdoc';
 
 /**
- * Default ESLint rules - can be exported for use in init.ts
+ * Default ESLint rules — single source of truth, shared with init.ts so the
+ * pr-checkmate.json it generates lists exactly the rules applied here. Edit the
+ * rules in `eslint-default-rules.json` (shipped alongside this file).
  */
-export const defaultRules = {
-  'no-console': 'warn',
-  'no-debugger': 'error',
-  'prefer-const': 'error',
-  'eqeqeq': ['error', 'always'],
-  '@typescript-eslint/no-unused-vars': [
-    'error',
-    { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
-  ],
-  '@typescript-eslint/explicit-function-return-type': ['warn'],
-  '@typescript-eslint/no-explicit-any': ['warn'],
-  '@typescript-eslint/no-floating-promises': ['error'],
-  'space-before-function-paren': 'off',
-  'operator-linebreak': 'off',
-  'max-len': ['warn', { code: 100 }],
-  'semi': ['error', 'always'],
-  'quotes': ['error', 'single', { avoidEscape: true }],
-  'object-curly-spacing': ['error', 'always'],
-  'space-infix-ops': 'error',
-  'keyword-spacing': ['error', { before: true, after: true }],
-  'padding-line-between-statements': [
-    'error',
-    { blankLine: 'always', prev: 'block', next: '*' },
-    { blankLine: 'always', prev: '*', next: 'return' },
-  ],
-  // Complexity analysis (#61)
-  'sonarjs/cognitive-complexity': ['warn', 30],
-  'sonarjs/no-duplicate-string': ['warn', { threshold: 3 }],
-  'sonarjs/no-identical-functions': 'warn',
-  // Import ordering (#65)
-  'import/order': [
-    'warn',
-    {
-      groups: ['builtin', 'external', 'internal', 'parent', 'sibling', 'index'],
-      alphabetize: { order: 'asc', caseInsensitive: true },
-    },
-  ],
-  'import/no-duplicates': 'error',
-  // Documentation (#62)
-  'jsdoc/require-jsdoc': [
-    'warn',
-    {
-      publicOnly: true,
-      require: {
-        FunctionDeclaration: true,
-        MethodDefinition: true,
-        ClassDeclaration: true,
-        ArrowFunctionExpression: false,
-      },
-    },
-  ],
-  'jsdoc/check-param-names': 'warn',
-  'jsdoc/check-tag-names': 'warn',
-  'jsdoc/check-types': 'warn',
-  'prettier/prettier': [
-    'error',
-    {
-      semi: true,
-      singleQuote: true,
-      bracketSpacing: true,
-      arrowParens: 'avoid',
-      printWidth: 100,
-    },
-  ],
-};
+const require = createRequire(import.meta.url);
+export const defaultRules = require('./eslint-default-rules.json');
 
 /**
  * Default ignore patterns

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pr-checkmate",
-    "version": "1.22.7",
+    "version": "1.22.8",
     "description": "Automated PR quality checks: linting, formatting, dependency analysis, and spellcheck",
     "keywords": [
         "github-actions",
@@ -29,6 +29,7 @@
         "README.md",
         "scripts/copy-configs.js",
         "eslint.config.mjs",
+        "eslint-default-rules.json",
         ".eslintrc.js",
         ".prettierrc",
         "cspell.json",

package/src/config/eslint-default-rules.json

@@ -0,0 +1,62 @@
+{
+  "no-console": "warn",
+  "no-debugger": "error",
+  "prefer-const": "error",
+  "eqeqeq": ["error", "always"],
+  "@typescript-eslint/no-unused-vars": [
+    "error",
+    { "argsIgnorePattern": "^_", "varsIgnorePattern": "^_" }
+  ],
+  "@typescript-eslint/explicit-function-return-type": ["warn"],
+  "@typescript-eslint/no-explicit-any": ["warn"],
+  "@typescript-eslint/no-floating-promises": ["error"],
+  "space-before-function-paren": "off",
+  "operator-linebreak": "off",
+  "max-len": ["warn", { "code": 100 }],
+  "semi": ["error", "always"],
+  "quotes": ["error", "single", { "avoidEscape": true }],
+  "object-curly-spacing": ["error", "always"],
+  "space-infix-ops": "error",
+  "keyword-spacing": ["error", { "before": true, "after": true }],
+  "padding-line-between-statements": [
+    "error",
+    { "blankLine": "always", "prev": "block", "next": "*" },
+    { "blankLine": "always", "prev": "*", "next": "return" }
+  ],
+  "sonarjs/cognitive-complexity": ["warn", 30],
+  "sonarjs/no-duplicate-string": ["warn", { "threshold": 3 }],
+  "sonarjs/no-identical-functions": "warn",
+  "import/order": [
+    "warn",
+    {
+      "groups": ["builtin", "external", "internal", "parent", "sibling", "index"],
+      "alphabetize": { "order": "asc", "caseInsensitive": true }
+    }
+  ],
+  "import/no-duplicates": "error",
+  "jsdoc/require-jsdoc": [
+    "warn",
+    {
+      "publicOnly": true,
+      "require": {
+        "FunctionDeclaration": true,
+        "MethodDefinition": true,
+        "ClassDeclaration": true,
+        "ArrowFunctionExpression": false
+      }
+    }
+  ],
+  "jsdoc/check-param-names": "warn",
+  "jsdoc/check-tag-names": "warn",
+  "jsdoc/check-types": "warn",
+  "prettier/prettier": [
+    "error",
+    {
+      "semi": true,
+      "singleQuote": true,
+      "bracketSpacing": true,
+      "arrowParens": "avoid",
+      "printWidth": 100
+    }
+  ]
+}

package/dist/utils/delta.d.ts

@@ -1,5 +0,0 @@
-/**
- * Returns list of changed files in the current PR filtered by extension.
- * Returns null when not in a GitHub PR context (falls back to full-project scan).
- */
-export declare function getChangedFiles(extensions: string[]): Promise<string[] | null>;

package/dist/utils/delta.js

@@ -1,53 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getChangedFiles = getChangedFiles;
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
-const execa_1 = require("./execa");
-const logger_1 = require("./logger");
-/**
- * Returns list of changed files in the current PR filtered by extension.
- * Returns null when not in a GitHub PR context (falls back to full-project scan).
- */
-async function getChangedFiles(extensions) {
-    const eventName = process.env.GITHUB_EVENT_NAME;
-    const eventPath = process.env.GITHUB_EVENT_PATH;
-    if (eventName !== 'pull_request' || !eventPath || !node_fs_1.default.existsSync(eventPath)) {
-        return null;
-    }
-    let baseSha = null;
-    try {
-        const event = JSON.parse(node_fs_1.default.readFileSync(eventPath, 'utf-8'));
-        baseSha = event?.pull_request?.base?.sha ?? null;
-    }
-    catch {
-        return null;
-    }
-    if (!baseSha)
-        return null;
-    try {
-        const { stdout } = await (0, execa_1.execa)('git', [
-            'diff',
-            '--name-only',
-            '--diff-filter=ACMR',
-            baseSha,
-            'HEAD',
-        ]);
-        const files = stdout
-            .split('\n')
-            .map(f => f.trim())
-            .filter(f => f && extensions.some(ext => f.endsWith(ext)))
-            .map(f => node_path_1.default.join(process.cwd(), f));
-        if (files.length === 0)
-            return null;
-        logger_1.logger.info(`[delta]: 📂 Delta mode: checking ${files.length} changed file(s)`);
-        return files;
-    }
-    catch (err) {
-        logger_1.logger.warn(`[delta]: ⚠️ Could not get changed files, falling back to full scan\n${err}`);
-        return null;
-    }
-}

package/src/config/eslint.config.mjs

@@ -1,180 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import tsPlugin from '@typescript-eslint/eslint-plugin';
-import tsParser from '@typescript-eslint/parser';
-import prettierPlugin from 'eslint-plugin-prettier';
-import sonarjsPlugin from 'eslint-plugin-sonarjs';
-import importPlugin from 'eslint-plugin-import-x';
-import jsdocPlugin from 'eslint-plugin-jsdoc';
-
-/**
- * Default ESLint rules - can be exported for use in init.ts
- */
-export const defaultRules = {
-  'no-console': 'warn',
-  'no-debugger': 'error',
-  'prefer-const': 'error',
-  'eqeqeq': ['error', 'always'],
-  '@typescript-eslint/no-unused-vars': [
-    'error',
-    { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
-  ],
-  '@typescript-eslint/explicit-function-return-type': ['warn'],
-  '@typescript-eslint/no-explicit-any': ['warn'],
-  '@typescript-eslint/no-floating-promises': ['error'],
-  'space-before-function-paren': 'off',
-  'operator-linebreak': 'off',
-  'max-len': ['warn', { code: 100 }],
-  'semi': ['error', 'always'],
-  'quotes': ['error', 'single', { avoidEscape: true }],
-  'object-curly-spacing': ['error', 'always'],
-  'space-infix-ops': 'error',
-  'keyword-spacing': ['error', { before: true, after: true }],
-  'padding-line-between-statements': [
-    'error',
-    { blankLine: 'always', prev: 'block', next: '*' },
-    { blankLine: 'always', prev: '*', next: 'return' },
-  ],
-  // Complexity analysis (#61)
-  'sonarjs/cognitive-complexity': ['warn', 30],
-  'sonarjs/no-duplicate-string': ['warn', { threshold: 3 }],
-  'sonarjs/no-identical-functions': 'warn',
-  // Import ordering (#65)
-  'import/order': [
-    'warn',
-    {
-      groups: ['builtin', 'external', 'internal', 'parent', 'sibling', 'index'],
-      alphabetize: { order: 'asc', caseInsensitive: true },
-    },
-  ],
-  'import/no-duplicates': 'error',
-  // Documentation (#62)
-  'jsdoc/require-jsdoc': [
-    'warn',
-    {
-      publicOnly: true,
-      require: {
-        FunctionDeclaration: true,
-        MethodDefinition: true,
-        ClassDeclaration: true,
-        ArrowFunctionExpression: false,
-      },
-    },
-  ],
-  'jsdoc/check-param-names': 'warn',
-  'jsdoc/check-tag-names': 'warn',
-  'jsdoc/check-types': 'warn',
-  'prettier/prettier': [
-    'error',
-    {
-      semi: true,
-      singleQuote: true,
-      bracketSpacing: true,
-      arrowParens: 'avoid',
-      printWidth: 100,
-    },
-  ],
-};
-
-/**
- * Default ignore patterns
- */
-const defaultIgnores = [
-  '**/node_modules/**',
-  '**/dist/**',
-  '**/.git/**',
-  '**/build/**',
-  '**/coverage/**',
-];
-
-/**
- * Load user's pr-checkmate.json from project root
- * Works both when developing the package and when installed in node_modules
- */
-function loadUserConfig() {
-  let currentDir = process.cwd();
-  let configPath = path.join(currentDir, 'pr-checkmate.json');
-  
-  // If running from node_modules, find project root
-  if (currentDir.includes('node_modules')) {
-    const parts = currentDir.split(path.sep);
-    const nodeModulesIndex = parts.lastIndexOf('node_modules');
-    if (nodeModulesIndex > 0) {
-      currentDir = parts.slice(0, nodeModulesIndex).join(path.sep);
-      configPath = path.join(currentDir, 'pr-checkmate.json');
-    }
-  }
-  
-  if (fs.existsSync(configPath)) {
-    try {
-      const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-      console.error(`[loadUserConfig]: ✅ Loaded user config from: ${configPath}`);
-      return config;
-    } catch (err) {
-      console.warn(`[loadUserConfig]: ⚠️ Failed to parse ${configPath}:`, err.message);
-    }
-  } else {
-    console.error(`[loadUserConfig]: No pr-checkmate.json found, using defaults`);
-  }
-  
-  return { sourcePath: 'src', eslint: {} };
-}
-
-const userConfig = loadUserConfig();
-const SRC = userConfig.sourcePath || 'src';
-
-// Merge default rules with user-defined rules
-const mergedRules = {
-  ...defaultRules,
-  ...(userConfig.eslint?.rules || {}),
-};
-
-// Merge default ignores with user-defined ignores
-const mergedIgnores = [
-  ...defaultIgnores,
-  '**/.eslintrc.js',
-  '**/eslint.config.mjs',
-  ...(userConfig.eslint?.ignorePatterns || []),
-];
-
-// Log customization info
-const customRulesCount = Object.keys(userConfig.eslint?.rules || {}).length;
-const customIgnoresCount = (userConfig.eslint?.ignorePatterns || []).length;
-
-if (customRulesCount > 0) {
-  console.error(`Applied ${customRulesCount} custom ESLint rules`);
-}
-if (customIgnoresCount > 0) {
-  console.error(`🚫 Applied ${customIgnoresCount} custom ignore patterns`);
-}
-
-console.error(`ESLint checking: ${SRC}/**/*.{ts,tsx,js,jsx}`);
-
-export default [
-  // Global ignores must be in a separate config object
-  {
-    ignores: mergedIgnores,
-  },
-  {
-    files: [`${SRC}/**/*.{ts,tsx,js,jsx}`],
-
-    languageOptions: {
-      parser: tsParser,
-      parserOptions: {
-        ecmaVersion: 2020,
-        sourceType: 'module',
-        project: './tsconfig.json',
-      },
-    },
-
-    plugins: {
-      '@typescript-eslint': tsPlugin,
-      prettier: prettierPlugin,
-      sonarjs: sonarjsPlugin,
-      import: importPlugin,
-      jsdoc: jsdocPlugin,
-    },
-
-    rules: mergedRules,
-  },
-];