@opensip-tools/fitness 1.0.4

package/dist/framework/check-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-types.d.ts","sourceRoot":"","sources":["../../src/framework/check-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAIjE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7C,QAAQ,CAAC,YAAY,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAA;IAC3D,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAA;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IAClD,wEAAwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,WAAW,CAAC,CAAA;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,CAAA;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,aAAa,CAAA;IACtC,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,CAAA;CAClD;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAatD;AAED,OAAO,EAAC,KAAK,aAAa,EAAC,MAAM,mBAAmB,CAAA"}

package/dist/framework/check-types.js

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Core type definitions for fitness checks
+ *
+ * Check interface is the return type of defineCheck.
+ * CheckConfig represents the internal configuration structure.
+ * CheckResult carries Signal[].
+ */
+/**
+ * Type guard: is this value a Check object?
+ *
+ * Checks for the shape of a Check object:
+ * - Has a `config` property that is an object
+ * - config has an `id` property that is a string
+ * - config has a `slug` property that is a string
+ * - config has an `execute` property that is a function
+ * - Has a `run` property that is a function
+ */
+export function isCheck(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const obj = value;
+    if (!obj.config || typeof obj.config !== 'object')
+        return false;
+    const config = obj.config;
+    if (typeof config.id !== 'string')
+        return false;
+    if (typeof config.slug !== 'string')
+        return false;
+    if (typeof config.execute !== 'function')
+        return false;
+    if (typeof obj.run !== 'function')
+        return false;
+    return true;
+}
+//# sourceMappingURL=check-types.js.map

package/dist/framework/check-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-types.js","sourceRoot":"","sources":["../../src/framework/check-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6CH;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAE7D,MAAM,GAAG,GAAG,KAAgC,CAAA;IAC5C,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAE/D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAiC,CAAA;IACpD,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC/C,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACjD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU;QAAE,OAAO,KAAK,CAAA;IACtD,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,UAAU;QAAE,OAAO,KAAK,CAAA;IAE/C,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/framework/command-executor.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Command executor for external tool checks
+ *
+ * Executes external commands (eslint, prettier, etc.) with abort
+ * and timeout support, then parses output into violations.
+ */
+import type { CheckViolation, CommandConfig } from './check-config.js';
+/** Options for executing an external command. */
+export interface CommandExecutorOptions {
+    readonly cwd: string;
+    readonly signal?: AbortSignal | undefined;
+    readonly timeout?: number | undefined;
+}
+/** Result of executing an external command, including parsed violations. */
+export interface CommandExecutionResult {
+    readonly violations: CheckViolation[];
+    readonly aborted: boolean;
+    readonly exitCode: number | null;
+    readonly error?: string;
+}
+/**
+ * Execute an external command and parse its output into violations.
+ */
+export declare function executeCommand(config: CommandConfig, files: readonly string[], options: CommandExecutorOptions): Promise<CommandExecutionResult>;
+//# sourceMappingURL=command-executor.d.ts.map

package/dist/framework/command-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-executor.d.ts","sourceRoot":"","sources":["../../src/framework/command-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAMtE,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACtC;AAED,4EAA4E;AAC5E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,cAAc,EAAE,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAQD;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAuDjC"}

package/dist/framework/command-executor.js

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview Command executor for external tool checks
+ *
+ * Executes external commands (eslint, prettier, etc.) with abort
+ * and timeout support, then parses output into violations.
+ */
+import { execAbortable } from './abortable-exec.js';
+// =============================================================================
+// EXECUTOR
+// =============================================================================
+const DEFAULT_EXPECTED_EXIT_CODES = [0, 1];
+/**
+ * Execute an external command and parse its output into violations.
+ */
+export async function executeCommand(config, files, options) {
+    const { cwd, signal, timeout } = options;
+    const args = typeof config.args === 'function' ? config.args(files) : config.args;
+    const command = [config.bin, ...args];
+    const execOptions = { cwd, signal, timeout };
+    let result;
+    try {
+        result = await execAbortable(command, execOptions);
+    }
+    catch (error) {
+        // ENOENT = tool not installed (spawn fails before the process starts)
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.includes('ENOENT') || message.includes('not found')) {
+            return {
+                violations: [],
+                aborted: false,
+                exitCode: null,
+                error: `${config.bin} is not installed. Install it to enable this check.`,
+            };
+        }
+        throw error;
+    }
+    if (result.aborted) {
+        return { violations: [], aborted: true, exitCode: result.exitCode };
+    }
+    // Exit code 127 = command not found (shell mode)
+    if (result.exitCode === 127) {
+        return {
+            violations: [],
+            aborted: false,
+            exitCode: 127,
+            error: `${config.bin} is not installed. Install it to enable this check.`,
+        };
+    }
+    const expectedCodes = config.expectedExitCodes ?? DEFAULT_EXPECTED_EXIT_CODES;
+    if (result.exitCode !== null && !expectedCodes.includes(result.exitCode)) {
+        return {
+            violations: [],
+            aborted: false,
+            exitCode: result.exitCode,
+            error: `Command exited with unexpected code ${result.exitCode}. ` +
+                `Expected one of: ${expectedCodes.join(', ')}. ` +
+                `stderr: ${result.stderr.slice(0, 500)}${result.stderr.length > 500 ? ' [truncated]' : ''}`,
+        };
+    }
+    const violations = config.parseOutput(result.stdout, result.stderr, result.exitCode ?? 0, files, cwd);
+    return { violations, aborted: false, exitCode: result.exitCode };
+}
+//# sourceMappingURL=command-executor.js.map

package/dist/framework/command-executor.js.map

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

package/dist/framework/constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Shared constants for the fitness framework
+ */
+/**
+ * Standard exclusion patterns for file matching across the framework.
+ * Used by execution context, directive inventory, and file cache.
+ */
+export declare const DEFAULT_EXCLUSION_PATTERNS: readonly ["**/node_modules/**", "**/dist/**", "**/.git/**", "**/coverage/**", "**/*.tsbuildinfo"];
+//# sourceMappingURL=constants.d.ts.map

package/dist/framework/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/framework/constants.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B,mGAM7B,CAAA"}

package/dist/framework/constants.js

@@ -0,0 +1,16 @@
+// @fitness-ignore-file project-readme-existence -- internal module, not a package root
+/**
+ * @fileoverview Shared constants for the fitness framework
+ */
+/**
+ * Standard exclusion patterns for file matching across the framework.
+ * Used by execution context, directive inventory, and file cache.
+ */
+export const DEFAULT_EXCLUSION_PATTERNS = [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/.git/**',
+    '**/coverage/**',
+    '**/*.tsbuildinfo',
+];
+//# sourceMappingURL=constants.js.map

package/dist/framework/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/framework/constants.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF;;GAEG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,oBAAoB;IACpB,YAAY;IACZ,YAAY;IACZ,gBAAgB;IAChB,kBAAkB;CACV,CAAA"}

package/dist/framework/content-filter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview TypeScript scanner-based content filtering
+ *
+ * Uses the TypeScript scanner (not full AST parser) to identify string literal
+ * and comment regions. String content is replaced with spaces of equal length,
+ * preserving line/column positions for accurate violation reporting.
+ */
+/** Content processed by the TypeScript scanner with string/comment region tracking */
+export interface FilteredContent {
+    /** Content with string literals replaced by whitespace of equal length */
+    readonly code: string;
+    /**
+     * Content with both string literals AND comments replaced by whitespace
+     * of equal length. Use when a check pattern-matches identifiers via regex
+     * and would otherwise false-positive on banned-call references that
+     * appear in JSDoc / line / block comments documenting the rule
+     * (e.g. ``"Replace getDatabase() with the constructor StoreDeps"`` inside
+     * a doc string).
+     */
+    readonly codeNoComments: string;
+    /** Original content (unchanged) */
+    readonly raw: string;
+    /** Set of line numbers (1-based) that are entirely inside comments */
+    readonly commentLines: ReadonlySet<number>;
+    /** Check if a (1-based line, 0-based column) position is inside a string literal */
+    readonly isInString: (line: number, column: number) => boolean;
+    /** Check if a (1-based line, 0-based column) position is inside a comment */
+    readonly isInComment: (line: number, column: number) => boolean;
+}
+/** Clear the filter cache (call between runs or on memory pressure) */
+export declare function clearFilterCache(): void;
+export declare function filterContent(content: string): FilteredContent;
+//# sourceMappingURL=content-filter.d.ts.map

package/dist/framework/content-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-filter.d.ts","sourceRoot":"","sources":["../../src/framework/content-filter.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAUH,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,mCAAmC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1C,oFAAoF;IACpF,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;IAC9D,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;CAChE;AA+GD,uEAAuE;AACvE,wBAAgB,gBAAgB,IAAI,IAAI,CAMvC;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CA0B9D"}

package/dist/framework/content-filter.js

@@ -0,0 +1,236 @@
+// @fitness-ignore-file file-length-limits -- framework/content-filter complexity requires single-file cohesion
+/**
+ * @fileoverview TypeScript scanner-based content filtering
+ *
+ * Uses the TypeScript scanner (not full AST parser) to identify string literal
+ * and comment regions. String content is replaced with spaces of equal length,
+ * preserving line/column positions for accurate violation reporting.
+ */
+import { logger } from '@opensip-tools/core';
+import ts from 'typescript';
+// =============================================================================
+// HELPERS
+// =============================================================================
+/** Build an array of byte offsets where each line starts. */
+function buildLineStarts(content) {
+    const lineStarts = [0];
+    // eslint-disable-next-line unicorn/no-for-loop -- offset-bearing scan: stores UTF-16 indexes
+    for (let i = 0; i < content.length; i++) {
+        if (content[i] === '\n')
+            lineStarts.push(i + 1);
+    }
+    return lineStarts;
+}
+/**
+ * Build a set of 1-based line numbers from a list of regions.
+ * A line is included if any part of it falls within a region.
+ */
+function linesToSet(content, regions) {
+    if (regions.length === 0)
+        return new Set();
+    const lineStarts = buildLineStarts(content);
+    const result = new Set();
+    for (const region of regions) {
+        for (let lineIdx = 0; lineIdx < lineStarts.length; lineIdx++) {
+            const lineStart = lineStarts[lineIdx];
+            const lineEnd = lineIdx + 1 < lineStarts.length ? lineStarts[lineIdx + 1] - 1 : content.length;
+            if (lineStart > region.end)
+                break;
+            if (lineEnd >= region.start) {
+                result.add(lineIdx + 1); // 1-based
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Check if a (1-based line, 0-based column) offset falls within any region.
+ */
+function isInRegions(content, regions, line, column) {
+    if (regions.length === 0)
+        return false;
+    // Convert line/column to byte offset
+    let currentLine = 1;
+    let lineStart = 0;
+    // eslint-disable-next-line unicorn/no-for-loop -- offset-bearing scan: captures UTF-16 line start
+    for (let i = 0; i < content.length; i++) {
+        if (currentLine === line) {
+            lineStart = i;
+            break;
+        }
+        if (content[i] === '\n')
+            currentLine++;
+    }
+    if (currentLine !== line)
+        return false;
+    const offset = lineStart + column;
+    for (const region of regions) {
+        if (offset >= region.start && offset < region.end)
+            return true;
+    }
+    return false;
+}
+/**
+ * Replace characters in the given range with spaces, preserving newlines.
+ * Records the range as a string region.
+ */
+function replaceCharsInRange(chars, start, end, stringRegions) {
+    stringRegions.push({ start, end });
+    for (let i = start; i < end; i++) {
+        if (chars[i] !== '\n')
+            chars[i] = ' ';
+    }
+}
+// =============================================================================
+// MAIN
+// =============================================================================
+/**
+ * Scan content using TypeScript's scanner to identify string and comment regions.
+ *
+ * String literals are replaced with spaces of equal length, preserving
+ * line/column positions. Comments are tracked but not removed (directives
+ * live in comments and must be preserved).
+ */
+// Module-level cache to avoid re-running the TS scanner on the same content.
+// Bounded by an idle timer (10 min, matching parse-cache.ts) so long-lived
+// embedders don't accumulate cached filter results across runs forever. The
+// timer resets each time filterContent runs, so an active session never
+// loses its cache.
+const FILTER_CACHE_IDLE_TIMEOUT_MS = 10 * 60 * 1000;
+const filterCache = new Map();
+let filterCacheIdleTimer = null;
+function scheduleFilterCacheClear() {
+    if (filterCacheIdleTimer)
+        clearTimeout(filterCacheIdleTimer);
+    filterCacheIdleTimer = setTimeout(() => {
+        filterCache.clear();
+        filterCacheIdleTimer = null;
+    }, FILTER_CACHE_IDLE_TIMEOUT_MS);
+    filterCacheIdleTimer.unref();
+}
+/** Clear the filter cache (call between runs or on memory pressure) */
+export function clearFilterCache() {
+    filterCache.clear();
+    if (filterCacheIdleTimer) {
+        clearTimeout(filterCacheIdleTimer);
+        filterCacheIdleTimer = null;
+    }
+}
+export function filterContent(content) {
+    const cached = filterCache.get(content);
+    if (cached) {
+        scheduleFilterCacheClear();
+        return cached;
+    }
+    try {
+        const result = filterContentImpl(content);
+        filterCache.set(content, result);
+        scheduleFilterCacheClear();
+        return result;
+    }
+    catch {
+        // Graceful degradation — return raw content if scanner fails
+        logger.debug('Content filter fell back to raw content', { evt: 'fitness.content_filter.fallback', module: 'fitness:framework' });
+        const fallback = {
+            code: content,
+            codeNoComments: content,
+            raw: content,
+            commentLines: new Set(),
+            isInString: () => false,
+            isInComment: () => false,
+        };
+        filterCache.set(content, fallback);
+        return fallback;
+    }
+}
+// eslint-disable-next-line sonarjs/cognitive-complexity -- TS scanner driver: token-by-token loop with per-kind handling; flatter shape would scatter token classification
+function filterContentImpl(content) {
+    const scanner = ts.createScanner(ts.ScriptTarget.Latest, false, ts.LanguageVariant.Standard, content);
+    const stringRegions = [];
+    const commentRegions = [];
+    const chars = [...content];
+    // Depth counter, not a boolean — a `${ `inner` }` construct nests two templates
+    // and each `}` that closes a template-expression must be rescanned. A plain
+    // boolean flipped off by the inner TemplateTail would leave the outer unrescanned
+    // and desync the scanner for the rest of the file (which silently wipes real
+    // code to whitespace). Incremented at TemplateHead, decremented at TemplateTail.
+    let templateDepth = 0;
+    while (true) {
+        let token = scanner.scan();
+        // @fitness-ignore-next-line unsafe-secret-comparison -- comparing TypeScript SyntaxKind enum, not a secret
+        if (token === ts.SyntaxKind.EndOfFileToken)
+            break;
+        // After a CloseBraceToken inside ANY template expression, rescan to get TemplateMiddle/TemplateTail
+        // @fitness-ignore-next-line unsafe-secret-comparison -- comparing TypeScript SyntaxKind enum, not a secret
+        if (token === ts.SyntaxKind.CloseBraceToken && templateDepth > 0) {
+            token = scanner.reScanTemplateToken(false);
+        }
+        const start = scanner.getTokenStart();
+        const end = scanner.getTokenEnd();
+        switch (token) {
+            case ts.SyntaxKind.StringLiteral:
+            case ts.SyntaxKind.NoSubstitutionTemplateLiteral: {
+                // Replace content inside quotes/backticks (keep delimiters)
+                replaceCharsInRange(chars, start + 1, end - 1, stringRegions);
+                break;
+            }
+            case ts.SyntaxKind.TemplateHead: {
+                // `text ${ — replace text between ` and ${
+                templateDepth++;
+                replaceCharsInRange(chars, start + 1, end - 2, stringRegions);
+                break;
+            }
+            case ts.SyntaxKind.TemplateMiddle: {
+                // }text ${ — replace text between } and ${
+                replaceCharsInRange(chars, start + 1, end - 2, stringRegions);
+                break;
+            }
+            case ts.SyntaxKind.TemplateTail: {
+                // }text` — replace text between } and `
+                templateDepth--;
+                replaceCharsInRange(chars, start + 1, end - 1, stringRegions);
+                break;
+            }
+            case ts.SyntaxKind.SingleLineCommentTrivia:
+            case ts.SyntaxKind.MultiLineCommentTrivia: {
+                // Track comment regions but don't modify content
+                commentRegions.push({ start, end });
+                break;
+            }
+            // RegularExpressionLiteral — leave unchanged, regex is code
+            default: {
+                break;
+            }
+        }
+    }
+    const code = chars.join('');
+    const commentLines = linesToSet(content, commentRegions);
+    // Compute `codeNoComments` by additionally replacing comment regions
+    // with whitespace. Done as a second pass on a fresh array so `code`
+    // (strings-stripped only) and `codeNoComments` (strings + comments
+    // stripped) remain available — most checks want one or the other,
+    // not both.
+    const charsNoComments = [...content];
+    for (const region of stringRegions) {
+        for (let i = region.start; i < region.end; i++) {
+            if (charsNoComments[i] !== '\n')
+                charsNoComments[i] = ' ';
+        }
+    }
+    for (const region of commentRegions) {
+        for (let i = region.start; i < region.end; i++) {
+            if (charsNoComments[i] !== '\n')
+                charsNoComments[i] = ' ';
+        }
+    }
+    const codeNoComments = charsNoComments.join('');
+    return {
+        code,
+        codeNoComments,
+        raw: content,
+        commentLines,
+        isInString: (line, column) => isInRegions(content, stringRegions, line, column),
+        isInComment: (line, column) => isInRegions(content, commentRegions, line, column),
+    };
+}
+//# sourceMappingURL=content-filter.js.map

package/dist/framework/content-filter.js.map

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

package/dist/framework/define-check.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview defineCheck - Unified check definition API
+ *
+ * The main API for creating fitness checks. Supports three modes:
+ * - analyze: Per-file analysis with content and path
+ * - analyzeAll: Multi-file analysis with lazy loading FileAccessor
+ * - command: External tool execution with output parsing
+ *
+ * Check authors return CheckViolation[]. The framework converts each
+ * CheckViolation into a universal Signal via createSignal().
+ */
+import type { UnifiedCheckConfig } from './check-config.js';
+import type { Check } from './check-types.js';
+/**
+ * Define a fitness check using the unified API.
+ *
+ * @example
+ * ```typescript
+ * export const noConsoleLog = defineCheck({
+ *   id: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ *   slug: 'no-console-log',
+ *   category: 'quality',
+ *   description: 'Disallow console.log in production code',
+ *   analyze: (content, filePath) => {
+ *     const violations: CheckViolation[] = [];
+ *     content.split('\n').forEach((line, idx) => {
+ *       if (line.includes('console.log')) {
+ *         violations.push({ line: idx + 1, message: 'No console.log', severity: 'error' });
+ *       }
+ *     });
+ *     return violations;
+ *   },
+ * });
+ * ```
+ * @throws {ValidationError} When the check config is invalid
+ */
+export declare function defineCheck(config: UnifiedCheckConfig): Check;
+//# sourceMappingURL=define-check.d.ts.map

package/dist/framework/define-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-check.d.ts","sourceRoot":"","sources":["../../src/framework/define-check.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAsBH,OAAO,KAAK,EACV,kBAAkB,EAKnB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAyJ7C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,KAAK,CAyF7D"}