@opensip-cli/checks-universal 0.1.0

package/dist/checks/quality/fitness-ignore-hygiene.js

@@ -0,0 +1,93 @@
+// @fitness-ignore-file fitness-ignore-hygiene -- check references internal slugs that may differ from registered slugs
+/**
+ * @fileoverview Fitness ignore hygiene check
+ */
+import { defineCheck } from '@opensip-cli/fitness';
+/** Regex to match @fitness-ignore directives */
+const FITNESS_IGNORE_REGEX = /@fitness-ignore(?:-file|-next-line)?\s+(\S+)/g;
+/** Valid check slug format: kebab-case */
+const VALID_SLUG_PATTERN = /^[a-z][a-z0-9-]*$/;
+/**
+ * Analyze @fitness-ignore directives for hygiene issues
+ */
+function analyzeIgnoreHygiene(content, _filePath) {
+    const violations = [];
+    const lines = content.split('\n');
+    let totalIgnoreDirectives = 0;
+    for (const [i, line_] of lines.entries()) {
+        const line = line_ ?? '';
+        // Only check actual comment lines — skip string literals, code, and template literals
+        // that happen to contain ignore-directive text (e.g., regex patterns, suggestion strings)
+        if (!line.trim().startsWith('//'))
+            continue;
+        FITNESS_IGNORE_REGEX.lastIndex = 0;
+        const ignoreMatches = [...line.matchAll(FITNESS_IGNORE_REGEX)];
+        for (const match of ignoreMatches) {
+            totalIgnoreDirectives++;
+            const checkSlug = match[1];
+            // Validate check slug format
+            if (checkSlug && !VALID_SLUG_PATTERN.test(checkSlug)) {
+                violations.push({
+                    line: i + 1,
+                    message: `@fitness-ignore references '${checkSlug}' which is not a valid check slug (expected kebab-case)`,
+                    severity: 'warning',
+                    suggestion: 'Use a valid check slug like "no-generic-error" or "file-length-limits"',
+                    type: 'invalid-ignore-slug',
+                    match: line.trim().slice(0, 120),
+                });
+            }
+            // Check for ignore directive without a reason comment
+            // Expected format: @fitness-ignore slug -- reason
+            const afterMatch = line.slice(match.index + match[0].length);
+            const hasReason = afterMatch.includes('--');
+            if (!hasReason) {
+                violations.push({
+                    line: i + 1,
+                    message: `@fitness-ignore directive for '${checkSlug ?? 'unknown'}' missing a reason comment`,
+                    severity: 'warning',
+                    suggestion: 'Add a reason: @fitness-ignore check-slug -- Reason why this is suppressed',
+                    type: 'ignore-without-reason',
+                    match: line.trim().slice(0, 120),
+                });
+            }
+        }
+    }
+    // Flag files with excessive ignore directives
+    if (totalIgnoreDirectives > 7) {
+        violations.push({
+            line: 1,
+            message: `File has ${totalIgnoreDirectives} @fitness-ignore directives — consider fixing the underlying issues instead of suppressing`,
+            severity: 'warning',
+            suggestion: 'Review each suppression to determine if the underlying issue can be fixed',
+            type: 'excessive-ignores',
+        });
+    }
+    return violations;
+}
+/**
+ * Check: quality/fitness-ignore-hygiene
+ *
+ * Validates that @fitness-ignore directives have valid check slugs and reason comments.
+ */
+export const fitnessIgnoreHygiene = defineCheck({
+    id: '1d4028f6-6cd4-40b1-8b66-9846daa57e5a',
+    slug: 'fitness-ignore-hygiene',
+    scope: { languages: ['typescript'], concerns: ['fitness'] },
+    contentFilter: 'raw',
+    description: 'Validates that @fitness-ignore directives have valid check slugs and reason comments',
+    longDescription: `**Purpose:** Validates the quality of \`@fitness-ignore\` directives to prevent stale or undocumented suppressions.
+
+**Detects:**
+- Directives with invalid check slugs (not kebab-case)
+- Directives missing a reason comment (\`-- reason\`)
+- Files with more than 7 ignore directives (suggests fixing underlying issues)
+
+**Why it matters:** Undocumented suppressions accumulate over time and can mask real issues when check scopes change.
+
+**Scope:** All TypeScript files. Analyzes each file individually via regex.`,
+    tags: ['quality', 'fitness', 'hygiene'],
+    fileTypes: ['ts'],
+    confidence: 'medium',
+    analyze: analyzeIgnoreHygiene,
+});
+//# sourceMappingURL=fitness-ignore-hygiene.js.map

package/dist/checks/quality/fitness-ignore-hygiene.js.map

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

package/dist/checks/quality/frontend/expo-vector-icons.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Expo Vector Icons Check
+ *
+ * Ensures consistent icon library usage across the frontend codebase.
+ * Recommends using @expo/vector-icons for React Native compatibility.
+ */
+/**
+ * Check: quality/expo-vector-icons
+ *
+ * Ensures consistent icon library usage with @expo/vector-icons.
+ */
+export declare const expoVectorIcons: import("@opensip-cli/fitness").Check;
+//# sourceMappingURL=expo-vector-icons.d.ts.map

package/dist/checks/quality/frontend/expo-vector-icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expo-vector-icons.d.ts","sourceRoot":"","sources":["../../../../src/checks/quality/frontend/expo-vector-icons.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwDH;;;;GAIG;AACH,eAAO,MAAM,eAAe,sCAsB1B,CAAC"}

package/dist/checks/quality/frontend/expo-vector-icons.js

@@ -0,0 +1,80 @@
+/**
+ * @fileoverview Expo Vector Icons Check
+ *
+ * Ensures consistent icon library usage across the frontend codebase.
+ * Recommends using @expo/vector-icons for React Native compatibility.
+ */
+import { defineCheck } from '@opensip-cli/fitness';
+const PREFERRED_ICON_LIBRARY = '@expo/vector-icons';
+const DISCOURAGED_LIBRARIES = [
+    'react-native-vector-icons',
+    'react-icons',
+    '@fortawesome/react-native-fontawesome',
+];
+/**
+ * Escape special regex characters in a string
+ */
+function escapeRegExp(str) {
+    // @fitness-ignore-next-line fitness-check-standards -- Character class regex is safe from ReDoS, no backtracking
+    return str.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw `\$&`);
+}
+/**
+ * Analyze a file for icon library issues
+ * @param {string} content - File content to analyze
+ * @param {string} filePath - Path to the file
+ * @returns {CheckViolation[]} Array of violations found
+ */
+function analyzeFile(content, filePath) {
+    // Quick filter: skip if no discouraged library mentioned
+    if (!DISCOURAGED_LIBRARIES.some((lib) => content.includes(lib))) {
+        return [];
+    }
+    const violations = [];
+    for (const lib of DISCOURAGED_LIBRARIES) {
+        const escapedLib = escapeRegExp(lib);
+        const pattern = String.raw `import\s+.*\s+from\s+['"]${escapedLib}['"]`;
+        const regex = new RegExp(pattern, 'g');
+        let match;
+        while ((match = regex.exec(content)) !== null) {
+            const line = content.slice(0, Math.max(0, match.index)).split('\n').length;
+            violations.push({
+                filePath,
+                line,
+                column: 0,
+                message: `Using ${lib} instead of ${PREFERRED_ICON_LIBRARY}`,
+                severity: 'warning',
+                type: 'discouraged-library',
+                suggestion: `Replace import with: import { IconName } from '${PREFERRED_ICON_LIBRARY}/FontAwesome' or another icon family from @expo/vector-icons`,
+                match: lib,
+            });
+        }
+    }
+    return violations;
+}
+/**
+ * Check: quality/expo-vector-icons
+ *
+ * Ensures consistent icon library usage with @expo/vector-icons.
+ */
+export const expoVectorIcons = defineCheck({
+    id: 'dccf8b44-b1be-40b5-82e7-631daa8c0013',
+    slug: 'expo-vector-icons',
+    disabled: true,
+    scope: { languages: ['typescript', 'tsx'], concerns: ['frontend', 'ui'] },
+    contentFilter: 'strip-strings',
+    confidence: 'medium',
+    description: 'Ensure consistent icon library usage with @expo/vector-icons',
+    longDescription: `**Purpose:** Enforces consistent icon library usage by flagging imports from discouraged icon packages in favor of \`@expo/vector-icons\`.
+
+**Detects:** Analyzes each file individually using regex-based import scanning.
+- Import statements from \`react-native-vector-icons\`, \`react-icons\`, or \`@fortawesome/react-native-fontawesome\`
+- Matches the pattern \`import ... from '<library>'\` for each discouraged library
+
+**Why it matters:** Using multiple icon libraries increases bundle size and creates visual inconsistency. \`@expo/vector-icons\` is the standard for React Native/Expo compatibility.
+
+**Scope:** Codebase-specific convention`,
+    tags: ['quality', 'consistency', 'best-practices', 'react-native', 'icons'],
+    fileTypes: ['ts', 'tsx'],
+    analyze: analyzeFile,
+});
+//# sourceMappingURL=expo-vector-icons.js.map

package/dist/checks/quality/frontend/expo-vector-icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expo-vector-icons.js","sourceRoot":"","sources":["../../../../src/checks/quality/frontend/expo-vector-icons.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAuB,MAAM,sBAAsB,CAAC;AAExE,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AACpD,MAAM,qBAAqB,GAAG;IAC5B,2BAA2B;IAC3B,aAAa;IACb,uCAAuC;CACxC,CAAC;AAEF;;GAEG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,iHAAiH;IACjH,OAAO,GAAG,CAAC,UAAU,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAAG,CAAA,KAAK,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,OAAe,EAAE,QAAgB;IACpD,yDAAyD;IACzD,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAChE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAqB,EAAE,CAAC;IAExC,KAAK,MAAM,GAAG,IAAI,qBAAqB,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAA,4BAA4B,UAAU,MAAM,CAAC;QACvE,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC;QACV,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YAC3E,UAAU,CAAC,IAAI,CAAC;gBACd,QAAQ;gBACR,IAAI;gBACJ,MAAM,EAAE,CAAC;gBACT,OAAO,EAAE,SAAS,GAAG,eAAe,sBAAsB,EAAE;gBAC5D,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,qBAAqB;gBAC3B,UAAU,EAAE,kDAAkD,sBAAsB,8DAA8D;gBAClJ,KAAK,EAAE,GAAG;aACX,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;IACzC,EAAE,EAAE,sCAAsC;IAC1C,IAAI,EAAE,mBAAmB;IACzB,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE;IACzE,aAAa,EAAE,eAAe;IAE9B,UAAU,EAAE,QAAQ;IACpB,WAAW,EAAE,8DAA8D;IAC3E,eAAe,EAAE;;;;;;;;wCAQqB;IACtC,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,OAAO,CAAC;IAC3E,SAAS,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC;IAExB,OAAO,EAAE,WAAW;CACrB,CAAC,CAAC"}

package/dist/checks/quality/frontend/image-optimization.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Image Optimization Check
+ *
+ * Detects unoptimized image imports and usage patterns in React Native code.
+ * Recommends using Expo Image or optimized image loading strategies.
+ */
+/**
+ * Check: quality/image-optimization
+ *
+ * Detects unoptimized image usage and recommends best practices.
+ */
+export declare const imageOptimization: import("@opensip-cli/fitness").Check;
+//# sourceMappingURL=image-optimization.d.ts.map

package/dist/checks/quality/frontend/image-optimization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-optimization.d.ts","sourceRoot":"","sources":["../../../../src/checks/quality/frontend/image-optimization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0JH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,sCAsB5B,CAAC"}

package/dist/checks/quality/frontend/image-optimization.js

@@ -0,0 +1,166 @@
+/**
+ * @fileoverview Image Optimization Check
+ *
+ * Detects unoptimized image imports and usage patterns in React Native code.
+ * Recommends using Expo Image or optimized image loading strategies.
+ */
+import { defineCheck } from '@opensip-cli/fitness';
+/**
+ * Check if content contains a react-native Image import.
+ * Uses simple string search instead of regex for ReDoS safety.
+ *
+ * @param content - File content to check
+ * @returns True if react-native Image import is found
+ */
+function hasReactNativeImageImport(content) {
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const isImportStatement = line.includes('import') && line.includes('Image');
+        const isFromReactNative = line.includes('react-native');
+        const isNamedImport = line.includes('{') && line.includes('}');
+        if (isImportStatement && isFromReactNative && isNamedImport) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if content contains an expo-image import.
+ *
+ * @param content - File content to check
+ * @returns True if expo-image import is found
+ */
+function hasExpoImageImport(content) {
+    return content.includes("from 'expo-image'") || content.includes('from "expo-image"');
+}
+/**
+ * Find the line number of a react-native Image import.
+ *
+ * @param content - File content to search
+ * @returns Line number (1-based) and snippet, or null if not found
+ */
+function findReactNativeImageLine(content) {
+    const lines = content.split('\n');
+    for (const [i, line] of lines.entries()) {
+        /* v8 ignore next 3 -- defensive: lines.entries() never yields undefined */
+        if (line === undefined) {
+            continue;
+        }
+        const isImportStatement = line.includes('import') && line.includes('Image');
+        const isFromReactNative = line.includes('react-native');
+        const isNamedImport = line.includes('{') && line.includes('}');
+        if (isImportStatement && isFromReactNative && isNamedImport) {
+            return { line: i + 1, snippet: line.trim() };
+        }
+    }
+    return null;
+}
+/**
+ * Find Image components without placeholder prop.
+ * Uses line-by-line analysis instead of regex for ReDoS safety.
+ *
+ * @param content - File content to search
+ * @returns Array of violations with line numbers
+ */
+function findImagesWithoutPlaceholder(content) {
+    const results = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        /* v8 ignore next 3 -- defensive: index access on existing array never returns undefined */
+        if (line === undefined) {
+            continue;
+        }
+        // Look for <Image with source prop but without placeholder
+        if (line.includes('<Image') && line.includes('source=')) {
+            // Check this line and surrounding context for placeholder
+            const contextStart = Math.max(0, i - 2);
+            const contextEnd = Math.min(lines.length, i + 3);
+            const context = lines.slice(contextStart, contextEnd).join('\n');
+            if (!context.includes('placeholder')) {
+                results.push({ line: i + 1, snippet: line.trim().slice(0, 100) });
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Analyzes a single file for image optimization issues
+ *
+ * @param content - File content to analyze
+ * @param filePath - Path to the file being analyzed
+ * @returns Array of violations found
+ */
+function analyzeFile(content, filePath) {
+    // Only check TSX files
+    if (!filePath.endsWith('.tsx')) {
+        return [];
+    }
+    // Quick filter: skip files without Image
+    if (!content.includes('Image')) {
+        return [];
+    }
+    const violations = [];
+    // Check for react-native Image without expo-image
+    const hasRNImage = hasReactNativeImageImport(content);
+    const hasExpoImage = hasExpoImageImport(content);
+    if (hasRNImage && !hasExpoImage) {
+        const importInfo = findReactNativeImageLine(content);
+        if (importInfo) {
+            violations.push({
+                filePath,
+                line: importInfo.line,
+                column: 0,
+                message: 'Using react-native Image instead of expo-image',
+                severity: 'warning',
+                type: 'use-expo-image',
+                suggestion: "Replace with expo-image for better performance and caching: import { Image } from 'expo-image'. Expo Image provides automatic caching, better memory management, and supports modern image formats.",
+                match: 'react-native Image',
+            });
+        }
+    }
+    // Check for Image without placeholder prop (for expo-image)
+    if (hasExpoImage) {
+        const imagesWithoutPlaceholder = findImagesWithoutPlaceholder(content);
+        for (const img of imagesWithoutPlaceholder) {
+            violations.push({
+                filePath,
+                line: img.line,
+                column: 0,
+                message: 'Image missing placeholder for loading state',
+                severity: 'warning',
+                type: 'no-placeholder',
+                suggestion: 'Add placeholder prop for better UX during loading. Use a low-resolution placeholder or blurhash for smooth loading transitions.',
+                match: '<Image',
+            });
+        }
+    }
+    return violations;
+}
+/**
+ * Check: quality/image-optimization
+ *
+ * Detects unoptimized image usage and recommends best practices.
+ */
+export const imageOptimization = defineCheck({
+    id: 'fe256cba-e891-466b-9361-c71b5af216d9',
+    slug: 'image-optimization',
+    disabled: true,
+    scope: { languages: ['typescript', 'tsx'], concerns: ['frontend', 'ui'] },
+    confidence: 'medium',
+    description: 'Detect unoptimized image usage and recommend best practices',
+    longDescription: `**Purpose:** Detects unoptimized image loading patterns and enforces usage of \`expo-image\` over React Native's built-in \`Image\` component.
+
+**Detects:** Analyzes each file individually using line-by-line string matching.
+- \`Image\` imported from \`react-native\` (named import with curly braces) when \`expo-image\` is not also imported
+- \`<Image>\` elements using \`expo-image\` that have a \`source=\` prop but no \`placeholder\` prop within a 5-line context window
+- Only scans \`.tsx\` files; excludes test files
+
+**Why it matters:** React Native's \`Image\` lacks caching, modern format support, and memory management. Missing placeholders cause layout shifts during loading.
+
+**Scope:** Codebase-specific convention`,
+    tags: ['quality', 'performance', 'best-practices', 'react-native', 'images'],
+    fileTypes: ['ts', 'tsx'],
+    analyze: analyzeFile,
+});
+//# sourceMappingURL=image-optimization.js.map

package/dist/checks/quality/frontend/image-optimization.js.map

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

package/dist/checks/quality/frontend/index.d.ts

@@ -0,0 +1,4 @@
+export * from './expo-vector-icons.js';
+export * from './image-optimization.js';
+export * from './navigation-typing.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/checks/quality/frontend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/checks/quality/frontend/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC"}

package/dist/checks/quality/frontend/index.js

@@ -0,0 +1,4 @@
+export * from './expo-vector-icons.js';
+export * from './image-optimization.js';
+export * from './navigation-typing.js';
+//# sourceMappingURL=index.js.map

package/dist/checks/quality/frontend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/checks/quality/frontend/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC"}

package/dist/checks/quality/frontend/navigation-typing.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Navigation Typing Check
+ *
+ * Verifies that navigation params are properly typed for type-safe routing.
+ */
+/**
+ * Check: quality/navigation-typing
+ *
+ * Verifies navigation params are properly typed for type-safe routing.
+ */
+export declare const navigationTyping: import("@opensip-cli/fitness").Check;
+//# sourceMappingURL=navigation-typing.d.ts.map

package/dist/checks/quality/frontend/navigation-typing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-typing.d.ts","sourceRoot":"","sources":["../../../../src/checks/quality/frontend/navigation-typing.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAoDH;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,sCAuB3B,CAAC"}

package/dist/checks/quality/frontend/navigation-typing.js

@@ -0,0 +1,77 @@
+// @fitness-ignore-file file-length-limit -- Complex module with tightly coupled logic; refactoring would risk breaking changes
+/**
+ * @fileoverview Navigation Typing Check
+ *
+ * Verifies that navigation params are properly typed for type-safe routing.
+ */
+import { defineCheck } from '@opensip-cli/fitness';
+/**
+ * Analyzes a single file for navigation typing issues
+ */
+function analyzeFile(content, filePath) {
+    const violations = [];
+    // Quick filter: skip files without navigation patterns
+    if (!content.includes('useLocalSearchParams') && !content.includes('router.push')) {
+        return violations;
+    }
+    // Check for untyped useLocalSearchParams
+    const untypedParamsRegex = /useLocalSearchParams\s*\(\s*\)/g;
+    let match;
+    while ((match = untypedParamsRegex.exec(content)) !== null) {
+        const line = content.slice(0, Math.max(0, match.index)).split('\n').length;
+        violations.push({
+            filePath,
+            line,
+            column: 0,
+            message: 'useLocalSearchParams without type parameter',
+            severity: 'warning',
+            type: 'untyped-params',
+            suggestion: 'Add type parameter: useLocalSearchParams<{ id: string }>() to get type-safe route params.',
+            match: 'useLocalSearchParams()',
+        });
+    }
+    // Check for untyped router.push with params
+    const untypedPushRegex = /router\.push\(\s*['"`][^'"`]+['"`]\s*,\s*\{/g;
+    while ((match = untypedPushRegex.exec(content)) !== null) {
+        const line = content.slice(0, Math.max(0, match.index)).split('\n').length;
+        violations.push({
+            filePath,
+            line,
+            column: 0,
+            message: 'router.push with inline params may lack type safety',
+            severity: 'warning',
+            type: 'untyped-push',
+            suggestion: 'Use typed route helpers or define route types for type-safe navigation params.',
+            match: 'router.push',
+        });
+    }
+    return violations;
+}
+/**
+ * Check: quality/navigation-typing
+ *
+ * Verifies navigation params are properly typed for type-safe routing.
+ */
+export const navigationTyping = defineCheck({
+    id: '11547dc2-7666-4617-9705-be27528c4227',
+    slug: 'navigation-typing',
+    disabled: true,
+    scope: { languages: ['typescript', 'tsx'], concerns: ['frontend', 'ui'] },
+    contentFilter: 'strip-strings',
+    confidence: 'medium',
+    description: 'Verify navigation params are properly typed for type-safe routing',
+    longDescription: `**Purpose:** Ensures Expo Router navigation parameters are properly typed for compile-time type safety on route params.
+
+**Detects:** Analyzes each file individually using regex-based pattern matching.
+- \`useLocalSearchParams()\` called without a type parameter (matches \`/useLocalSearchParams\\s*\\(\\s*\\)/\`)
+- \`router.push()\` called with a string route and inline object params (matches \`/router\\.push\\(\\s*['"\`][^'"\`]+['"\`]\\s*,\\s*\\{/\`)
+- Uses a quick-filter optimization: skips files not containing \`useLocalSearchParams\` or \`router.push\`
+
+**Why it matters:** Untyped navigation params silently accept wrong types at compile time, leading to runtime crashes when route params are missing or have unexpected shapes.
+
+**Scope:** General best practice`,
+    tags: ['quality', 'type-safety', 'best-practices', 'react-native'],
+    fileTypes: ['ts', 'tsx'],
+    analyze: analyzeFile,
+});
+//# sourceMappingURL=navigation-typing.js.map

package/dist/checks/quality/frontend/navigation-typing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-typing.js","sourceRoot":"","sources":["../../../../src/checks/quality/frontend/navigation-typing.ts"],"names":[],"mappings":"AAAA,+HAA+H;AAC/H;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAuB,MAAM,sBAAsB,CAAC;AAExE;;GAEG;AACH,SAAS,WAAW,CAAC,OAAe,EAAE,QAAgB;IACpD,MAAM,UAAU,GAAqB,EAAE,CAAC;IAExC,uDAAuD;IACvD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAClF,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,yCAAyC;IACzC,MAAM,kBAAkB,GAAG,iCAAiC,CAAC;IAC7D,IAAI,KAAK,CAAC;IACV,OAAO,CAAC,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAC3E,UAAU,CAAC,IAAI,CAAC;YACd,QAAQ;YACR,IAAI;YACJ,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,6CAA6C;YACtD,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,gBAAgB;YACtB,UAAU,EACR,2FAA2F;YAC7F,KAAK,EAAE,wBAAwB;SAChC,CAAC,CAAC;IACL,CAAC;IAED,4CAA4C;IAC5C,MAAM,gBAAgB,GAAG,8CAA8C,CAAC;IACxE,OAAO,CAAC,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACzD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAC3E,UAAU,CAAC,IAAI,CAAC;YACd,QAAQ;YACR,IAAI;YACJ,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,qDAAqD;YAC9D,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,cAAc;YACpB,UAAU,EAAE,gFAAgF;YAC5F,KAAK,EAAE,aAAa;SACrB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;IAC1C,EAAE,EAAE,sCAAsC;IAC1C,IAAI,EAAE,mBAAmB;IACzB,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE;IACzE,aAAa,EAAE,eAAe;IAE9B,UAAU,EAAE,QAAQ;IACpB,WAAW,EAAE,mEAAmE;IAChF,eAAe,EAAE;;;;;;;;;iCASc;IAC/B,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,CAAC;IAClE,SAAS,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC;IAExB,OAAO,EAAE,WAAW;CACrB,CAAC,CAAC"}

package/dist/checks/quality/graph-ignore-hygiene.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Graph ignore hygiene check
+ */
+/**
+ * Check: quality/graph-ignore-hygiene
+ *
+ * Validates that @graph-ignore directives have valid graph rule ids and reason comments.
+ */
+export declare const graphIgnoreHygiene: import("@opensip-cli/fitness").Check;
+//# sourceMappingURL=graph-ignore-hygiene.d.ts.map

package/dist/checks/quality/graph-ignore-hygiene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-ignore-hygiene.d.ts","sourceRoot":"","sources":["../../../src/checks/quality/graph-ignore-hygiene.ts"],"names":[],"mappings":"AACA;;GAEG;AA2EH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,sCAuB7B,CAAC"}

package/dist/checks/quality/graph-ignore-hygiene.js

@@ -0,0 +1,95 @@
+// @fitness-ignore-file graph-ignore-hygiene -- check references internal slugs that may differ from registered slugs
+/**
+ * @fileoverview Graph ignore hygiene check
+ */
+import { defineCheck } from '@opensip-cli/fitness';
+/** Regex to match @graph-ignore directives */
+const GRAPH_IGNORE_REGEX = /@graph-ignore(?:-file|-next-line)?\s+(\S+)/g;
+/** Valid graph rule id format: graph-namespaced kebab-case (e.g. `graph:cycle`) */
+const VALID_GRAPH_ID = /^graph:[a-z][a-z0-9-]*$/;
+/**
+ * Analyze @graph-ignore directives for hygiene issues
+ */
+function analyzeIgnoreHygiene(content, _filePath) {
+    const violations = [];
+    const lines = content.split('\n');
+    let totalIgnoreDirectives = 0;
+    for (const [i, line_] of lines.entries()) {
+        const line = line_ ?? '';
+        // Only check actual comment lines — skip string literals, code, and template literals
+        // that happen to contain ignore-directive text (e.g., regex patterns, suggestion strings)
+        if (!line.trim().startsWith('//'))
+            continue;
+        GRAPH_IGNORE_REGEX.lastIndex = 0;
+        const ignoreMatches = [...line.matchAll(GRAPH_IGNORE_REGEX)];
+        for (const match of ignoreMatches) {
+            totalIgnoreDirectives++;
+            const ruleId = match[1];
+            // Validate graph rule id format (graph:<kebab>)
+            if (ruleId && !VALID_GRAPH_ID.test(ruleId)) {
+                violations.push({
+                    line: i + 1,
+                    message: `@graph-ignore references '${ruleId}' which is not a valid graph rule id (expected \`graph:<kebab>\`)`,
+                    severity: 'warning',
+                    suggestion: 'Use a valid graph rule id like "graph:cycle" or "graph:large-function"',
+                    type: 'invalid-ignore-slug',
+                    match: line.trim().slice(0, 120),
+                });
+            }
+            // Check for ignore directive without a reason comment
+            // Expected format: @graph-ignore graph:<rule> -- reason
+            const afterMatch = line.slice(match.index + match[0].length);
+            const hasReason = afterMatch.includes('--');
+            if (!hasReason) {
+                violations.push({
+                    line: i + 1,
+                    message: `@graph-ignore directive for '${ruleId ?? 'unknown'}' missing a reason comment`,
+                    severity: 'warning',
+                    suggestion: 'Add a reason: @graph-ignore graph:rule-id -- Reason why this is suppressed',
+                    type: 'ignore-without-reason',
+                    match: line.trim().slice(0, 120),
+                });
+            }
+        }
+    }
+    // Flag files with excessive ignore directives
+    if (totalIgnoreDirectives > 7) {
+        violations.push({
+            line: 1,
+            message: `File has ${totalIgnoreDirectives} @graph-ignore directives — consider fixing the underlying issues instead of suppressing`,
+            severity: 'warning',
+            suggestion: 'Review each suppression to determine if the underlying issue can be fixed',
+            type: 'excessive-ignores',
+        });
+    }
+    return violations;
+}
+/**
+ * Check: quality/graph-ignore-hygiene
+ *
+ * Validates that @graph-ignore directives have valid graph rule ids and reason comments.
+ */
+export const graphIgnoreHygiene = defineCheck({
+    id: 'c39f899d-acba-40fd-af5c-299b3462c277',
+    slug: 'graph-ignore-hygiene',
+    // Broad TS source scope: @graph-ignore can appear in any production source
+    // the graph tool analyzes, so this is NOT scoped to `concerns: ['fitness']`.
+    scope: { languages: ['typescript'], concerns: ['backend', 'frontend', 'cli'] },
+    contentFilter: 'raw',
+    description: 'Validates that @graph-ignore directives have valid graph rule ids and reason comments',
+    longDescription: `**Purpose:** Validates the quality of \`@graph-ignore\` directives to prevent stale or undocumented suppressions.
+
+**Detects:**
+- Directives with invalid graph rule ids (not \`graph:<kebab>\`)
+- Directives missing a reason comment (\`-- reason\`)
+- Files with more than 7 ignore directives (suggests fixing underlying issues)
+
+**Why it matters:** Undocumented suppressions accumulate over time and can mask real issues when graph rules change.
+
+**Scope:** General TypeScript source. Analyzes each file individually via regex.`,
+    tags: ['quality', 'graph', 'hygiene'],
+    fileTypes: ['ts'],
+    confidence: 'medium',
+    analyze: analyzeIgnoreHygiene,
+});
+//# sourceMappingURL=graph-ignore-hygiene.js.map

package/dist/checks/quality/graph-ignore-hygiene.js.map

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