@opensip-cli/fitness 0.1.0

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

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

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

@@ -0,0 +1,160 @@
+/**
+ * @fileoverview defineRegexListCheck - Template helper for regex-list scanners.
+ *
+ * Wraps {@link defineCheck} for the common "for line; for pattern; emit one
+ * violation per match" shape that ~13 sites in @opensip-cli/checks-universal
+ * (and a handful in @opensip-cli/checks-typescript) reimplement, often with
+ * subtly different `lastIndex`-reset, comment-skip, and test-file-skip
+ * semantics.
+ *
+ * Adopters declare patterns with {@link RegexListCheckPattern} tuples; this
+ * helper handles iteration, regex state reset, optional comment/test-file
+ * skipping, and per-pattern slug tagging in the violation `type` field.
+ *
+ * The shape mirrors the existing `no-console-log.ts` reference: each pattern
+ * has its own `id` (UUID) and `slug`. The pattern's `slug` is emitted on
+ * each violation as `type: pattern.slug`, matching the established
+ * convention used by `heavy-import-detection` (`type: 'HEAVY_IMPORT' | ...`).
+ * The `id` is purely descriptive metadata for the pattern author and is
+ * not added to violation output.
+ *
+ * @example
+ * ```typescript
+ * export const noConsoleLog = defineRegexListCheck({
+ *   id: '86403377-5903-478a-bdf2-e4f2f17df39f',
+ *   slug: 'no-console-log',
+ *   description: 'Disallow console.log in production code',
+ *   tags: ['logging', 'quality'],
+ *   scope: { languages: ['typescript'], concerns: ['backend'] },
+ *   fileTypes: ['ts'],
+ *   contentFilter: 'strip-strings',
+ *   options: { skipCommentLines: true },
+ *   patterns: [
+ *     {
+ *       id: '38b2df63-54c3-4ab9-8a4d-5050384fa56b',
+ *       slug: 'console-log',
+ *       regex: /console\.log\s{0,10}\(/g,
+ *       message: 'console.log detected',
+ *       suggestion: 'Use a structured logger',
+ *     },
+ *     // ... more patterns
+ *   ],
+ * })
+ * ```
+ */
+import type { CheckScope } from './check-config.js';
+import type { Check } from './check-types.js';
+/**
+ * A single regex pattern entry consumed by {@link defineRegexListCheck}.
+ *
+ * Each entry has a stable UUID `id` and a kebab-case `slug` so the pattern
+ * is individually addressable for documentation and developer tooling. The
+ * `slug` is emitted on every produced violation as `type: pattern.slug`.
+ *
+ * @remarks Per-pattern attribution (e.g. an Aristotle SDO/SAX `provider`)
+ * is intentionally NOT modelled here. The `provider` on
+ * {@link DefineRegexListCheckConfig} is **check-level only** — every
+ * pattern in a single helper invocation shares the same provider. Splitting
+ * a pattern list into two helpers is the supported workaround when one
+ * subset needs distinct attribution. A per-pattern field will be added
+ * if/when a real driver appears (audit 2026-05-23 F1).
+ */
+export interface RegexListCheckPattern {
+    /** Stable UUID identifying this pattern. Purely descriptive. */
+    readonly id: string;
+    /** Kebab-case slug for this pattern (e.g. `'console-log'`). Emitted as `type` on each violation. */
+    readonly slug: string;
+    /** Regex executed against each (non-skipped) line. Global flag is recommended for multi-match-per-line behaviour. */
+    readonly regex: RegExp;
+    /** Violation message reported on a match. */
+    readonly message: string;
+    /** Optional suggestion text for the violation. */
+    readonly suggestion?: string;
+    /**
+     * Per-pattern severity. Defaults to `'warning'`. Pattern-level severity
+     * is preferred over a per-check default because most adopters mix
+     * error-class and warning-class patterns inside the same regex list.
+     */
+    readonly severity?: 'error' | 'warning';
+}
+/**
+ * Options governing line iteration in {@link defineRegexListCheck}.
+ */
+export interface RegexListCheckOptions {
+    /**
+     * Skip lines that {@link isCommentLine} reports as comments.
+     * Default: `true`.
+     */
+    readonly skipCommentLines?: boolean;
+    /**
+     * Skip files that {@link isTestFile} reports as test files. Useful for
+     * checks that should not run against `*.test.ts` / `*.spec.ts` /
+     * `__tests__/` paths.
+     * Default: `false`.
+     */
+    readonly skipTestFiles?: boolean;
+    /**
+     * Custom file-path predicate. When provided AND it returns `true`,
+     * the file is skipped entirely. Used by sites with site-specific
+     * allowlists that the helper does not model (e.g. CLI-output paths
+     * like `/commands/`, `/display/`, `/bin/`).
+     *
+     * The predicate runs once per file before any line iteration.
+     */
+    readonly skipFile?: (filePath: string) => boolean;
+    /**
+     * Additional per-line skip predicate evaluated AFTER comment/test
+     * filters but BEFORE pattern matching. Use for site-specific filters
+     * the helper doesn't model (e.g. `no-window-alert` skips lines
+     * starting with `import `).
+     */
+    readonly skipLine?: (trimmedLine: string, rawLine: string) => boolean;
+    /**
+     * When `true`, after a violation is emitted on a line, skip remaining
+     * patterns for that line — at most one violation per line in total.
+     * Use for sites that historically emit one violation per line across
+     * all patterns (e.g. `no-window-alert`, `no-eval`).
+     *
+     * Note this short-circuits at the line level, NOT the pattern level:
+     * within a single pattern's match loop (relevant only for global
+     * regexes), multiple matches are still emitted before the next line
+     * starts. Combine with non-global regexes for true "one per line".
+     *
+     * Default: `false` (each matching pattern emits its own violation).
+     */
+    readonly oneViolationPerLine?: boolean;
+}
+/**
+ * Configuration accepted by {@link defineRegexListCheck}.
+ *
+ * The fields above `patterns` mirror {@link defineCheck}'s analyze-mode
+ * `BaseCheckConfig`. The `analyze` function is synthesised by this helper.
+ */
+export interface DefineRegexListCheckConfig {
+    readonly id: string;
+    readonly slug: string;
+    readonly description: string;
+    readonly longDescription?: string;
+    readonly tags: readonly string[];
+    readonly scope?: CheckScope;
+    readonly fileTypes?: readonly string[];
+    readonly contentFilter?: 'raw' | 'strip-strings' | 'strip-strings-and-comments';
+    readonly confidence?: 'high' | 'medium' | 'low';
+    readonly disabled?: boolean;
+    readonly timeout?: number;
+    readonly docs?: string;
+    /**
+     * Aristotle SDO/SAX provider attribution applied to every pattern in
+     * this check. **Check-level only** — there is no per-pattern override.
+     * If two pattern subsets need distinct attribution, define them as two
+     * separate checks (audit 2026-05-23 F1).
+     */
+    readonly provider?: string;
+    /** The list of regex patterns to scan each line against. */
+    readonly patterns: readonly RegexListCheckPattern[];
+    /** Line- and file-level skip toggles. */
+    readonly options?: RegexListCheckOptions;
+}
+/** Factory for the common "scan each line against a regex list" check pattern. */
+export declare function defineRegexListCheck(config: DefineRegexListCheckConfig): Check;
+//# sourceMappingURL=define-regex-list-check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-regex-list-check.d.ts","sourceRoot":"","sources":["../../src/framework/define-regex-list-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oGAAoG;IACpG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qHAAqH;IACrH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAClD;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACtE;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,GAAG,eAAe,GAAG,4BAA4B,CAAC;IAChF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACpD,yCAAyC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;CAC1C;AAqHD,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,0BAA0B,GAAG,KAAK,CAmC9E"}

package/dist/framework/define-regex-list-check.js

@@ -0,0 +1,177 @@
+/**
+ * @fileoverview defineRegexListCheck - Template helper for regex-list scanners.
+ *
+ * Wraps {@link defineCheck} for the common "for line; for pattern; emit one
+ * violation per match" shape that ~13 sites in @opensip-cli/checks-universal
+ * (and a handful in @opensip-cli/checks-typescript) reimplement, often with
+ * subtly different `lastIndex`-reset, comment-skip, and test-file-skip
+ * semantics.
+ *
+ * Adopters declare patterns with {@link RegexListCheckPattern} tuples; this
+ * helper handles iteration, regex state reset, optional comment/test-file
+ * skipping, and per-pattern slug tagging in the violation `type` field.
+ *
+ * The shape mirrors the existing `no-console-log.ts` reference: each pattern
+ * has its own `id` (UUID) and `slug`. The pattern's `slug` is emitted on
+ * each violation as `type: pattern.slug`, matching the established
+ * convention used by `heavy-import-detection` (`type: 'HEAVY_IMPORT' | ...`).
+ * The `id` is purely descriptive metadata for the pattern author and is
+ * not added to violation output.
+ *
+ * @example
+ * ```typescript
+ * export const noConsoleLog = defineRegexListCheck({
+ *   id: '86403377-5903-478a-bdf2-e4f2f17df39f',
+ *   slug: 'no-console-log',
+ *   description: 'Disallow console.log in production code',
+ *   tags: ['logging', 'quality'],
+ *   scope: { languages: ['typescript'], concerns: ['backend'] },
+ *   fileTypes: ['ts'],
+ *   contentFilter: 'strip-strings',
+ *   options: { skipCommentLines: true },
+ *   patterns: [
+ *     {
+ *       id: '38b2df63-54c3-4ab9-8a4d-5050384fa56b',
+ *       slug: 'console-log',
+ *       regex: /console\.log\s{0,10}\(/g,
+ *       message: 'console.log detected',
+ *       suggestion: 'Use a structured logger',
+ *     },
+ *     // ... more patterns
+ *   ],
+ * })
+ * ```
+ */
+import { isCommentLine } from '../check-utils/source-analysis.js';
+import { isTestFile } from '../check-utils/test-helpers.js';
+import { defineCheck } from './define-check.js';
+/**
+ * Build a {@link Check} that scans every line of every matched file
+ * against a list of regex patterns and emits one violation per match.
+ *
+ * Iteration semantics:
+ *  - For each line in the file content (split on `\n`).
+ *  - Optionally skip lines that {@link isCommentLine} flags as comments
+ *    (controlled by `options.skipCommentLines`, default `true`).
+ *  - For each pattern: reset `pattern.regex.lastIndex = 0`, then iterate
+ *    `pattern.regex.exec(line)` until it returns `null`. This produces
+ *    one violation per match for global-flag regexes, and exactly one
+ *    violation when the regex has no global flag (because non-global
+ *    `exec` always starts at position 0). Resetting `lastIndex` is
+ *    required because pattern objects are reused across lines and
+ *    files; the audit notes several existing sites get this wrong.
+ *
+ * Optionally skip whole files when `options.skipTestFiles` is `true` and
+ * {@link isTestFile} returns true for the file path.
+ *
+ * @remarks This helper synthesises only `defineCheck`'s **per-file
+ * `analyze` mode** — it processes one file at a time, with no awareness
+ * of cross-file state. Cross-file regex-list semantics (e.g. correlated
+ * patterns across `package.json` + `Dockerfile`) are out of scope; an
+ * `analyzeAll`-mode wrapper would be a separate helper. The factor-out
+ * point if/when one is needed is `processFile` (the per-file pure
+ * function) — call it from an `analyzeAll` callback that walks an
+ * accessor (audit 2026-05-23 F8).
+ *
+ * @throws {ValidationError} via {@link defineCheck} when the synthesised
+ *   config is invalid.
+ */
+/**
+ * Match a single pattern against a single line, pushing one violation
+ * per match into `violations`. For global regexes this emits multiple
+ * violations per line; for non-global regexes it emits at most one.
+ *
+ * When `singleMatch` is true, only the first match is emitted (used for
+ * `oneViolationPerLine` semantics).
+ *
+ * Returns `true` if at least one violation was pushed.
+ */
+function matchPatternOnLine(pattern, line, lineNum, violations, singleMatch) {
+    // Reset lastIndex — pattern objects are reused across lines and files;
+    // failing to reset would skip matches at low positions on subsequent
+    // calls.
+    pattern.regex.lastIndex = 0;
+    let pushed = false;
+    let match = pattern.regex.exec(line);
+    while (match !== null) {
+        violations.push({
+            line: lineNum,
+            column: match.index,
+            message: pattern.message,
+            severity: pattern.severity ?? 'warning',
+            suggestion: pattern.suggestion,
+            match: match[0],
+            type: pattern.slug,
+        });
+        pushed = true;
+        // Non-global regex: stop after the first match. Otherwise exec
+        // would loop forever (lastIndex stays at 0).
+        if (!pattern.regex.global)
+            break;
+        if (singleMatch)
+            break;
+        match = pattern.regex.exec(line);
+    }
+    return pushed;
+}
+function processFile(opts) {
+    const violations = [];
+    const lines = opts.content.split('\n');
+    for (const [i, line_] of lines.entries()) {
+        const line = line_ ?? '';
+        if (opts.skipComments && isCommentLine(line))
+            continue;
+        if (opts.skipLine?.(line.trim(), line) === true)
+            continue;
+        processLine(line, i + 1, opts.patterns, opts.oneViolationPerLine, violations);
+    }
+    return violations;
+}
+function processLine(line, lineNum, patterns, oneViolationPerLine, violations) {
+    let lineHasViolation = false;
+    for (const pattern of patterns) {
+        if (oneViolationPerLine && lineHasViolation)
+            break;
+        const pushed = matchPatternOnLine(pattern, line, lineNum, violations, oneViolationPerLine);
+        if (pushed)
+            lineHasViolation = true;
+    }
+}
+/** Factory for the common "scan each line against a regex list" check pattern. */
+export function defineRegexListCheck(config) {
+    const skipComments = config.options?.skipCommentLines ?? true;
+    const skipTests = config.options?.skipTestFiles ?? false;
+    const skipFile = config.options?.skipFile;
+    const skipLine = config.options?.skipLine;
+    const oneViolationPerLine = config.options?.oneViolationPerLine ?? false;
+    const patterns = config.patterns;
+    return defineCheck({
+        id: config.id,
+        slug: config.slug,
+        description: config.description,
+        longDescription: config.longDescription,
+        tags: config.tags,
+        scope: config.scope,
+        fileTypes: config.fileTypes,
+        contentFilter: config.contentFilter,
+        confidence: config.confidence,
+        disabled: config.disabled,
+        timeout: config.timeout,
+        docs: config.docs,
+        provider: config.provider,
+        analyze(content, filePath) {
+            if (skipTests && isTestFile(filePath))
+                return [];
+            if (skipFile?.(filePath) === true)
+                return [];
+            return processFile({
+                content,
+                patterns,
+                skipComments,
+                skipLine,
+                oneViolationPerLine,
+            });
+        },
+    });
+}
+//# sourceMappingURL=define-regex-list-check.js.map

package/dist/framework/define-regex-list-check.js.map

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

package/dist/framework/directive-inventory.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Directive Inventory - shared parsing logic for
+ * fitness-ignore directives.
+ */
+/** A single fitness-ignore directive found in a source file. */
+export interface DirectiveEntry {
+    filePath: string;
+    lineNumber: number;
+    type: 'file' | 'next-line';
+    checkId: string;
+    group: string;
+    reason: string | null;
+    weakReason: boolean;
+}
+/**
+ * Parse a file-level or next-line directive from a comment line.
+ *
+ * Accepts every comment opener the suppression parser supports
+ * (`//`, `/*`, `<!--`, `#`) — sourced from the shared COMMENT_OPENERS
+ * table so the inventory and the suppressor stay in sync. Previously
+ * the inventory only recognized `// ` and `/* `, so block-comment
+ * directives suppressed findings but vanished from inventory counts.
+ */
+export declare function parseDirectiveLine(line: string): {
+    type: 'file' | 'next-line';
+    checkId: string;
+    reason: string | null;
+} | null;
+/**
+ * Check if a reason is weak/generic. Missing reason (null) is considered weak.
+ */
+export declare function isWeakReason(reason: string | null): boolean;
+/**
+ * Extract the group prefix from a check ID (the directory name).
+ */
+export declare function extractGroup(checkId: string): string;
+//# sourceMappingURL=directive-inventory.d.ts.map

package/dist/framework/directive-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directive-inventory.d.ts","sourceRoot":"","sources":["../../src/framework/directive-inventory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACrB;AAwBD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAChD,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,GAAG,IAAI,CAkBP;AAyBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAG3D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGpD"}

package/dist/framework/directive-inventory.js

@@ -0,0 +1,82 @@
+/**
+ * @fileoverview Directive Inventory - shared parsing logic for
+ * fitness-ignore directives.
+ */
+import { stripCommentOpener } from './comment-openers.js';
+// =============================================================================
+// Shared Constants
+// =============================================================================
+/** Patterns that indicate a weak or generic ignore reason. */
+const WEAK_REASON_PATTERNS = Object.freeze([
+    /^ignore$/i,
+    /^skip$/i,
+    /^todo$/i,
+    /^fixme$/i,
+    /^temporary$/i,
+    /^temp$/i,
+    /^wip$/i,
+    /^disable$/i,
+    /^suppress$/i,
+    /^\s*$/,
+]);
+// =============================================================================
+// Shared Parsing
+// =============================================================================
+/**
+ * Parse a file-level or next-line directive from a comment line.
+ *
+ * Accepts every comment opener the suppression parser supports
+ * (`//`, `/*`, `<!--`, `#`) — sourced from the shared COMMENT_OPENERS
+ * table so the inventory and the suppressor stay in sync. Previously
+ * the inventory only recognized `// ` and `/* `, so block-comment
+ * directives suppressed findings but vanished from inventory counts.
+ */
+export function parseDirectiveLine(line) {
+    const trimmed = line.trimStart();
+    const stripped = stripCommentOpener(trimmed);
+    if (stripped === null)
+        return null;
+    const afterComment = stripped.trimStart();
+    if (afterComment.startsWith('@fitness-ignore-file ')) {
+        const rest = afterComment.slice('@fitness-ignore-file '.length);
+        return parseDirectiveRest(rest, 'file');
+    }
+    if (afterComment.startsWith('@fitness-ignore-next-line ')) {
+        const rest = afterComment.slice('@fitness-ignore-next-line '.length);
+        return parseDirectiveRest(rest, 'next-line');
+    }
+    return null;
+}
+function parseDirectiveRest(rest, type) {
+    // Strip trailing block-comment terminators: `*/` (C-family) and `-->` (HTML).
+    // eslint-disable-next-line sonarjs/slow-regex -- anchored at end-of-string, bounded \s* runs; no ReDoS exposure
+    const normalized = rest.replace(/\s*(?:\*\/|-->)\s*$/, '').trimEnd();
+    const separatorIndex = normalized.indexOf(' -- ');
+    if (separatorIndex === -1) {
+        const checkId = normalized.trim();
+        if (!checkId || checkId.includes(' '))
+            return null;
+        return { type, checkId, reason: null };
+    }
+    const checkId = normalized.slice(0, separatorIndex).trim();
+    const reason = normalized.slice(separatorIndex + 4).trim();
+    if (!checkId || checkId.includes(' '))
+        return null;
+    return { type, checkId, reason: reason || null };
+}
+/**
+ * Check if a reason is weak/generic. Missing reason (null) is considered weak.
+ */
+export function isWeakReason(reason) {
+    if (reason === null)
+        return true;
+    return WEAK_REASON_PATTERNS.some((pattern) => pattern.test(reason.trim()));
+}
+/**
+ * Extract the group prefix from a check ID (the directory name).
+ */
+export function extractGroup(checkId) {
+    const slashIndex = checkId.indexOf('/');
+    return slashIndex > 0 ? checkId.slice(0, slashIndex) : 'other';
+}
+//# sourceMappingURL=directive-inventory.js.map

package/dist/framework/directive-inventory.js.map

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

package/dist/framework/directive-parsing.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Fitness ignore-directive parsing — thin wrappers over the
+ * shared core suppression scanner (ADR-0014).
+ *
+ * The directive-scanning algorithm lives once in `@opensip-cli/core`
+ * (`scanSuppressionDirectives`). These wrappers bind it to the fitness
+ * keywords (`@fitness-ignore-file` / `@fitness-ignore-next-line`) and the
+ * historical `boolean` / `Set<number>` signatures the fitness framework and
+ * its tests depend on. No scanning logic is duplicated here.
+ */
+import { type SuppressionKeywords } from '@opensip-cli/core';
+export declare const FITNESS_KEYWORDS: SuppressionKeywords;
+/**
+ * Parse file-level ignore directive from file content.
+ * Returns true if the file should be entirely ignored for that check.
+ */
+export declare function parseFileIgnoreDirective(content: string, checkId: string | readonly string[]): boolean;
+/**
+ * Parse next-line ignore directives from file content.
+ * Returns the set of 1-based line numbers that should be ignored.
+ */
+export declare function parseIgnoreDirectives(content: string, checkId: string | readonly string[]): Set<number>;
+//# sourceMappingURL=directive-parsing.d.ts.map

package/dist/framework/directive-parsing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directive-parsing.d.ts","sourceRoot":"","sources":["../../src/framework/directive-parsing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExF,eAAO,MAAM,gBAAgB,EAAE,mBAG9B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAClC,OAAO,CAIT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAClC,GAAG,CAAC,MAAM,CAAC,CAQb"}

package/dist/framework/directive-parsing.js

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Fitness ignore-directive parsing — thin wrappers over the
+ * shared core suppression scanner (ADR-0014).
+ *
+ * The directive-scanning algorithm lives once in `@opensip-cli/core`
+ * (`scanSuppressionDirectives`). These wrappers bind it to the fitness
+ * keywords (`@fitness-ignore-file` / `@fitness-ignore-next-line`) and the
+ * historical `boolean` / `Set<number>` signatures the fitness framework and
+ * its tests depend on. No scanning logic is duplicated here.
+ */
+import { scanSuppressionDirectives } from '@opensip-cli/core';
+export const FITNESS_KEYWORDS = {
+    file: '@fitness-ignore-file',
+    nextLine: '@fitness-ignore-next-line',
+};
+/**
+ * Parse file-level ignore directive from file content.
+ * Returns true if the file should be entirely ignored for that check.
+ */
+export function parseFileIgnoreDirective(content, checkId) {
+    const checkIds = Array.isArray(checkId) ? checkId : [checkId];
+    const { fileIgnoredIds } = scanSuppressionDirectives(content, FITNESS_KEYWORDS);
+    return checkIds.some((id) => fileIgnoredIds.has(id));
+}
+/**
+ * Parse next-line ignore directives from file content.
+ * Returns the set of 1-based line numbers that should be ignored.
+ */
+export function parseIgnoreDirectives(content, checkId) {
+    const checkIds = Array.isArray(checkId) ? checkId : [checkId];
+    const { lineIgnoredIds } = scanSuppressionDirectives(content, FITNESS_KEYWORDS);
+    const ignoredLines = new Set();
+    for (const [line, ids] of lineIgnoredIds) {
+        if (checkIds.some((id) => ids.has(id)))
+            ignoredLines.add(line);
+    }
+    return ignoredLines;
+}
+//# sourceMappingURL=directive-parsing.js.map

package/dist/framework/directive-parsing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directive-parsing.js","sourceRoot":"","sources":["../../src/framework/directive-parsing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,yBAAyB,EAA4B,MAAM,mBAAmB,CAAC;AAExF,MAAM,CAAC,MAAM,gBAAgB,GAAwB;IACnD,IAAI,EAAE,sBAAsB;IAC5B,QAAQ,EAAE,2BAA2B;CACtC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAe,EACf,OAAmC;IAEnC,MAAM,QAAQ,GAAsB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACjF,MAAM,EAAE,cAAc,EAAE,GAAG,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAChF,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,OAAmC;IAEnC,MAAM,QAAQ,GAAsB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACjF,MAAM,EAAE,cAAc,EAAE,GAAG,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAChF,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,cAAc,EAAE,CAAC;QACzC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAAE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC"}