@opensip-cli/checks-typescript 0.1.0

package/dist/checks/quality/code-structure/duplicate-utility-functions.js

@@ -0,0 +1,451 @@
+// @fitness-ignore-file throws-documentation -- Functions throw self-documenting typed errors
+// @fitness-ignore-file toctou-race-condition -- TOCTOU acceptable in this non-concurrent context
+// @fitness-ignore-file file-length-limit -- complex check with tightly coupled hash/normalization/scoring logic; splitting would risk losing the duplicate-detection contract
+/**
+ * @fileoverview Duplicate Utility Functions check
+ *
+ * Detects duplicate utility functions that should be consolidated.
+ * Flags TWO types of issues:
+ * 1. Identical implementations - true duplicates that must be deduplicated
+ * 2. Same-named functions with different implementations - consolidation opportunities
+ */
+import { createHash } from 'node:crypto';
+import { basename, dirname } from 'node:path';
+import { defineCheck, getCheckConfig, } from '@opensip-cli/fitness';
+import { getSharedSourceFile } from '@opensip-cli/lang-typescript';
+import * as ts from 'typescript';
+/**
+ * Common utility function name patterns
+ */
+const UTILITY_PATTERNS = [
+    /^format[A-Z]/, // formatDate, formatCurrency
+    /^parse[A-Z]/, // parseJson, parseDate
+    /^is[A-Z]/, // isValid, isEmpty
+    /^has[A-Z]/, // hasValue, hasKey
+    /^to[A-Z]/, // toString, toNumber
+    /^get[A-Z]/, // getValue, getDefault
+    /^validate[A-Z]/, // validateEmail, validatePhone
+    /^sanitize[A-Z]/, // sanitizeInput, sanitizeHtml
+    /^normalize[A-Z]/, // normalizeUrl, normalizeText
+    /^debounce/,
+    /^throttle/,
+    /^sleep/,
+    /^delay/,
+    /^retry/,
+    /^clamp/,
+    /^range/,
+    /^chunk/,
+    /^unique/,
+    /^flatten/,
+];
+/**
+ * Minimum function body length (characters) to consider for duplicate detection.
+ * Very short functions (1-2 lines) are often trivial and not worth flagging.
+ */
+const MIN_FUNCTION_BODY_LENGTH = 50;
+/**
+ * Functions that are intentionally domain-specific and should NOT be flagged
+ * as duplicates. Limited to genuinely generic identifiers — config / factory
+ * / logger / common type-guard names — that almost any TS codebase will hit.
+ *
+ * Project-specific names (e.g. opensip's `getCurrentCorrelationId`,
+ * `formatDuration`, `getRemoteUrl`, `sanitizeForPrompt`) belong in a recipe's
+ * `checks.config['duplicate-utility-functions'].additionalDomainSpecificFunctions`
+ * block. The check reads that list via {@link getCheckConfig} and merges it
+ * with these defaults.
+ */
+const DOMAIN_SPECIFIC_FUNCTIONS = new Set([
+    // Config / factory pattern - each domain has its own configuration
+    'getConfig',
+    'getDefaultConfig',
+    'getContainer',
+    'getFactory',
+    // Logger / shared singletons
+    'getLogger',
+    // Common predicates that have multiple legitimate definitions
+    'isPlainObject',
+    'isStringArray',
+    'isCommentLine',
+    'isTestFile',
+    'isValidEmail',
+    // Common formatter / parser names that vary by input shape
+    'formatDate',
+    'formatTimestamp',
+    'parseArgs',
+    // Common validation entry points
+    'validateConfig',
+    'validateSchema',
+    // Common error-message helper
+    'getErrorMessage',
+    // AST predicates / shared kernel helpers — each layer (engine, lang adapter,
+    // graph adapter) legitimately defines its own implementation tuned to its
+    // node shape; the architecture rules prevent cross-layer imports.
+    'isPropertyAccess',
+    'isFunctionLike',
+    'getSharedSourceFile',
+    'getLineNumber',
+    'isReturnValueDiscarded',
+    // Plugin / package discovery (mirrored in fitness + simulation discovery walkers)
+    'hasPackageJson',
+    // Language-adapter parsers and dir normalizers — one per graph-* pack
+    // (graph-go, graph-java, graph-python, graph-rust, graph-typescript) by
+    // design; cross-pack imports are forbidden by .config/dependency-cruiser.cjs.
+    'normalizeProjectDir',
+    'parseProject',
+    // Tokenizer helper present in several language-adapter strip-comment passes
+    'isIdentChar',
+    // Assertion validation — fitness engine + simulation engine each own one
+    'validateAssertions',
+]);
+/**
+ * Build the effective domain-specific set by merging built-in defaults with
+ * the recipe-provided augmentation for `duplicate-utility-functions`.
+ */
+function buildEffectiveDomainSpecificSet() {
+    const cfg = getCheckConfig('duplicate-utility-functions');
+    if (!cfg.additionalDomainSpecificFunctions ||
+        cfg.additionalDomainSpecificFunctions.length === 0) {
+        return DOMAIN_SPECIFIC_FUNCTIONS;
+    }
+    const merged = new Set(DOMAIN_SPECIFIC_FUNCTIONS);
+    for (const name of cfg.additionalDomainSpecificFunctions)
+        merged.add(name);
+    return merged;
+}
+/**
+ * Get unique directories from a list of function locations
+ */
+function getUniqueDirectories(locations) {
+    /* v8 ignore next -- defensive guard */
+    if (!Array.isArray(locations)) {
+        return new Set();
+    }
+    return new Set(locations.map((l) => dirname(l.file)));
+}
+/**
+ * Flatten all locations from hash groups into a single array
+ */
+function flattenHashGroups(hashGroups) {
+    const allLocations = [];
+    if (hashGroups.size === 0) {
+        return allLocations;
+    }
+    for (const locations of hashGroups.values()) {
+        if (Array.isArray(locations) && locations.length > 0) {
+            allLocations.push(...locations);
+        }
+    }
+    return allLocations;
+}
+/**
+ * Get first location from each hash group (unique implementations)
+ */
+function getFirstFromEachHashGroup(hashGroups) {
+    const uniqueImpls = [];
+    if (hashGroups.size === 0) {
+        return uniqueImpls;
+    }
+    for (const locations of hashGroups.values()) {
+        /* v8 ignore next -- defensive guard */
+        if (!Array.isArray(locations) || locations.length === 0) {
+            continue;
+        }
+        const first = locations[0];
+        if (first) {
+            uniqueImpls.push(first);
+        }
+    }
+    return uniqueImpls;
+}
+/**
+ * Format other files for display in violation message
+ */
+function formatOtherFiles(locations) {
+    const otherFiles = locations
+        .slice(1)
+        .map((l) => basename(l.file))
+        .slice(0, 3);
+    const moreCount = locations.length > 4 ? ` (+${locations.length - 4} more)` : '';
+    return `${otherFiles.join(', ')}${moreCount}`;
+}
+/**
+ * Add a function to the functions-by-name collection
+ */
+function addFunctionToCollection(functionsByName, fn) {
+    let nameGroup = functionsByName.get(fn.name);
+    if (!nameGroup) {
+        nameGroup = new Map();
+        functionsByName.set(fn.name, nameGroup);
+    }
+    let hashGroup = nameGroup.get(fn.bodyHash);
+    if (!hashGroup) {
+        hashGroup = [];
+        nameGroup.set(fn.bodyHash, hashGroup);
+    }
+    hashGroup.push(fn);
+}
+/**
+ * Check if locations represent a valid duplicate across multiple directories.
+ */
+function isValidCrossDirectoryDuplicate(locations) {
+    /* v8 ignore next -- defensive guard */
+    if (!Array.isArray(locations) || locations.length <= 1) {
+        return false;
+    }
+    const locationDirs = getUniqueDirectories(locations);
+    return locationDirs.size > 1;
+}
+/**
+ * Remove single-line comments from code
+ */
+function removeSingleLineComments(code) {
+    return code
+        .split('\n')
+        .map((line) => {
+        const commentIndex = line.indexOf('//');
+        return commentIndex === -1 ? line : line.slice(0, commentIndex);
+    })
+        .join('\n');
+}
+/**
+ * Remove multi-line comments from code
+ * Uses iterative approach to avoid regex backtracking issues.
+ */
+function removeMultiLineComments(code) {
+    let result = '';
+    let i = 0;
+    while (i < code.length) {
+        if (code[i] === '/' && code[i + 1] === '*') {
+            const endIndex = code.indexOf('*/', i + 2);
+            if (endIndex === -1) {
+                break;
+            }
+            i = endIndex + 2;
+        }
+        else {
+            result += code[i];
+            i++;
+        }
+    }
+    return result;
+}
+/**
+ * Normalize function body for comparison.
+ * Removes whitespace, comments, and normalizes identifiers.
+ */
+function normalizeBody(body) {
+    let normalized = body;
+    normalized = removeSingleLineComments(normalized);
+    normalized = removeMultiLineComments(normalized);
+    normalized = normalized.replaceAll(/\s+/g, ' ');
+    normalized = normalized.trim();
+    return normalized;
+}
+/**
+ * Generate a hash of the normalized function body.
+ * Uses SHA-256 for content-addressable deduplication (not for security purposes).
+ */
+function hashBody(body) {
+    const normalized = normalizeBody(body);
+    return createHash('sha256').update(normalized).digest('hex');
+}
+/**
+ * Check if function name matches utility patterns. The `domainSpecific`
+ * argument is the effective allowlist (built-in defaults plus any
+ * recipe-supplied augmentation).
+ */
+function isUtilityFunction(name, domainSpecific) {
+    if (domainSpecific.has(name)) {
+        return false;
+    }
+    return UTILITY_PATTERNS.some((pattern) => pattern.test(name));
+}
+/**
+ * Extract utility functions from a file with their body hashes
+ */
+function extractUtilityFunctionsWithBody(filePath, content, domainSpecific) {
+    const functions = [];
+    try {
+        const sourceFile = getSharedSourceFile(filePath, content);
+        /* v8 ignore next -- defensive guard */
+        if (!sourceFile)
+            return [];
+        const visit = (node) => {
+            // Check function declarations
+            if (ts.isFunctionDeclaration(node) && node.name && node.body) {
+                const name = node.name.text;
+                if (isUtilityFunction(name, domainSpecific)) {
+                    const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+                    const body = node.body.getText(sourceFile);
+                    functions.push({
+                        name,
+                        line: line + 1,
+                        file: filePath,
+                        bodyHash: hashBody(body),
+                        bodyLength: body.length,
+                    });
+                }
+            }
+            // Check arrow functions assigned to variables
+            if (ts.isVariableDeclaration(node) &&
+                ts.isIdentifier(node.name) &&
+                node.initializer &&
+                ts.isArrowFunction(node.initializer)) {
+                const name = node.name.text;
+                if (isUtilityFunction(name, domainSpecific)) {
+                    const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+                    const body = node.initializer.body.getText(sourceFile);
+                    functions.push({
+                        name,
+                        line: line + 1,
+                        file: filePath,
+                        bodyHash: hashBody(body),
+                        bodyLength: body.length,
+                    });
+                }
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(sourceFile);
+        /* v8 ignore next 1 -- defensive catch: parse failures already handled */
+    }
+    catch {
+        // @swallow-ok Ignore parse errors
+    }
+    return functions;
+}
+/**
+ * Create a violation for identical implementations
+ */
+function createIdenticalViolation(name, locations) {
+    const first = locations[0];
+    if (!first) {
+        throw new Error(`createIdenticalViolation called with empty locations array for '${name}'`);
+    }
+    const otherFilesStr = formatOtherFiles(locations);
+    return {
+        line: first.line,
+        message: `Utility function '${name}' has identical implementation in ${locations.length} locations`,
+        severity: 'warning',
+        suggestion: `Move '${name}' to packages/shared/backend/foundation/utils/ or a relevant domain utils module. Also in: ${otherFilesStr}`,
+        type: 'duplicate-utility-identical',
+        match: name,
+        filePath: first.file,
+    };
+}
+/**
+ * Create a violation for similar implementations (same name, different body)
+ */
+function createSimilarViolation(name, uniqueImpls) {
+    const first = uniqueImpls[0];
+    if (!first) {
+        throw new Error(`createSimilarViolation called with empty uniqueImpls array for '${name}'`);
+    }
+    const otherFilesStr = formatOtherFiles(uniqueImpls);
+    const numImplementations = uniqueImpls.length;
+    return {
+        line: first.line,
+        message: `Utility function '${name}' has ${numImplementations} different implementations - consider consolidation with options`,
+        severity: 'warning',
+        suggestion: `Create a unified '${name}' function with configurable options in packages/shared/backend/foundation/utils/. Different implementations found in: ${otherFilesStr}`,
+        type: 'duplicate-utility-similar',
+        match: name,
+        filePath: first.file,
+    };
+}
+async function collectFunctionsFromFiles(files, domainSpecific) {
+    const functionsByName = new Map();
+    for (const filePath of files.paths) {
+        try {
+            // @fitness-ignore-next-line performance-anti-patterns -- sequential file reading to control memory; FileAccessor is lazy
+            const content = await files.read(filePath);
+            const functions = extractUtilityFunctionsWithBody(filePath, content, domainSpecific);
+            const validFunctions = functions.filter((fn) => fn.bodyLength >= MIN_FUNCTION_BODY_LENGTH);
+            for (const fn of validFunctions) {
+                void addFunctionToCollection(functionsByName, fn);
+            }
+            /* v8 ignore next 1 -- defensive catch: parse failures already handled */
+        }
+        catch {
+            // @swallow-ok Skip unreadable files
+        }
+    }
+    return functionsByName;
+}
+function findIdenticalViolations(name, hashGroups) {
+    const violations = [];
+    for (const locations of hashGroups.values()) {
+        if (isValidCrossDirectoryDuplicate(locations)) {
+            violations.push(createIdenticalViolation(name, locations));
+        }
+    }
+    return violations;
+}
+function findSimilarViolation(name, hashGroups) {
+    if (hashGroups.size <= 1) {
+        return null;
+    }
+    const uniqueImpls = getFirstFromEachHashGroup(hashGroups);
+    /* v8 ignore next -- defensive guard */
+    if (!Array.isArray(uniqueImpls) || uniqueImpls.length <= 1) {
+        return null;
+    }
+    const implDirs = getUniqueDirectories(uniqueImpls);
+    if (implDirs.size <= 1) {
+        return null;
+    }
+    return createSimilarViolation(name, uniqueImpls);
+}
+function processFunctionGroup(name, hashGroups) {
+    const allLocations = flattenHashGroups(hashGroups);
+    const dirs = getUniqueDirectories(allLocations);
+    if (dirs.size <= 1 || hashGroups.size === 0) {
+        return [];
+    }
+    const violations = [...findIdenticalViolations(name, hashGroups)];
+    const similarViolation = findSimilarViolation(name, hashGroups);
+    if (similarViolation) {
+        violations.push(similarViolation);
+    }
+    return violations;
+}
+/**
+ * Check: quality/duplicate-utility-functions
+ *
+ * Detects utility functions that should be consolidated across the codebase.
+ * Reports two types of issues:
+ * - IDENTICAL: Same name, same implementation (true duplicates)
+ * - SIMILAR: Same name, different implementation (consolidation opportunities)
+ */
+export const duplicateUtilityFunctions = defineCheck({
+    id: 'aa303a1e-f3f8-4a11-ade2-9e29af89c299',
+    slug: 'duplicate-utility-functions',
+    scope: { languages: ['typescript'], concerns: ['backend', 'frontend', 'cli'] },
+    contentFilter: 'strip-strings',
+    confidence: 'high',
+    description: 'Detect duplicate and similar utility functions',
+    longDescription: `**Purpose:** Detects utility functions that are duplicated or similarly named across the codebase, flagging consolidation opportunities into shared packages.
+
+**Detects:** Cross-file analysis using TypeScript AST extraction and SHA-256 body hashing.
+- **Identical duplicates:** Same-named utility functions with identical normalized bodies in different directories
+- **Similar implementations:** Same-named utility functions with different bodies across directories (consolidation with options pattern)
+- Targets functions matching utility name patterns: \`format*\`, \`parse*\`, \`is*\`, \`has*\`, \`to*\`, \`get*\`, \`validate*\`, \`sanitize*\`, \`normalize*\`, \`debounce\`, \`throttle\`, \`sleep\`, \`retry\`, etc.
+- Skips domain-specific functions listed in \`DOMAIN_SPECIFIC_FUNCTIONS\` and bodies under 50 characters
+
+**Why it matters:** Duplicated utilities create maintenance risk and inconsistent behavior. A single shared implementation in \`foundation/utils\` ensures consistent behavior and reduces code volume.
+
+**Scope:** General best practice`,
+    tags: ['quality', 'dry', 'utilities', 'duplication'],
+    fileTypes: ['ts'],
+    async analyzeAll(files) {
+        const domainSpecific = buildEffectiveDomainSpecificSet();
+        const functionsByName = await collectFunctionsFromFiles(files, domainSpecific);
+        const violations = [];
+        for (const [name, hashGroups] of functionsByName) {
+            // @fitness-ignore-next-line performance-anti-patterns -- spread aggregates small violation arrays from pure function
+            violations.push(...processFunctionGroup(name, hashGroups));
+        }
+        return violations;
+    },
+});
+//# sourceMappingURL=duplicate-utility-functions.js.map

package/dist/checks/quality/code-structure/duplicate-utility-functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-utility-functions.js","sourceRoot":"","sources":["../../../../src/checks/quality/code-structure/duplicate-utility-functions.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,iGAAiG;AACjG,8KAA8K;AAC9K;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EACL,WAAW,EACX,cAAc,GAGf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAiBjC;;GAEG;AACH,MAAM,gBAAgB,GAAG;IACvB,cAAc,EAAE,6BAA6B;IAC7C,aAAa,EAAE,uBAAuB;IACtC,UAAU,EAAE,mBAAmB;IAC/B,WAAW,EAAE,mBAAmB;IAChC,UAAU,EAAE,qBAAqB;IACjC,WAAW,EAAE,uBAAuB;IACpC,gBAAgB,EAAE,+BAA+B;IACjD,gBAAgB,EAAE,8BAA8B;IAChD,iBAAiB,EAAE,8BAA8B;IACjD,WAAW;IACX,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,UAAU;CACX,CAAC;AAEF;;;GAGG;AACH,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAEpC;;;;;;;;;;GAUG;AACH,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IACxC,mEAAmE;IACnE,WAAW;IACX,kBAAkB;IAClB,cAAc;IACd,YAAY;IACZ,6BAA6B;IAC7B,WAAW;IACX,8DAA8D;IAC9D,eAAe;IACf,eAAe;IACf,eAAe;IACf,YAAY;IACZ,cAAc;IACd,2DAA2D;IAC3D,YAAY;IACZ,iBAAiB;IACjB,WAAW;IACX,iCAAiC;IACjC,gBAAgB;IAChB,gBAAgB;IAChB,8BAA8B;IAC9B,iBAAiB;IACjB,6EAA6E;IAC7E,0EAA0E;IAC1E,kEAAkE;IAClE,kBAAkB;IAClB,gBAAgB;IAChB,qBAAqB;IACrB,eAAe;IACf,wBAAwB;IACxB,kFAAkF;IAClF,gBAAgB;IAChB,sEAAsE;IACtE,wEAAwE;IACxE,8EAA8E;IAC9E,qBAAqB;IACrB,cAAc;IACd,4EAA4E;IAC5E,aAAa;IACb,yEAAyE;IACzE,oBAAoB;CACrB,CAAC,CAAC;AAEH;;;GAGG;AACH,SAAS,+BAA+B;IACtC,MAAM,GAAG,GAAG,cAAc,CAAkC,6BAA6B,CAAC,CAAC;IAC3F,IACE,CAAC,GAAG,CAAC,iCAAiC;QACtC,GAAG,CAAC,iCAAiC,CAAC,MAAM,KAAK,CAAC,EAClD,CAAC;QACD,OAAO,yBAAyB,CAAC;IACnC,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAClD,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,iCAAiC;QAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC;AAChB,CAAC;AAaD;;GAEG;AACH,SAAS,oBAAoB,CAAC,SAAyB;IACrD,uCAAuC;IACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,UAAuC;IAChE,MAAM,YAAY,GAAmB,EAAE,CAAC;IACxC,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrD,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAC,UAAuC;IACxE,MAAM,WAAW,GAAmB,EAAE,CAAC;IACvC,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5C,uCAAuC;QACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,KAAK,EAAE,CAAC;YACV,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,SAAyB;IACjD,MAAM,UAAU,GAAG,SAAS;SACzB,KAAK,CAAC,CAAC,CAAC;SACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAC5B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACf,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAAC,eAAgC,EAAE,EAAgB;IACjF,IAAI,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,EAAE,CAAC;QACf,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,SAAS,8BAA8B,CAAC,SAAyB;IAC/D,uCAAuC;IACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACvD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,YAAY,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACrD,OAAO,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB,CAAC,IAAY;IAC5C,OAAO,IAAI;SACR,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IAClE,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAAC,IAAY;IAC3C,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3C,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;gBACpB,MAAM;YACR,CAAC;YACD,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,UAAU,GAAG,IAAI,CAAC;IACtB,UAAU,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAC;IAClD,UAAU,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACjD,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChD,UAAU,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAC/B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,IAAY,EAAE,cAAmC;IAC1E,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,SAAS,+BAA+B,CACtC,QAAgB,EAChB,OAAe,EACf,cAAmC;IAEnC,MAAM,SAAS,GAAmB,EAAE,CAAC;IAErC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC1D,uCAAuC;QACvC,IAAI,CAAC,UAAU;YAAE,OAAO,EAAE,CAAC;QAE3B,MAAM,KAAK,GAAG,CAAC,IAAa,EAAE,EAAE;YAC9B,8BAA8B;YAC9B,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC5B,IAAI,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC;oBAC5C,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;oBAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBAC3C,SAAS,CAAC,IAAI,CAAC;wBACb,IAAI;wBACJ,IAAI,EAAE,IAAI,GAAG,CAAC;wBACd,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC;wBACxB,UAAU,EAAE,IAAI,CAAC,MAAM;qBACxB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,8CAA8C;YAC9C,IACE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC;gBAC9B,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC1B,IAAI,CAAC,WAAW;gBAChB,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,EACpC,CAAC;gBACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC5B,IAAI,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC;oBAC5C,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;oBAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBACvD,SAAS,CAAC,IAAI,CAAC;wBACb,IAAI;wBACJ,IAAI,EAAE,IAAI,GAAG,CAAC;wBACd,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC;wBACxB,UAAU,EAAE,IAAI,CAAC,MAAM;qBACxB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC,CAAC;QAEF,KAAK,CAAC,UAAU,CAAC,CAAC;QAClB,yEAAyE;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB,CAAC,IAAY,EAAE,SAAyB;IACvE,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,mEAAmE,IAAI,GAAG,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,aAAa,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAElD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,qBAAqB,IAAI,qCAAqC,SAAS,CAAC,MAAM,YAAY;QACnG,QAAQ,EAAE,SAAS;QACnB,UAAU,EAAE,SAAS,IAAI,8FAA8F,aAAa,EAAE;QACtI,IAAI,EAAE,6BAA6B;QACnC,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,KAAK,CAAC,IAAI;KACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,IAAY,EAAE,WAA2B;IACvE,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,mEAAmE,IAAI,GAAG,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,aAAa,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,kBAAkB,GAAG,WAAW,CAAC,MAAM,CAAC;IAE9C,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,qBAAqB,IAAI,SAAS,kBAAkB,kEAAkE;QAC/H,QAAQ,EAAE,SAAS;QACnB,UAAU,EAAE,qBAAqB,IAAI,0HAA0H,aAAa,EAAE;QAC9K,IAAI,EAAE,2BAA2B;QACjC,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,KAAK,CAAC,IAAI;KACrB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,KAAmB,EACnB,cAAmC;IAEnC,MAAM,eAAe,GAAoB,IAAI,GAAG,EAAE,CAAC;IAEnD,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,yHAAyH;YACzH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3C,MAAM,SAAS,GAAG,+BAA+B,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;YACrF,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,IAAI,wBAAwB,CAAC,CAAC;YAE3F,KAAK,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC;gBAChC,KAAK,uBAAuB,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;YACpD,CAAC;YACD,yEAAyE;QAC3E,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,SAAS,uBAAuB,CAC9B,IAAY,EACZ,UAAuC;IAEvC,MAAM,UAAU,GAAqB,EAAE,CAAC;IAExC,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5C,IAAI,8BAA8B,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9C,UAAU,CAAC,IAAI,CAAC,wBAAwB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,oBAAoB,CAC3B,IAAY,EACZ,UAAuC;IAEvC,IAAI,UAAU,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;IAC1D,uCAAuC;IACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACnD,IAAI,QAAQ,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,sBAAsB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,oBAAoB,CAC3B,IAAY,EACZ,UAAuC;IAEvC,MAAM,YAAY,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAEhD,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAqB,CAAC,GAAG,uBAAuB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;IAEpF,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAChE,IAAI,gBAAgB,EAAE,CAAC;QACrB,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,WAAW,CAAC;IACnD,EAAE,EAAE,sCAAsC;IAC1C,IAAI,EAAE,6BAA6B;IACnC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE;IAC9E,aAAa,EAAE,eAAe;IAE9B,UAAU,EAAE,MAAM;IAClB,WAAW,EAAE,gDAAgD;IAC7D,eAAe,EAAE;;;;;;;;;;iCAUc;IAC/B,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,CAAC;IACpD,SAAS,EAAE,CAAC,IAAI,CAAC;IAEjB,KAAK,CAAC,UAAU,CAAC,KAAmB;QAClC,MAAM,cAAc,GAAG,+BAA+B,EAAE,CAAC;QACzD,MAAM,eAAe,GAAG,MAAM,yBAAyB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QAC/E,MAAM,UAAU,GAAqB,EAAE,CAAC;QAExC,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,eAAe,EAAE,CAAC;YACjD,qHAAqH;YACrH,UAAU,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF,CAAC,CAAC"}

package/dist/checks/quality/code-structure/index.d.ts

@@ -0,0 +1,3 @@
+export * from './duplicate-utility-functions.js';
+export * from './no-any-types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/checks/quality/code-structure/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/checks/quality/code-structure/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC"}

package/dist/checks/quality/code-structure/index.js

@@ -0,0 +1,3 @@
+export * from './duplicate-utility-functions.js';
+export * from './no-any-types.js';
+//# sourceMappingURL=index.js.map

package/dist/checks/quality/code-structure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/checks/quality/code-structure/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC"}

package/dist/checks/quality/code-structure/no-any-types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview No Any Types Check
+ *
+ * Detects usage of 'any' type in TypeScript code. The 'any' type bypasses
+ * type checking and should be replaced with 'unknown' with proper type narrowing.
+ */
+/**
+ * Check: quality/no-any-types
+ *
+ * Detects usage of any type - use unknown with type narrowing instead.
+ */
+export declare const noAnyTypes: import("@opensip-cli/fitness").Check;
+//# sourceMappingURL=no-any-types.d.ts.map

package/dist/checks/quality/code-structure/no-any-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-any-types.d.ts","sourceRoot":"","sources":["../../../../src/checks/quality/code-structure/no-any-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwFH;;;;GAIG;AACH,eAAO,MAAM,UAAU,sCA2BrB,CAAC"}

package/dist/checks/quality/code-structure/no-any-types.js

@@ -0,0 +1,116 @@
+/**
+ * @fileoverview No Any Types Check
+ *
+ * Detects usage of 'any' type in TypeScript code. The 'any' type bypasses
+ * type checking and should be replaced with 'unknown' with proper type narrowing.
+ */
+import { defineCheck } from '@opensip-cli/fitness';
+import { getSharedSourceFile } from '@opensip-cli/lang-typescript';
+import * as ts from 'typescript';
+/**
+ * Quick filter keywords for 'any' type patterns
+ */
+const QUICK_FILTER_KEYWORDS = [': any', 'any)', 'any,', 'any;', '<any', 'any>'];
+/**
+ * Find lines with eslint-disable-next-line comments
+ */
+function findDisabledLines(content) {
+    const disabledLines = new Set();
+    const lines = content.split('\n');
+    for (const [i, line] of lines.entries()) {
+        if (line?.includes('eslint-disable-next-line')) {
+            disabledLines.add(i + 1);
+        }
+    }
+    return disabledLines;
+}
+/**
+ * Analyze a file for 'any' type usage
+ */
+function analyzeFile(content, filePath) {
+    const violations = [];
+    const disabledLines = findDisabledLines(content);
+    try {
+        const sourceFile = getSharedSourceFile(filePath, content);
+        /* v8 ignore next -- defensive guard */
+        if (!sourceFile)
+            return violations;
+        const visit = (node) => {
+            if (node.kind === ts.SyntaxKind.AnyKeyword) {
+                const parent = node.parent;
+                const { line, character } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+                // Skip if this line has an eslint-disable-next-line comment
+                if (disabledLines.has(line)) {
+                    ts.forEachChild(node, visit);
+                    return;
+                }
+                // Get context from parent
+                let context = 'type annotation';
+                if (ts.isParameter(parent)) {
+                    context = 'function parameter';
+                }
+                else if (ts.isVariableDeclaration(parent)) {
+                    context = 'variable declaration';
+                }
+                else if (ts.isPropertySignature(parent) || ts.isPropertyDeclaration(parent)) {
+                    context = 'property';
+                }
+                else if (ts.isFunctionDeclaration(parent) || ts.isMethodDeclaration(parent)) {
+                    context = 'return type';
+                }
+                else if (ts.isTypeAliasDeclaration(parent)) {
+                    context = 'type alias';
+                }
+                violations.push({
+                    line: line + 1,
+                    column: character + 1,
+                    message: `'any' type used in ${context}`,
+                    severity: 'error',
+                    type: 'any-type',
+                    suggestion: "Replace 'any' with 'unknown' and add type narrowing with type guards or assertion functions.",
+                    match: 'any',
+                    filePath,
+                });
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(sourceFile);
+        /* v8 ignore next 1 -- defensive catch: parse failures already handled */
+    }
+    catch {
+        // @swallow-ok Skip files that fail to parse
+    }
+    return violations;
+}
+/**
+ * Check: quality/no-any-types
+ *
+ * Detects usage of any type - use unknown with type narrowing instead.
+ */
+export const noAnyTypes = defineCheck({
+    id: '3d456769-bbcb-461f-8efd-e7b340dcb1b8',
+    slug: 'no-any-types',
+    scope: { languages: ['typescript'], concerns: ['backend', 'frontend', 'cli'] },
+    description: 'Detect usage of any type - use unknown with type narrowing instead',
+    longDescription: `**Purpose:** Detects usage of the \`any\` type in TypeScript code, which bypasses type checking and should be replaced with \`unknown\` plus proper type narrowing.
+
+**Detects:** Analyzes each file individually using TypeScript AST traversal for \`AnyKeyword\` nodes.
+- \`any\` in function parameters, variable declarations, property signatures, return types, and type aliases
+- Respects \`eslint-disable-next-line\` comments on the preceding line
+- Uses a quick-filter optimization: skips files not containing \`: any\`, \`any)\`, \`any,\`, \`any;\`, \`<any\`, or \`any>\`
+
+**Why it matters:** The \`any\` type disables TypeScript's type safety, hiding bugs that would otherwise be caught at compile time. Using \`unknown\` with type guards preserves safety while handling dynamic data.
+
+**Scope:** General best practice`,
+    tags: ['quality', 'type-safety', 'code-quality'],
+    fileTypes: ['ts', 'tsx'],
+    confidence: 'high',
+    analyze(content, filePath) {
+        // Quick filter: skip files without 'any' type patterns
+        if (!QUICK_FILTER_KEYWORDS.some((kw) => content.includes(kw))) {
+            return [];
+        }
+        return analyzeFile(content, filePath);
+    },
+});
+//# sourceMappingURL=no-any-types.js.map

package/dist/checks/quality/code-structure/no-any-types.js.map

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

package/dist/checks/quality/data-integrity/__tests__/null-safety-fp.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Regression tests for two `null-safety` FP fixes.
+ *
+ * 1. Cross-line guard: a property access guarded by an enclosing `if` / `&&`
+ *    on a PREVIOUS line (e.g. `if (candidates.length === 1 && candidates[0])
+ *    { … candidates[0].bodyHash … }`) was flagged because the safety scan was
+ *    line-local. The fix walks enclosing conditions.
+ * 2. Immutable combinators: `.merge(...)` chained on a factory result
+ *    (e.g. OTel `detectResources(...).merge(...)`) returns a non-null value
+ *    and is now a known-safe fluent method.
+ *
+ * Genuine unguarded access on a call/element result must still fire.
+ */
+export {};
+//# sourceMappingURL=null-safety-fp.test.d.ts.map

package/dist/checks/quality/data-integrity/__tests__/null-safety-fp.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-safety-fp.test.d.ts","sourceRoot":"","sources":["../../../../../src/checks/quality/data-integrity/__tests__/null-safety-fp.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}