@opensip-tools/fitness 1.0.4

package/dist/framework/execution-context.js

@@ -0,0 +1,122 @@
+// @fitness-ignore-file concurrency-safety -- single-threaded execution context
+// @fitness-ignore-file error-handling-suite -- catch blocks delegate errors through established patterns
+/**
+ * @fileoverview Execution context creation for fitness checks
+ *
+ * Provides the runtime context available to check execute functions,
+ * including file access, pattern matching, and abort support.
+ */
+import * as fs from 'node:fs/promises';
+import { relative } from 'node:path';
+import { SystemError } from '@opensip-tools/core';
+import { Minimatch } from 'minimatch';
+import { DEFAULT_EXCLUSION_PATTERNS } from './constants.js';
+import { fileCache } from './file-cache.js';
+import { PathMatcher } from './path-matcher.js';
+import { extractSnippet } from './result-builder.js';
+/**
+ * Error thrown when a check is aborted via AbortSignal.
+ */
+export class CheckAbortedError extends SystemError {
+    name = 'CheckAbortedError';
+    checkId;
+    constructor(checkId, message) {
+        super(message ?? `Check ${checkId} was aborted`, { code: 'SYSTEM.FITNESS.CHECK_ABORTED' });
+        this.checkId = checkId;
+        Object.setPrototypeOf(this, CheckAbortedError.prototype);
+    }
+}
+/**
+ * Creates the matchFiles function for the execution context.
+ *
+ * `globalExcludes` come from the project config's top-level
+ * `globalExcludes` array. They are applied ONLY to the fileCache
+ * fallback path — the path taken by scope-empty checks. Custom
+ * `patterns` arguments are honored as-is (the caller knows what they
+ * want), and `targetFiles` from per-check overrides are pre-filtered
+ * by `preResolveAllTargets`. Pre-compiled to Minimatch matchers so
+ * we don't pay regex compilation per filter call.
+ */
+function createMatchFilesFunction(cwd, matcher, targetFiles, globalExcludes) {
+    const compiledGlobalExcludes = globalExcludes && globalExcludes.length > 0
+        ? globalExcludes.map((pattern) => new Minimatch(pattern, { dot: true }))
+        : undefined;
+    const applyGlobalExcludes = (files) => {
+        if (!compiledGlobalExcludes)
+            return files;
+        return files.filter((filePath) => {
+            const rel = relative(cwd, filePath);
+            return !compiledGlobalExcludes.some((m) => m.match(rel));
+        });
+    };
+    return async (patterns, options) => {
+        if (patterns && patterns.length > 0) {
+            const customMatcher = PathMatcher.create({
+                cwd,
+                include: [...patterns],
+                exclude: [...(options?.ignore ?? []), ...DEFAULT_EXCLUSION_PATTERNS],
+            });
+            return customMatcher.files();
+        }
+        // Per-check target files take priority over cache.
+        // These are already filtered by globalExcludes during target
+        // pre-resolution (scope-resolver.ts), so don't re-filter.
+        if (targetFiles) {
+            return targetFiles;
+        }
+        // When the matcher has no include patterns (checks without targets),
+        // fall back to the prewarmed file cache paths. The cache itself
+        // honors no exclusion config — that's the layer where globalExcludes
+        // must be applied, otherwise scope-empty checks scan every prewarmed
+        // file regardless of project intent.
+        if (matcher.includePatterns.length === 0) {
+            return applyGlobalExcludes(fileCache.paths());
+        }
+        return matcher.files();
+    };
+}
+/**
+ * Creates the execution context for a check.
+ */
+export function createExecutionContext(config, cwd, matcher, options) {
+    return {
+        cwd,
+        checkId: config.id,
+        checkSlug: config.slug,
+        verbose: options?.verbose ?? false,
+        // @fitness-ignore-next-line unbounded-memory -- size validation via fs.stat() is on the next line; false positive on method name
+        /** @throws {SystemError} When the file exceeds 10MB */
+        async readFile(filePath) {
+            const fileStats = await fs.stat(filePath);
+            if (fileStats.size > 10_000_000) {
+                throw new SystemError(`File too large (${fileStats.size} bytes, max 10MB): ${filePath}`, { code: 'SYSTEM.FITNESS.FILE_TOO_LARGE' });
+            }
+            return fileCache.get(filePath);
+        },
+        fileExists(filePath) {
+            return fileCache.exists(filePath);
+        },
+        matchFiles: createMatchFilesFunction(cwd, matcher, options?.targetFiles, options?.globalExcludes),
+        getMatcher() {
+            return matcher;
+        },
+        log(message) {
+            if (options?.verbose) {
+                // @fitness-ignore-next-line no-console-log -- Verbose check-level debug output bypasses structured logger for immediate CLI feedback
+                // @fitness-ignore-next-line logging-standards -- Verbose check-level debug output bypasses structured logger for immediate CLI feedback
+                console.log(`[${config.slug}] ${message}`);
+            }
+        },
+        extractSnippet(content, line, contextLines = 2) {
+            return extractSnippet(content, line, contextLines);
+        },
+        ...(options?.signal ? { signal: options.signal } : {}),
+        /** @throws {CheckAbortedError} When the check has been aborted */
+        checkAborted() {
+            if (options?.signal?.aborted) {
+                throw new CheckAbortedError(config.slug);
+            }
+        },
+    };
+}
+//# sourceMappingURL=execution-context.js.map

package/dist/framework/execution-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../src/framework/execution-context.ts"],"names":[],"mappings":"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"}

package/dist/framework/file-accessor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview FileAccessor implementation for lazy file loading
+ *
+ * Provides lazy-loading file access with LRU caching for
+ * analyzeAll mode checks that need to correlate across files.
+ */
+import type { FileAccessor } from './check-config.js';
+/** Options for creating a FileAccessor instance. */
+export interface FileAccessorOptions {
+    readonly cacheCapacity?: number;
+    readonly signal?: AbortSignal;
+    /**
+     * Content filtering applied before returning file content. See
+     * BaseCheckConfig.contentFilter for the canonical doc.
+     */
+    readonly contentFilter?: 'raw' | 'strip-strings' | 'strip-strings-and-comments';
+}
+/** Create a FileAccessor for lazy-loading files with LRU caching. */
+export declare function createFileAccessor(filePaths: readonly string[], options?: FileAccessorOptions): FileAccessor;
+//# sourceMappingURL=file-accessor.d.ts.map

package/dist/framework/file-accessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-accessor.d.ts","sourceRoot":"","sources":["../../src/framework/file-accessor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAkDrD,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,GAAG,eAAe,GAAG,4BAA4B,CAAA;CAChF;AA0FD,qEAAqE;AAErE,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,OAAO,GAAE,mBAAwB,GAChC,YAAY,CAEd"}

package/dist/framework/file-accessor.js

@@ -0,0 +1,122 @@
+/**
+ * @fileoverview FileAccessor implementation for lazy file loading
+ *
+ * Provides lazy-loading file access with LRU caching for
+ * analyzeAll mode checks that need to correlate across files.
+ */
+import * as fs from 'node:fs/promises';
+import { ValidationError, applyContentFilter } from '@opensip-tools/core';
+import { fileCache } from './file-cache.js';
+// =============================================================================
+// LRU CACHE
+// =============================================================================
+class LRUCache {
+    cache;
+    capacity;
+    constructor(capacity) {
+        this.cache = new Map();
+        this.capacity = capacity;
+    }
+    get(key) {
+        // in-memory: single-threaded Node.js access pattern
+        const value = this.cache.get(key);
+        if (value !== undefined) {
+            this.cache.delete(key);
+            this.cache.set(key, value);
+        }
+        return value;
+    }
+    set(key, value) {
+        if (this.cache.has(key)) {
+            this.cache.delete(key);
+        }
+        else if (this.cache.size >= this.capacity) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey !== undefined) {
+                this.cache.delete(firstKey);
+            }
+        }
+        this.cache.set(key, value);
+    }
+    get size() {
+        return this.cache.size;
+    }
+    clear() {
+        this.cache.clear();
+    }
+}
+const DEFAULT_CACHE_CAPACITY = 100;
+/** FileAccessor implementation with LRU caching and abort signal support. */
+class FileAccessorImpl {
+    paths;
+    cache;
+    pathSet;
+    signal;
+    contentFilterMode;
+    constructor(filePaths, options = {}) {
+        this.paths = filePaths;
+        this.pathSet = new Set(filePaths);
+        this.cache = new LRUCache(options.cacheCapacity ?? DEFAULT_CACHE_CAPACITY);
+        this.signal = options.signal;
+        this.contentFilterMode = options.contentFilter;
+    }
+    async read(filePath) {
+        // in-memory: single-threaded Node.js access pattern
+        // @fitness-ignore-next-line detached-promises -- throwIfAborted() is synchronous, optional chaining is not a detached promise
+        this.signal?.throwIfAborted();
+        if (!this.pathSet.has(filePath)) {
+            // @fitness-ignore-next-line result-pattern-consistency -- internal method, exceptions propagate to public Result boundary
+            throw new ValidationError(`File path not in matched set: ${filePath}. ` +
+                `Only paths from the 'paths' property can be read.`, { code: 'VALIDATION.FITNESS.PATH_NOT_IN_SET' });
+        }
+        const cached = this.cache.get(filePath);
+        if (cached !== undefined) {
+            return cached;
+        }
+        // Try global file cache first (populated by prewarm or previous checks)
+        let content = fileCache.getCached(filePath);
+        if (content === undefined) {
+            const fileStats = await fs.stat(filePath);
+            if (fileStats.size > 10_000_000) {
+                // @fitness-ignore-next-line result-pattern-consistency -- infrastructure boundary guard, not domain logic
+                throw new ValidationError(`File too large (${fileStats.size} bytes, max 10MB): ${filePath}`, { code: 'VALIDATION.FITNESS.FILE_TOO_LARGE' });
+            }
+            content = await fs.readFile(filePath, 'utf8');
+        }
+        // Dispatch through the LanguageAdapter for the file's extension.
+        // See languages/content-filter-dispatch.ts.
+        content = applyContentFilter(filePath, content, this.contentFilterMode ?? 'none');
+        this.cache.set(filePath, content);
+        return content;
+    }
+    async readMany(filePaths) {
+        // in-memory: single-threaded Node.js access pattern
+        const results = new Map();
+        // @fitness-ignore-next-line no-unbounded-concurrency -- bounded by FileAccessor path set; LRU cache limits memory
+        const entries = await Promise.all(filePaths.map(async (filePath) => {
+            const content = await this.read(filePath);
+            return [filePath, content];
+        }));
+        for (const [filePath, content] of entries) {
+            results.set(filePath, content);
+        }
+        return results;
+    }
+    async readAll() {
+        return this.readMany(this.paths);
+    }
+    /** Number of files currently held in the LRU cache. */
+    get cachedCount() {
+        return this.cache.size;
+    }
+    /** Evict all entries from the file cache. */
+    clearCache() {
+        this.cache.clear();
+    }
+}
+/** Create a FileAccessor for lazy-loading files with LRU caching. */
+// @fitness-ignore-next-line result-pattern-consistency -- factory function, cannot fail in domain-meaningful ways
+export function createFileAccessor(filePaths, options = {}) {
+    return new FileAccessorImpl(filePaths, options);
+}
+//# sourceMappingURL=file-accessor.js.map

package/dist/framework/file-accessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-accessor.js","sourceRoot":"","sources":["../../src/framework/file-accessor.ts"],"names":[],"mappings":"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"}

package/dist/framework/file-cache.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview In-memory file cache for fitness checks
+ *
+ * Simple file content cache with optional prewarming.
+ * Used by all checks during a run for efficient file access.
+ */
+/**
+ * Prewarm statistics.
+ */
+interface PrewarmStats {
+    /** Number of files loaded */
+    readonly filesLoaded: number;
+    /** Duration in milliseconds */
+    readonly durationMs: number;
+    /** Total bytes loaded */
+    readonly totalBytes: number;
+}
+declare class FileCache {
+    private readonly cache;
+    private _prewarmed;
+    private _cleared;
+    private _autoClearTimer;
+    /**
+     * Prewarm the cache by loading all files matching patterns.
+     * @param cwd - Working directory for file resolution
+     * @param patterns - Glob patterns to prewarm file contents for
+     * @returns Prewarm statistics
+     */
+    prewarm(cwd: string, patterns: readonly string[]): Promise<PrewarmStats>;
+    /**
+     * Get file content from cache, falling back to disk if not cached.
+     * @throws {Error} If the path is a directory instead of a file
+     */
+    /** Synchronously check if a file is in cache. Returns content or undefined. */
+    getCached(filePath: string): string | undefined;
+    get(filePath: string): Promise<string>;
+    /**
+     * Check if a file exists (in cache or on disk).
+     */
+    exists(filePath: string): Promise<boolean>;
+    /**
+     * Clear the cache. Must be called after checks complete.
+     */
+    clear(): void;
+    /**
+     * Get all cached file paths.
+     * Returns the paths of all files loaded during prewarm or on-demand reads.
+     */
+    paths(): readonly string[];
+    /**
+     * Get cache statistics.
+     */
+    /** Auto-clear after timeout to prevent memory leaks from missed lifecycle cleanup */
+    private scheduleAutoClear;
+    get stats(): {
+        size: number;
+        prewarmed: boolean;
+        cleared: boolean;
+    };
+}
+/**
+ * Shared file cache instance.
+ */
+export declare const fileCache: FileCache;
+/**
+ * Default patterns to prewarm for fitness checks.
+ */
+export declare const DEFAULT_PREWARM_PATTERNS: readonly ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx", "**/*.json", "**/*.md"];
+export {};
+//# sourceMappingURL=file-cache.d.ts.map

package/dist/framework/file-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cache.d.ts","sourceRoot":"","sources":["../../src/framework/file-cache.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAQH;;GAEG;AACH,UAAU,YAAY;IACpB,6BAA6B;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,yBAAyB;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAYD,cAAM,SAAS;IACb,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;IAClD,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,eAAe,CAA6C;IAEpE;;;;;OAKG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAwD9E;;;OAGG;IACH,+EAA+E;IAC/E,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKzC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB5C;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBhD;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;;OAGG;IACH,KAAK,IAAI,SAAS,MAAM,EAAE;IAI1B;;OAEG;IACH,qFAAqF;IACrF,OAAO,CAAC,iBAAiB;IAazB,IAAI,KAAK,IAAI;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,SAAS,EAAE,OAAO,CAAA;QAClB,OAAO,EAAE,OAAO,CAAA;KACjB,CAMA;CACF;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,WAAkB,CAAA;AAExC;;GAEG;AACH,eAAO,MAAM,wBAAwB,iFAO3B,CAAA"}

package/dist/framework/file-cache.js

@@ -0,0 +1,178 @@
+// @fitness-ignore-file public-api-jsdoc -- internal framework module; public API documented at package level
+/**
+ * @fileoverview In-memory file cache for fitness checks
+ *
+ * Simple file content cache with optional prewarming.
+ * Used by all checks during a run for efficient file access.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { ValidationError } from '@opensip-tools/core';
+import { glob } from 'glob';
+/**
+ * Simple in-memory file cache.
+ *
+ * Usage:
+ * 1. Call prewarm() before running checks (loads file contents)
+ * 2. Use get() to read file contents (falls back to disk if not cached)
+ * 3. Call clear() after checks complete
+ */
+const PREWARM_BATCH_SIZE = 100;
+class FileCache {
+    cache = new Map();
+    _prewarmed = false;
+    _cleared = false;
+    _autoClearTimer = null;
+    /**
+     * Prewarm the cache by loading all files matching patterns.
+     * @param cwd - Working directory for file resolution
+     * @param patterns - Glob patterns to prewarm file contents for
+     * @returns Prewarm statistics
+     */
+    async prewarm(cwd, patterns) {
+        const start = Date.now();
+        let totalBytes = 0;
+        // Find all matching files for content caching
+        const allFiles = new Set();
+        for (const pattern of patterns) {
+            // @fitness-ignore-next-line performance-anti-patterns -- sequential glob calls: each pattern must resolve before deduplication
+            const files = await glob(pattern, {
+                cwd,
+                absolute: true,
+                nodir: true,
+                ignore: ['**/node_modules/**', '**/dist/**', '**/.git/**'],
+            });
+            for (const file of files) {
+                allFiles.add(file);
+            }
+        }
+        // Load file contents in parallel batches
+        const files = [...allFiles];
+        for (let i = 0; i < files.length; i += PREWARM_BATCH_SIZE) {
+            const batch = files.slice(i, i + PREWARM_BATCH_SIZE);
+            // @fitness-ignore-next-line performance-anti-patterns -- intentional batching: limits concurrent file reads to control memory pressure
+            const results = await Promise.allSettled(batch.map(async (filePath) => {
+                const stats = await fs.stat(filePath);
+                if (stats.isDirectory()) {
+                    return null;
+                }
+                const content = await fs.readFile(filePath, 'utf8');
+                return { filePath, content };
+            }));
+            for (const result of results) {
+                if (result.status === 'fulfilled' && result.value !== null) {
+                    this.cache.set(result.value.filePath, result.value.content);
+                    totalBytes += result.value.content.length;
+                }
+            }
+        }
+        this._prewarmed = true;
+        this._cleared = false;
+        this.scheduleAutoClear();
+        const durationMs = Date.now() - start;
+        return {
+            filesLoaded: this.cache.size,
+            durationMs,
+            totalBytes,
+        };
+    }
+    /**
+     * Get file content from cache, falling back to disk if not cached.
+     * @throws {Error} If the path is a directory instead of a file
+     */
+    /** Synchronously check if a file is in cache. Returns content or undefined. */
+    getCached(filePath) {
+        const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(filePath);
+        return this.cache.get(absolutePath);
+    }
+    async get(filePath) {
+        const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(filePath);
+        const cached = this.cache.get(absolutePath);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const stats = await fs.stat(absolutePath);
+        if (stats.isDirectory()) {
+            // @fitness-ignore-next-line result-pattern-consistency -- internal method, exceptions propagate to public Result boundary
+            throw new ValidationError(`Cannot read directory as file: ${absolutePath}`, { code: 'VALIDATION.FITNESS.DIRECTORY_AS_FILE' });
+        }
+        const content = await fs.readFile(absolutePath, 'utf8');
+        this.cache.set(absolutePath, content);
+        return content;
+    }
+    /**
+     * Check if a file exists (in cache or on disk).
+     */
+    async exists(filePath) {
+        const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(filePath);
+        if (this.cache.has(absolutePath)) {
+            return true;
+        }
+        try {
+            await fs.access(absolutePath);
+            return true;
+        }
+        catch {
+            // @swallow-ok File access check failed — treat as not accessible
+            return false;
+        }
+    }
+    /**
+     * Clear the cache. Must be called after checks complete.
+     */
+    clear() {
+        this.cache.clear();
+        this._prewarmed = false;
+        this._cleared = true;
+        if (this._autoClearTimer) {
+            clearTimeout(this._autoClearTimer);
+            this._autoClearTimer = null;
+        }
+    }
+    /**
+     * Get all cached file paths.
+     * Returns the paths of all files loaded during prewarm or on-demand reads.
+     */
+    paths() {
+        return [...this.cache.keys()].sort();
+    }
+    /**
+     * Get cache statistics.
+     */
+    /** Auto-clear after timeout to prevent memory leaks from missed lifecycle cleanup */
+    scheduleAutoClear() {
+        if (this._autoClearTimer) {
+            clearTimeout(this._autoClearTimer);
+        }
+        this._autoClearTimer = setTimeout(() => {
+            if (this.cache.size > 0) {
+                this.clear();
+            }
+        }, 10 * 60 * 1000); // 10 minutes
+        // Unref so the timer doesn't keep the process alive
+        this._autoClearTimer.unref();
+    }
+    get stats() {
+        return {
+            size: this.cache.size,
+            prewarmed: this._prewarmed,
+            cleared: this._cleared,
+        };
+    }
+}
+/**
+ * Shared file cache instance.
+ */
+export const fileCache = new FileCache();
+/**
+ * Default patterns to prewarm for fitness checks.
+ */
+export const DEFAULT_PREWARM_PATTERNS = [
+    '**/*.ts',
+    '**/*.tsx',
+    '**/*.js',
+    '**/*.jsx',
+    '**/*.json',
+    '**/*.md',
+];
+//# sourceMappingURL=file-cache.js.map

package/dist/framework/file-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cache.js","sourceRoot":"","sources":["../../src/framework/file-cache.ts"],"names":[],"mappings":"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"}

package/dist/framework/file-type-filter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview File type filtering for per-check file extension matching
+ *
+ * Filters matched files by extension based on a check's declared fileTypes.
+ */
+/**
+ * Filter files by extension based on a check's declared fileTypes.
+ * If fileTypes is undefined or empty, returns all files (universal).
+ */
+export declare function filterFilesByType(files: readonly string[], fileTypes: readonly string[] | undefined): string[];
+//# sourceMappingURL=file-type-filter.d.ts.map

package/dist/framework/file-type-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-type-filter.d.ts","sourceRoot":"","sources":["../../src/framework/file-type-filter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACvC,MAAM,EAAE,CASV"}

package/dist/framework/file-type-filter.js

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview File type filtering for per-check file extension matching
+ *
+ * Filters matched files by extension based on a check's declared fileTypes.
+ */
+import * as path from 'node:path';
+/**
+ * Filter files by extension based on a check's declared fileTypes.
+ * If fileTypes is undefined or empty, returns all files (universal).
+ */
+export function filterFilesByType(files, fileTypes) {
+    if (!fileTypes || fileTypes.length === 0) {
+        return [...files];
+    }
+    const extensions = new Set(fileTypes);
+    return files.filter((f) => {
+        const ext = path.extname(f).slice(1); // remove leading dot
+        return extensions.has(ext);
+    });
+}
+//# sourceMappingURL=file-type-filter.js.map

package/dist/framework/file-type-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-type-filter.js","sourceRoot":"","sources":["../../src/framework/file-type-filter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAwB,EACxB,SAAwC;IAExC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAA;IACnB,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAA;IACrC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA,CAAC,qBAAqB;QAC1D,OAAO,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/framework/ignore-processing.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Ignore directive processing for fitness checks
+ *
+ * Filters signals based on file-level and line-level ignore directives.
+ * Signals pointing at lines that contain @fitness-ignore directives are
+ * never suppressed — this prevents recursive suppression loops where
+ * directive-auditing checks would otherwise flag their own suppressions.
+ */
+import type { DirectiveEntry } from './directive-inventory.js';
+import type { CheckResult } from '../types/findings.js';
+import type { Signal } from '@opensip-tools/core';
+/** Filter signals based on file-level and line-level @fitness-ignore directives */
+export declare function filterSignalsByDirectives(signals: readonly Signal[], checkId: string, initialIgnoredCount: number): Promise<{
+    filteredSignals: Signal[];
+    ignoredCount: number;
+    appliedDirectives: DirectiveEntry[];
+}>;
+/**
+ * Builds the filtered result from the original result and filtered signals.
+ */
+export declare function buildFilteredResult(result: CheckResult, filteredSignals: Signal[], ignoredCount: number, start: number): CheckResult;
+//# sourceMappingURL=ignore-processing.d.ts.map

package/dist/framework/ignore-processing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-processing.d.ts","sourceRoot":"","sources":["../../src/framework/ignore-processing.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAWH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AA2IjD,mFAAmF;AACnF,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,EAAE,MAAM,EACf,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAAC;IAAE,eAAe,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC,CAuBnG;AAgID;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,eAAe,EAAE,MAAM,EAAE,EACzB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GACZ,WAAW,CAwBb"}