@opensip-tools/fitness 1.0.4

package/dist/framework/result-builder.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @fileoverview ResultBuilder - Builder pattern for check results
+ *
+ * Provides a fluent API for constructing check results with signals,
+ * metadata, and display information.
+ */
+import type { CheckResult, ItemType } from '../types/findings.js';
+import type { Signal } from '@opensip-tools/core';
+/**
+ * Options for building results.
+ */
+export interface ResultBuilderOptions {
+    /** Check ID */
+    readonly checkId: string;
+    /** Item type for display (files, modules, etc.) */
+    readonly itemType: ItemType;
+    /** Custom unit label (overrides itemType) */
+    readonly unit?: string | undefined;
+}
+/**
+ * Builder for constructing check results.
+ *
+ * @example
+ * ```typescript
+ * const result = ResultBuilder.create({ checkId: 'my-check', itemType: 'files' })
+ *   .totalItems(100)
+ *   .addSignal(signal1)
+ *   .build();
+ * ```
+ */
+export declare class ResultBuilder {
+    private readonly options;
+    private _totalItems;
+    private readonly _signals;
+    private _ignoredCount;
+    private _durationMs?;
+    private _filesScanned?;
+    private _extra?;
+    private constructor();
+    static create(options: ResultBuilderOptions): ResultBuilder;
+    totalItems(count: number): this;
+    filesScanned(count: number): this;
+    addSignal(signal: Signal): this;
+    addSignals(signals: readonly Signal[]): this;
+    ignoredCount(count: number): this;
+    incrementIgnored(by?: number): this;
+    duration(ms: number): this;
+    extra(data: Record<string, unknown>): this;
+    build(): CheckResult;
+    buildError(message: string, error?: Error): CheckResult;
+    private buildInfo;
+    private getUniqueFileCount;
+    get signalCount(): number;
+    get errorCount(): number;
+    get warningCount(): number;
+    get hasSignals(): boolean;
+    get willPass(): boolean;
+}
+/**
+ * Extract a code snippet with context lines around a target line.
+ */
+export declare function extractSnippet(content: string, line: number, contextLines?: number): {
+    snippet: string;
+    contextLines: number;
+};
+/**
+ * Get line number from content string and character index.
+ */
+export declare function getLineNumber(content: string, index: number): number;
+/**
+ * Check if a file path matches API file patterns.
+ */
+export declare function isAPIFile(filePath: string): boolean;
+//# sourceMappingURL=result-builder.d.ts.map

package/dist/framework/result-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-builder.d.ts","sourceRoot":"","sources":["../../src/framework/result-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,KAAK,EACV,WAAW,EAEX,QAAQ,EACT,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,eAAe;IACf,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACnC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IAQJ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP5C,OAAO,CAAC,WAAW,CAAI;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,WAAW,CAAC,CAAQ;IAC5B,OAAO,CAAC,aAAa,CAAC,CAAQ;IAC9B,OAAO,CAAC,MAAM,CAAC,CAAyB;IAExC,OAAO;IAEP,MAAM,CAAC,MAAM,CACX,OAAO,EAAE,oBAAoB,GAC5B,aAAa;IAIhB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK/B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,UAAU,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAQ5C,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC,gBAAgB,CAAC,EAAE,SAAI,GAAG,IAAI;IAK9B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK1B,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK1C,KAAK,IAAI,WAAW;IAqCpB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,WAAW;IAIvD,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,kBAAkB;IAK1B,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;CACF;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,YAAY,SAAI,GACf;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAO3C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpE;AAOD;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAInD"}

package/dist/framework/result-builder.js

@@ -0,0 +1,154 @@
+/**
+ * @fileoverview ResultBuilder - Builder pattern for check results
+ *
+ * Provides a fluent API for constructing check results with signals,
+ * metadata, and display information.
+ */
+import { CheckInfoFactory, createResultWithSignals, createErrorResult, getItemTypeLabel, } from '../types/findings.js';
+import { countErrors, countWarnings } from '../types/severity.js';
+/**
+ * Builder for constructing check results.
+ *
+ * @example
+ * ```typescript
+ * const result = ResultBuilder.create({ checkId: 'my-check', itemType: 'files' })
+ *   .totalItems(100)
+ *   .addSignal(signal1)
+ *   .build();
+ * ```
+ */
+export class ResultBuilder {
+    options;
+    _totalItems = 0;
+    _signals = [];
+    _ignoredCount = 0;
+    _durationMs;
+    _filesScanned;
+    _extra;
+    constructor(options) {
+        this.options = options;
+    }
+    static create(options) {
+        return new ResultBuilder(options);
+    }
+    totalItems(count) {
+        this._totalItems = count;
+        return this;
+    }
+    filesScanned(count) {
+        this._filesScanned = count;
+        return this;
+    }
+    addSignal(signal) {
+        this._signals.push(signal);
+        return this;
+    }
+    addSignals(signals) {
+        if (signals.length === 0) {
+            return this;
+        }
+        this._signals.push(...signals);
+        return this;
+    }
+    ignoredCount(count) {
+        this._ignoredCount = count;
+        return this;
+    }
+    incrementIgnored(by = 1) {
+        this._ignoredCount += by;
+        return this;
+    }
+    duration(ms) {
+        this._durationMs = ms;
+        return this;
+    }
+    extra(data) {
+        this._extra = { ...this._extra, ...data };
+        return this;
+    }
+    build() {
+        const unit = this.options.unit ?? this.options.itemType;
+        const errors = countErrors(this._signals);
+        const warnings = countWarnings(this._signals);
+        const info = this.buildInfo(errors, warnings, unit);
+        const buildOptions = {};
+        if (this._ignoredCount > 0) {
+            buildOptions.ignoredCount = this._ignoredCount;
+        }
+        if (this._durationMs !== undefined) {
+            buildOptions.durationMs = this._durationMs;
+        }
+        if (this._filesScanned !== undefined) {
+            buildOptions.filesScanned = this._filesScanned;
+        }
+        buildOptions.itemType = this.options.itemType;
+        if (this._extra !== undefined) {
+            buildOptions.extra = this._extra;
+        }
+        return createResultWithSignals(info, this._signals, this._totalItems, Object.keys(buildOptions).length > 0 ? buildOptions : undefined);
+    }
+    buildError(message, error) {
+        return createErrorResult(message, error);
+    }
+    buildInfo(errors, warnings, unit) {
+        if (this._totalItems > 0) {
+            // Clamp to 0: analyzeAll-mode checks can surface violations against
+            // files outside the scanned set, which would otherwise produce a
+            // negative "-N/M compliant" label.
+            const compliantItems = Math.max(0, this._totalItems - this.getUniqueFileCount());
+            return CheckInfoFactory.compliance(compliantItems, this._totalItems, unit);
+        }
+        const total = errors + warnings;
+        return CheckInfoFactory.violations(total, getItemTypeLabel('violations', total));
+    }
+    getUniqueFileCount() {
+        const files = new Set(this._signals.map((s) => s.code?.file).filter(Boolean));
+        return files.size;
+    }
+    get signalCount() {
+        return this._signals.length;
+    }
+    get errorCount() {
+        return countErrors(this._signals);
+    }
+    get warningCount() {
+        return countWarnings(this._signals);
+    }
+    get hasSignals() {
+        return this._signals.length > 0;
+    }
+    get willPass() {
+        return this.errorCount === 0;
+    }
+}
+// =============================================================================
+// SNIPPET UTILITIES
+// =============================================================================
+/**
+ * Extract a code snippet with context lines around a target line.
+ */
+export function extractSnippet(content, line, contextLines = 2) {
+    const lines = content.split('\n');
+    const startLine = Math.max(0, line - 1 - contextLines);
+    const endLine = Math.min(lines.length, line + contextLines);
+    const snippetLines = lines.slice(startLine, endLine);
+    const snippet = snippetLines.map((l, i) => `${startLine + i + 1} | ${l}`).join('\n');
+    return { snippet, contextLines };
+}
+/**
+ * Get line number from content string and character index.
+ */
+export function getLineNumber(content, index) {
+    return content.slice(0, Math.max(0, index)).split('\n').length;
+}
+/**
+ * Default patterns for identifying API-related files.
+ */
+const DEFAULT_API_FILE_PATTERNS = ['/api/', '/routes/', '-handler.ts', '.handler.ts'];
+/**
+ * Check if a file path matches API file patterns.
+ */
+export function isAPIFile(filePath) {
+    return DEFAULT_API_FILE_PATTERNS.some((pattern) => pattern.startsWith('/') ? filePath.includes(pattern) : filePath.endsWith(pattern));
+}
+//# sourceMappingURL=result-builder.js.map

package/dist/framework/result-builder.js.map

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

package/dist/framework/scope-resolver.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Scope-based file resolution for fitness checks
+ *
+ * Checks declare intent (languages + concerns), targets declare reality
+ * (languages + concerns + globs), and this module resolves the match.
+ *
+ * Performance: all targets are globbed once upfront in buildScopeBasedFileMap.
+ * Per-check resolution is a pure in-memory lookup — no redundant I/O.
+ */
+import type { CheckScope } from './check-config.js';
+import type { TargetRegistry } from '../targets/target-registry.js';
+import type { TargetsConfig } from '../targets/types.js';
+/**
+ * Build the complete check-to-files map for all checks with scopes or overrides.
+ *
+ * All targets are globbed once upfront. Per-check resolution is a pure
+ * in-memory lookup against the pre-resolved file lists.
+ */
+export declare function buildScopeBasedFileMap(checks: readonly {
+    slug: string;
+    scope?: CheckScope;
+}[], registry: TargetRegistry, config: TargetsConfig, rootDir: string): Map<string, readonly string[]>;
+//# sourceMappingURL=scope-resolver.d.ts.map

package/dist/framework/scope-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-resolver.d.ts","sourceRoot":"","sources":["../../src/framework/scope-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AACnE,OAAO,KAAK,EAAU,aAAa,EAAE,MAAM,qBAAqB,CAAA;AA0NhE;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAAE,EAAE,EACvD,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,GACd,GAAG,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAehC"}

package/dist/framework/scope-resolver.js

@@ -0,0 +1,201 @@
+/**
+ * @fileoverview Scope-based file resolution for fitness checks
+ *
+ * Checks declare intent (languages + concerns), targets declare reality
+ * (languages + concerns + globs), and this module resolves the match.
+ *
+ * Performance: all targets are globbed once upfront in buildScopeBasedFileMap.
+ * Per-check resolution is a pure in-memory lookup — no redundant I/O.
+ */
+import { relative, resolve } from 'node:path';
+import { globSync } from 'glob';
+import { minimatch, Minimatch } from 'minimatch';
+// =============================================================================
+// Pre-resolved target file cache
+// =============================================================================
+/** Assemble a single target's file list from pre-resolved pattern results, applying excludes. */
+function assembleTargetFiles(targetConfig, patternResults, compiledGlobalExcludes, rootDir) {
+    const files = new Set();
+    for (const pattern of targetConfig.include) {
+        const matches = patternResults.get(pattern) ?? [];
+        for (const match of matches) {
+            files.add(match);
+        }
+    }
+    if (targetConfig.exclude.length > 0 || compiledGlobalExcludes.length > 0) {
+        const compiledTargetExcludes = targetConfig.exclude.map((ex) => new Minimatch(ex, { dot: true }));
+        const allExcludes = [...compiledTargetExcludes, ...compiledGlobalExcludes];
+        for (const filePath of files) {
+            const rel = relative(rootDir, filePath);
+            if (allExcludes.some((m) => m.match(rel))) {
+                files.delete(filePath);
+            }
+        }
+    }
+    return [...files].sort();
+}
+/**
+ * Collect all unique glob patterns and ignore patterns from all targets,
+ * run a single deduplicated glob pass, then partition results per target.
+ *
+ * This avoids redundant filesystem traversals when targets share common
+ * patterns (e.g. multiple targets including "packages/star/src/starstar/star.ts").
+ */
+function preResolveAllTargets(registry, config, rootDir) {
+    const targets = registry.getAll();
+    if (targets.length === 0)
+        return new Map();
+    // Collect all unique include patterns across targets
+    const allPatterns = new Set();
+    for (const target of targets) {
+        for (const pattern of target.config.include) {
+            allPatterns.add(pattern);
+        }
+    }
+    // Single glob pass for each unique pattern — deduplicated across targets.
+    // Common infrastructure dirs are always ignored to prevent expensive traversals.
+    const COMMON_IGNORE = ['**/node_modules/**', '**/dist/**', '**/.git/**'];
+    const patternResults = new Map();
+    for (const pattern of allPatterns) {
+        const matches = globSync(pattern, {
+            cwd: rootDir,
+            absolute: true,
+            nodir: true,
+            ignore: COMMON_IGNORE,
+        });
+        patternResults.set(pattern, matches.map((m) => resolve(m)));
+    }
+    // Pre-compile globalExcludes matchers for reuse across all targets
+    const { globalExcludes } = config;
+    const compiledExcludes = globalExcludes.map((pattern) => new Minimatch(pattern, { dot: true }));
+    // Assemble per-target file lists by combining pattern results and filtering excludes.
+    // Both target-specific excludes AND globalExcludes are applied here so that
+    // per-check resolution is a pure in-memory lookup with no minimatch calls.
+    const result = new Map();
+    for (const target of targets) {
+        const files = assembleTargetFiles({ include: target.config.include, exclude: target.config.exclude, name: target.config.name }, patternResults, compiledExcludes, rootDir);
+        result.set(target.config.name, files);
+    }
+    return result;
+}
+/**
+ * Resolve a single target's include/exclude globs to absolute file paths.
+ * Used by the resolveFilesForCheck fallback path (single-check mode).
+ */
+function resolveTargetGlobs(target, rootDir) {
+    const files = new Set();
+    const { include, exclude } = target.config;
+    for (const pattern of include) {
+        const matches = globSync(pattern, {
+            cwd: rootDir,
+            ignore: [...exclude],
+            absolute: true,
+        });
+        for (const match of matches) {
+            files.add(resolve(match));
+        }
+    }
+    return [...files].sort();
+}
+/**
+ * Look up pre-resolved files for a set of target names, union and deduplicate.
+ */
+function unionTargetFiles(targetNames, resolvedTargets) {
+    if (targetNames.length === 1) {
+        return [...(resolvedTargets.get(targetNames[0]) ?? [])];
+    }
+    const files = new Set();
+    for (const name of targetNames) {
+        const targetFiles = resolvedTargets.get(name);
+        if (targetFiles) {
+            for (const f of targetFiles)
+                files.add(f);
+        }
+    }
+    return [...files].sort();
+}
+// =============================================================================
+// Global excludes
+// =============================================================================
+function applyGlobalExcludes(files, rootDir, globalExcludes) {
+    if (globalExcludes.length === 0)
+        return files;
+    return files.filter((filePath) => {
+        const relativePath = relative(rootDir, filePath);
+        return !globalExcludes.some((pattern) => minimatch(relativePath, pattern, { dot: true }));
+    });
+}
+// =============================================================================
+// Per-check resolution (pure in-memory, no I/O)
+// =============================================================================
+/**
+ * Resolve file paths for a single check using pre-resolved target files.
+ *
+ * Resolution order:
+ * 1. If checkOverrides has an entry for this slug, use those target(s) directly
+ * 2. If scope is declared, match against all targets by languages + concerns
+ * 3. If no scope and no override, return undefined (check uses file cache fallback)
+ *
+ * When pre-resolved targets are provided (from buildScopeBasedFileMap), globalExcludes
+ * have already been applied during pre-resolution and are skipped here.
+ * When called without pre-resolved targets (single-check fallback), globalExcludes
+ * are applied after direct globbing.
+ */
+function resolveFilesForCheck(slug, scope, registry, config, rootDir, resolvedTargets) {
+    const { globalExcludes, checkOverrides } = config;
+    // When resolvedTargets is provided, globalExcludes are pre-applied — skip re-filtering
+    const maybeApplyExcludes = (files) => resolvedTargets ? files : applyGlobalExcludes(files, rootDir, globalExcludes);
+    // Use pre-resolved cache when available, otherwise fall back to direct glob
+    const lookupFiles = (targetRef) => {
+        const names = typeof targetRef === 'string' ? [targetRef] : targetRef;
+        if (resolvedTargets) {
+            return unionTargetFiles(names, resolvedTargets);
+        }
+        // Fallback: resolve directly (single-check mode without precomputed cache)
+        const targets = names
+            .map((name) => registry.getByName(name))
+            .filter((t) => t !== undefined);
+        const files = new Set();
+        for (const target of targets) {
+            for (const f of resolveTargetGlobs(target, rootDir))
+                files.add(f);
+        }
+        return [...files].sort();
+    };
+    // 1. Check overrides take priority (for marketplace/third-party checks)
+    const override = checkOverrides[slug];
+    if (override) {
+        return maybeApplyExcludes(lookupFiles(override));
+    }
+    // 2. Scope-based matching
+    if (scope && (scope.languages.length > 0 || scope.concerns.length > 0)) {
+        const matchedTargets = registry.findByScope(scope.languages, scope.concerns);
+        if (matchedTargets.length === 0) {
+            return [];
+        }
+        const names = matchedTargets.map((t) => t.config.name);
+        return maybeApplyExcludes(lookupFiles(names));
+    }
+    // 3. No scope, no override — undefined signals "use file cache fallback"
+    return undefined;
+}
+/**
+ * Build the complete check-to-files map for all checks with scopes or overrides.
+ *
+ * All targets are globbed once upfront. Per-check resolution is a pure
+ * in-memory lookup against the pre-resolved file lists.
+ */
+export function buildScopeBasedFileMap(checks, registry, config, rootDir) {
+    // Pre-resolve all targets once — deduplicated glob pass across all targets.
+    // GlobalExcludes are applied during pre-resolution so per-check lookups are pure in-memory.
+    const resolvedTargets = preResolveAllTargets(registry, config, rootDir);
+    const result = new Map();
+    for (const check of checks) {
+        const files = resolveFilesForCheck(check.slug, check.scope, registry, config, rootDir, resolvedTargets);
+        if (files !== undefined) {
+            result.set(check.slug, files);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=scope-resolver.js.map

package/dist/framework/scope-resolver.js.map

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

package/dist/framework/severity-mapping.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Shared severity and category mapping for fitness checks
+ *
+ * Maps FindingSeverity to SignalSeverity and check category strings
+ * to SignalCategory. Used by defineCheck and PatternDetector.
+ */
+import type { FindingSeverity } from '../types/findings.js';
+import type { SignalSeverity, SignalCategory } from '@opensip-tools/core';
+/** Map FindingSeverity to SignalSeverity */
+export declare function mapFindingSeverity(severity: FindingSeverity): SignalSeverity;
+/** Map check tags to SignalCategory (first matching tag wins) */
+export declare function mapTagsToSignalCategory(tags: readonly string[]): SignalCategory;
+//# sourceMappingURL=severity-mapping.d.ts.map

package/dist/framework/severity-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity-mapping.d.ts","sourceRoot":"","sources":["../../src/framework/severity-mapping.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAGzE,4CAA4C;AAC5C,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,cAAc,CAY5E;AAED,iEAAiE;AACjE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CA2B/E"}

package/dist/framework/severity-mapping.js

@@ -0,0 +1,51 @@
+// @fitness-ignore-file project-readme-existence -- internal module, not a package root
+/**
+ * @fileoverview Shared severity and category mapping for fitness checks
+ *
+ * Maps FindingSeverity to SignalSeverity and check category strings
+ * to SignalCategory. Used by defineCheck and PatternDetector.
+ */
+/** Map FindingSeverity to SignalSeverity */
+export function mapFindingSeverity(severity) {
+    switch (severity) {
+        case 'error': {
+            return 'high';
+        }
+        case 'warning': {
+            return 'medium';
+        }
+        default: {
+            return 'medium';
+        }
+    }
+}
+/** Map check tags to SignalCategory (first matching tag wins) */
+export function mapTagsToSignalCategory(tags) {
+    for (const tag of tags) {
+        switch (tag) {
+            case 'security': {
+                return 'security';
+            }
+            case 'performance': {
+                return 'performance';
+            }
+            case 'architecture': {
+                return 'architecture';
+            }
+            case 'quality': {
+                return 'warning';
+            }
+            case 'resilience': {
+                return 'resilience';
+            }
+            case 'testing': {
+                return 'testing';
+            }
+            case 'documentation': {
+                return 'documentation';
+            }
+        }
+    }
+    return 'warning';
+}
+//# sourceMappingURL=severity-mapping.js.map

package/dist/framework/severity-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity-mapping.js","sourceRoot":"","sources":["../../src/framework/severity-mapping.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF;;;;;GAKG;AAMH,4CAA4C;AAC5C,MAAM,UAAU,kBAAkB,CAAC,QAAyB;IAC1D,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,OAAO,MAAM,CAAA;QACf,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,OAAO,QAAQ,CAAA;QACjB,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,OAAO,QAAQ,CAAA;QACjB,CAAC;IACH,CAAC;AACH,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,uBAAuB,CAAC,IAAuB;IAC7D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,OAAO,UAAU,CAAA;YACnB,CAAC;YACD,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,OAAO,aAAa,CAAA;YACtB,CAAC;YACD,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,OAAO,cAAc,CAAA;YACvB,CAAC;YACD,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,OAAO,SAAS,CAAA;YAClB,CAAC;YACD,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,OAAO,YAAY,CAAA;YACrB,CAAC;YACD,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,OAAO,SAAS,CAAA;YAClB,CAAC;YACD,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,OAAO,eAAe,CAAA;YACxB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/framework/strip-literals.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Shared utilities for stripping string literal and comment
+ * content from source code. Used by fitness checks to avoid false positives
+ * from patterns appearing inside string literals or comments.
+ */
+/**
+ * Strip string literal contents from a single line.
+ * Replaces content inside '...', "...", and `...` with empty strings.
+ * Used by checks for per-line pattern matching to avoid false positives
+ * from patterns appearing inside string literals.
+ */
+export declare function stripStringLiterals(line: string): string;
+/**
+ * Strip string literals and single-line comments from full file content.
+ * Used by checks for quick-filter gates to avoid matching keywords
+ * that only appear in documentation strings or comments.
+ */
+/**
+ * Check if a position in a line is inside a string literal.
+ * Scans characters before the match position for unescaped quotes/backticks.
+ * Used by checks to avoid false positives from suggestion/description text.
+ */
+export declare function isInsideStringLiteral(line: string, matchIndex: number): boolean;
+/**
+ * Strip string literals and single-line comments from full file content.
+ * Used by checks for quick-filter gates to avoid matching keywords
+ * that only appear in documentation strings or comments.
+ */
+export declare function stripStringsAndComments(content: string): string;
+/**
+ * Strip strings, single-line comments, AND block comments while preserving
+ * BOTH character positions and line numbers. Each stripped character is
+ * replaced with a space (non-newline) so the output has identical length
+ * and line offsets to the input. Use this when downstream processing
+ * needs to map a match index back to a line number in the ORIGINAL
+ * source — `stripStringsAndComments` collapses string literals to empty
+ * pairs, which shifts indexes and breaks `getLineNumber(content, idx)`.
+ *
+ * Strips:
+ * - Single-quoted, double-quoted, and template-literal string contents
+ * - Single-line `// ...` comments (to end of line)
+ * - Block `/* ... *\/` comments (including JSDoc `/** ... *\/`)
+ *
+ * Preserves: newlines, total character count, character positions of
+ * code OUTSIDE these regions.
+ */
+export declare function stripStringsAndCommentsPreservingPositions(content: string): string;
+//# sourceMappingURL=strip-literals.d.ts.map

package/dist/framework/strip-literals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-literals.d.ts","sourceRoot":"","sources":["../../src/framework/strip-literals.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKxD;AAOD;;;;GAIG;AACH;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAyB/E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAU/D;AAED;;;;;;;;;;;;;;;;GAgBG;AAEH,wBAAgB,0CAA0C,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAuGlF"}