@opencodereview/core 1.9.1

package/dist/detectors/v4/stale-api.d.ts

@@ -0,0 +1,59 @@
+/**
+ * StaleAPIDetector — V4 detector for deprecated APIs and packages.
+ *
+ * AI models are trained on historical data and frequently generate code using
+ * APIs that have since been deprecated. This detector catches them through:
+ * 1. Dynamic registry deprecation checks (npm deprecated field, etc.)
+ * 2. Well-known per-language deprecated API patterns
+ *
+ * V4 improvements over V3:
+ * - Registry-based deprecation checks instead of hardcoded data
+ * - Operates on CodeUnit IR (calls + imports)
+ * - Per-language deprecation pattern database
+ * - Confidence scoring based on deprecation source
+ *
+ * @since 0.4.0
+ */
+import type { CodeUnit, SupportedLanguage } from '../../ir/types.js';
+import type { V4Detector, DetectorResult, DetectorCategory, DetectorContext } from './types.js';
+/** Definition of a deprecated API pattern for detection. */
+export interface DeprecatedPattern {
+    /** Pattern to match in call expressions (callee string) */
+    pattern: string | RegExp;
+    /** What replaces it */
+    replacement: string;
+    /** Since when deprecated */
+    since?: string;
+    /** Confidence level */
+    confidence: number;
+    /** Human-readable description */
+    description?: string;
+}
+export declare class StaleAPIDetector implements V4Detector {
+    readonly id = "stale-api";
+    readonly name = "Stale API Detector";
+    readonly category: DetectorCategory;
+    readonly supportedLanguages: SupportedLanguage[];
+    detect(units: CodeUnit[], context: DetectorContext): Promise<DetectorResult[]>;
+    /**
+     * Check package deprecation status via the registry manager.
+     */
+    private checkRegistryDeprecations;
+    /**
+     * Check well-known deprecated API patterns in source code.
+     */
+    private checkPatternDeprecations;
+    /**
+     * Check deprecated import modules (entire modules that are deprecated).
+     */
+    private checkDeprecatedImports;
+    /**
+     * Extract top-level package name from a module path.
+     */
+    private extractPackageName;
+    /**
+     * Escape a string for use in a regular expression.
+     */
+    private escapeRegex;
+}
+//# sourceMappingURL=stale-api.d.ts.map

package/dist/detectors/v4/stale-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-api.d.ts","sourceRoot":"","sources":["../../../src/detectors/v4/stale-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIhG,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAgRD,qBAAa,gBAAiB,YAAW,UAAU;IACjD,QAAQ,CAAC,EAAE,eAAe;IAC1B,QAAQ,CAAC,IAAI,wBAAwB;IACrC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAoB;IACvD,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,CAAM;IAEhD,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAepF;;OAEG;YACW,yBAAyB;IAiEvC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAgDhC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAoC9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB"}

package/dist/detectors/v4/stale-api.js

@@ -0,0 +1,470 @@
+/**
+ * StaleAPIDetector — V4 detector for deprecated APIs and packages.
+ *
+ * AI models are trained on historical data and frequently generate code using
+ * APIs that have since been deprecated. This detector catches them through:
+ * 1. Dynamic registry deprecation checks (npm deprecated field, etc.)
+ * 2. Well-known per-language deprecated API patterns
+ *
+ * V4 improvements over V3:
+ * - Registry-based deprecation checks instead of hardcoded data
+ * - Operates on CodeUnit IR (calls + imports)
+ * - Per-language deprecation pattern database
+ * - Confidence scoring based on deprecation source
+ *
+ * @since 0.4.0
+ */
+// ─── Well-known deprecation patterns per language ──────────────────
+const TYPESCRIPT_DEPRECATIONS = [
+    {
+        pattern: /\bnew\s+Buffer\b/,
+        replacement: 'Buffer.from() / Buffer.alloc()',
+        since: 'Node.js 6',
+        confidence: 0.95,
+        description: 'Buffer constructor is deprecated due to security and usability issues',
+    },
+    {
+        pattern: /\burl\.parse\b/,
+        replacement: 'new URL()',
+        since: 'Node.js 11',
+        confidence: 0.85,
+        description: 'url.parse() is deprecated in favor of the WHATWG URL API',
+    },
+    {
+        pattern: /\bfs\.exists\b/,
+        replacement: 'fs.existsSync() or fs.access()',
+        since: 'Node.js 1.0',
+        confidence: 0.9,
+        description: 'fs.exists() is deprecated; use fs.existsSync() or fs.access()',
+    },
+    {
+        pattern: /\brequire\s*\(\s*['"]querystring['"]\s*\)/,
+        replacement: 'URLSearchParams',
+        since: 'Node.js 12',
+        confidence: 0.8,
+        description: 'querystring module is deprecated in favor of URLSearchParams',
+    },
+    {
+        pattern: /\brequire\s*\(\s*['"]domain['"]\s*\)/,
+        replacement: 'async_hooks or structured error handling',
+        since: 'Node.js 4',
+        confidence: 0.9,
+        description: 'domain module is deprecated and pending removal',
+    },
+    {
+        pattern: /\brequire\s*\(\s*['"]punycode['"]\s*\)/,
+        replacement: 'Use a userland alternative or URL API',
+        since: 'Node.js 7',
+        confidence: 0.8,
+        description: 'punycode module is deprecated',
+    },
+    {
+        pattern: /\bSlowBuffer\b/,
+        replacement: 'Buffer.allocUnsafeSlow()',
+        since: 'Node.js 6',
+        confidence: 0.9,
+        description: 'SlowBuffer is deprecated in favor of Buffer.allocUnsafeSlow()',
+    },
+];
+const PYTHON_DEPRECATIONS = [
+    {
+        pattern: /\bimport\s+optparse\b/,
+        replacement: 'argparse',
+        since: 'Python 3.2',
+        confidence: 0.95,
+        description: 'optparse is deprecated in favor of argparse',
+    },
+    {
+        pattern: /\bimport\s+imp\b/,
+        replacement: 'importlib',
+        since: 'Python 3.4',
+        confidence: 0.95,
+        description: 'imp module is deprecated in favor of importlib',
+    },
+    {
+        pattern: /\bcollections\.MutableMapping\b/,
+        replacement: 'collections.abc.MutableMapping',
+        since: 'Python 3.3',
+        confidence: 0.9,
+        description: 'Direct access to abstract base classes from collections is deprecated',
+    },
+    {
+        pattern: /\bcollections\.MutableSequence\b/,
+        replacement: 'collections.abc.MutableSequence',
+        since: 'Python 3.3',
+        confidence: 0.9,
+        description: 'Direct access to abstract base classes from collections is deprecated',
+    },
+    {
+        pattern: /\bcollections\.MutableSet\b/,
+        replacement: 'collections.abc.MutableSet',
+        since: 'Python 3.3',
+        confidence: 0.9,
+        description: 'Direct access to abstract base classes from collections is deprecated',
+    },
+    {
+        pattern: /\basyncio\.coroutine\b/,
+        replacement: 'async def',
+        since: 'Python 3.8',
+        confidence: 0.95,
+        description: '@asyncio.coroutine decorator is deprecated in favor of async def',
+    },
+    {
+        pattern: /\bimport\s+distutils\b/,
+        replacement: 'setuptools',
+        since: 'Python 3.10',
+        confidence: 0.9,
+        description: 'distutils is deprecated and removed in Python 3.12',
+    },
+    {
+        pattern: /\bimport\s+cgi\b/,
+        replacement: 'urllib.parse or email.message',
+        since: 'Python 3.11',
+        confidence: 0.85,
+        description: 'cgi module is deprecated',
+    },
+];
+const JAVA_DEPRECATIONS = [
+    {
+        pattern: /\bnew\s+Date\(\)/,
+        replacement: 'LocalDateTime.now() / Instant.now()',
+        since: 'Java 8',
+        confidence: 0.7,
+        description: 'java.util.Date is largely deprecated in favor of java.time API',
+    },
+    {
+        pattern: /\bVector\b/,
+        replacement: 'ArrayList (or Collections.synchronizedList)',
+        since: 'Java 1.2',
+        confidence: 0.85,
+        description: 'Vector is legacy; use ArrayList or CopyOnWriteArrayList',
+    },
+    {
+        pattern: /\bStringBuffer\b/,
+        replacement: 'StringBuilder',
+        since: 'Java 1.5',
+        confidence: 0.8,
+        description: 'StringBuffer is slower than StringBuilder; use StringBuilder unless thread-safety needed',
+    },
+    {
+        pattern: /\bThread\.stop\b/,
+        replacement: 'Thread interruption pattern',
+        since: 'Java 1.2',
+        confidence: 0.95,
+        description: 'Thread.stop() is deprecated because it is inherently unsafe',
+    },
+    {
+        pattern: /\bThread\.suspend\b/,
+        replacement: 'Use wait/notify or LockSupport',
+        since: 'Java 1.2',
+        confidence: 0.95,
+        description: 'Thread.suspend() is deprecated due to deadlock risks',
+    },
+    {
+        pattern: /\bThread\.resume\b/,
+        replacement: 'Use wait/notify or LockSupport',
+        since: 'Java 1.2',
+        confidence: 0.95,
+        description: 'Thread.resume() is deprecated due to deadlock risks',
+    },
+    {
+        pattern: /\bHashtable\b/,
+        replacement: 'HashMap or ConcurrentHashMap',
+        since: 'Java 1.2',
+        confidence: 0.8,
+        description: 'Hashtable is legacy; use HashMap or ConcurrentHashMap',
+    },
+    {
+        pattern: /\bRuntime\.getRuntime\(\)\.exec\b/,
+        replacement: 'ProcessBuilder',
+        since: 'Java 9',
+        confidence: 0.7,
+        description: 'Runtime.exec() has known issues; prefer ProcessBuilder',
+    },
+];
+const GO_DEPRECATIONS = [
+    {
+        pattern: /\bioutil\.ReadFile\b/,
+        replacement: 'os.ReadFile',
+        since: 'Go 1.16',
+        confidence: 0.95,
+        description: 'io/ioutil is deprecated; use os.ReadFile',
+    },
+    {
+        pattern: /\bioutil\.WriteFile\b/,
+        replacement: 'os.WriteFile',
+        since: 'Go 1.16',
+        confidence: 0.95,
+        description: 'io/ioutil is deprecated; use os.WriteFile',
+    },
+    {
+        pattern: /\bioutil\.ReadAll\b/,
+        replacement: 'io.ReadAll',
+        since: 'Go 1.16',
+        confidence: 0.95,
+        description: 'io/ioutil is deprecated; use io.ReadAll',
+    },
+    {
+        pattern: /\bioutil\.TempDir\b/,
+        replacement: 'os.MkdirTemp',
+        since: 'Go 1.16',
+        confidence: 0.95,
+        description: 'io/ioutil is deprecated; use os.MkdirTemp',
+    },
+    {
+        pattern: /\bioutil\.TempFile\b/,
+        replacement: 'os.CreateTemp',
+        since: 'Go 1.16',
+        confidence: 0.95,
+        description: 'io/ioutil is deprecated; use os.CreateTemp',
+    },
+    {
+        pattern: /\bioutil\.ReadDir\b/,
+        replacement: 'os.ReadDir',
+        since: 'Go 1.16',
+        confidence: 0.95,
+        description: 'io/ioutil is deprecated; use os.ReadDir',
+    },
+    {
+        pattern: /\bioutil\.NopCloser\b/,
+        replacement: 'io.NopCloser',
+        since: 'Go 1.16',
+        confidence: 0.95,
+        description: 'io/ioutil is deprecated; use io.NopCloser',
+    },
+    {
+        pattern: /\bimport\s+["']io\/ioutil["']/,
+        replacement: 'io and os packages',
+        since: 'Go 1.16',
+        confidence: 0.95,
+        description: 'The entire io/ioutil package is deprecated since Go 1.16',
+    },
+];
+const KOTLIN_DEPRECATIONS = [
+    {
+        pattern: /\bkotlin\.coroutines\.experimental\b/,
+        replacement: 'kotlin.coroutines',
+        since: 'Kotlin 1.3',
+        confidence: 0.95,
+        description: 'Experimental coroutines API is deprecated; use stable kotlin.coroutines',
+    },
+    // Kotlin inherits Java deprecations
+    ...JAVA_DEPRECATIONS,
+];
+// ─── Deprecation patterns map ──────────────────────────────────────
+const DEPRECATION_PATTERNS = new Map([
+    ['typescript', TYPESCRIPT_DEPRECATIONS],
+    ['javascript', TYPESCRIPT_DEPRECATIONS],
+    ['python', PYTHON_DEPRECATIONS],
+    ['java', JAVA_DEPRECATIONS],
+    ['go', GO_DEPRECATIONS],
+    ['kotlin', KOTLIN_DEPRECATIONS],
+]);
+// ─── Deprecated import modules (package-level deprecation) ─────────
+const DEPRECATED_IMPORT_MODULES = new Map([
+    ['python', new Map([
+            ['optparse', { replacement: 'argparse', since: 'Python 3.2' }],
+            ['imp', { replacement: 'importlib', since: 'Python 3.4' }],
+            ['distutils', { replacement: 'setuptools', since: 'Python 3.10' }],
+            ['cgi', { replacement: 'urllib.parse or email.message', since: 'Python 3.11' }],
+        ])],
+    ['go', new Map([
+            ['io/ioutil', { replacement: 'io and os packages', since: 'Go 1.16' }],
+        ])],
+]);
+// ─── Detector ──────────────────────────────────────────────────────
+export class StaleAPIDetector {
+    id = 'stale-api';
+    name = 'Stale API Detector';
+    category = 'code-freshness';
+    supportedLanguages = [];
+    async detect(units, context) {
+        const results = [];
+        // Phase 1: Check package-level deprecation via registry
+        await this.checkRegistryDeprecations(units, context, results);
+        // Phase 2: Check well-known deprecated API patterns in source code
+        this.checkPatternDeprecations(units, results);
+        // Phase 3: Check deprecated import modules
+        this.checkDeprecatedImports(units, results);
+        return results;
+    }
+    /**
+     * Check package deprecation status via the registry manager.
+     */
+    async checkRegistryDeprecations(units, context, results) {
+        if (!context.registryManager)
+            return;
+        // Collect unique import packages by language
+        const importsByLanguage = new Map();
+        for (const unit of units) {
+            if (unit.kind !== 'file')
+                continue;
+            for (const imp of unit.imports) {
+                if (imp.isRelative)
+                    continue;
+                const packageName = this.extractPackageName(imp.module, unit.language);
+                if (!importsByLanguage.has(unit.language)) {
+                    importsByLanguage.set(unit.language, new Map());
+                }
+                const langMap = importsByLanguage.get(unit.language);
+                if (!langMap.has(packageName)) {
+                    langMap.set(packageName, []);
+                }
+                langMap.get(packageName).push({ file: unit.file, line: imp.line });
+            }
+        }
+        // Check each package for deprecation
+        for (const [language, packageMap] of importsByLanguage.entries()) {
+            const registry = context.registryManager.getRegistry(language);
+            if (!registry)
+                continue;
+            for (const [packageName, occurrences] of packageMap.entries()) {
+                try {
+                    const deprecation = await registry.checkDeprecated(packageName);
+                    if (deprecation?.deprecated) {
+                        for (const occurrence of occurrences) {
+                            results.push({
+                                detectorId: this.id,
+                                severity: 'warning',
+                                category: this.category,
+                                messageKey: 'stale-api.registry-deprecated',
+                                message: `Package "${packageName}" is deprecated${deprecation.message ? ': ' + deprecation.message : ''}${deprecation.replacement ? '. Use ' + deprecation.replacement + ' instead' : ''}.`,
+                                file: occurrence.file,
+                                line: occurrence.line + 1, // 0-based to 1-based
+                                confidence: 0.95,
+                                metadata: {
+                                    packageName,
+                                    language,
+                                    source: 'registry',
+                                    deprecationMessage: deprecation.message,
+                                    replacement: deprecation.replacement,
+                                    since: deprecation.since,
+                                },
+                            });
+                        }
+                    }
+                }
+                catch {
+                    // Registry check failed; skip silently (conservative)
+                }
+            }
+        }
+    }
+    /**
+     * Check well-known deprecated API patterns in source code.
+     */
+    checkPatternDeprecations(units, results) {
+        for (const unit of units) {
+            const patterns = DEPRECATION_PATTERNS.get(unit.language);
+            if (!patterns)
+                continue;
+            // Check source text against known deprecated patterns
+            const lines = unit.source.split('\n');
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                for (const pattern of patterns) {
+                    const regex = pattern.pattern instanceof RegExp
+                        ? pattern.pattern
+                        : new RegExp(this.escapeRegex(pattern.pattern), 'g');
+                    if (regex.test(line)) {
+                        const absoluteLine = unit.location.startLine + i;
+                        results.push({
+                            detectorId: this.id,
+                            severity: 'warning',
+                            category: this.category,
+                            messageKey: 'stale-api.deprecated-pattern',
+                            message: pattern.description || `Deprecated API usage detected. Use ${pattern.replacement} instead${pattern.since ? ' (deprecated since ' + pattern.since + ')' : ''}.`,
+                            file: unit.file,
+                            line: absoluteLine + 1, // 0-based to 1-based
+                            confidence: pattern.confidence,
+                            metadata: {
+                                language: unit.language,
+                                source: 'pattern',
+                                replacement: pattern.replacement,
+                                since: pattern.since,
+                                matchedPattern: pattern.pattern instanceof RegExp
+                                    ? pattern.pattern.source
+                                    : pattern.pattern,
+                            },
+                        });
+                    }
+                    // Reset regex lastIndex for global patterns
+                    if (pattern.pattern instanceof RegExp) {
+                        pattern.pattern.lastIndex = 0;
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Check deprecated import modules (entire modules that are deprecated).
+     */
+    checkDeprecatedImports(units, results) {
+        for (const unit of units) {
+            if (unit.kind !== 'file')
+                continue;
+            const deprecatedModules = DEPRECATED_IMPORT_MODULES.get(unit.language);
+            if (!deprecatedModules)
+                continue;
+            for (const imp of unit.imports) {
+                const topModule = imp.module.split(/[./]/)[0];
+                const deprecation = deprecatedModules.get(imp.module) || deprecatedModules.get(topModule);
+                if (deprecation) {
+                    results.push({
+                        detectorId: this.id,
+                        severity: 'warning',
+                        category: this.category,
+                        messageKey: 'stale-api.deprecated-module',
+                        message: `Module "${imp.module}" is deprecated${deprecation.since ? ' since ' + deprecation.since : ''}. Use ${deprecation.replacement} instead.`,
+                        file: unit.file,
+                        line: imp.line + 1, // 0-based to 1-based
+                        confidence: 0.9,
+                        metadata: {
+                            module: imp.module,
+                            language: unit.language,
+                            source: 'known-deprecation',
+                            replacement: deprecation.replacement,
+                            since: deprecation.since,
+                        },
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Extract top-level package name from a module path.
+     */
+    extractPackageName(module, language) {
+        switch (language) {
+            case 'typescript':
+            case 'javascript': {
+                if (module.startsWith('@')) {
+                    const parts = module.split('/');
+                    return parts.length >= 2 ? `${parts[0]}/${parts[1]}` : module;
+                }
+                return module.split('/')[0];
+            }
+            case 'python':
+                return module.split('.')[0];
+            case 'java':
+            case 'kotlin':
+                return module;
+            case 'go': {
+                const parts = module.split('/');
+                if (parts.length >= 3 && module.includes('.')) {
+                    return parts.slice(0, 3).join('/');
+                }
+                return module;
+            }
+            default:
+                return module;
+        }
+    }
+    /**
+     * Escape a string for use in a regular expression.
+     */
+    escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+}
+//# sourceMappingURL=stale-api.js.map

package/dist/detectors/v4/stale-api.js.map

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

package/dist/detectors/v4/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * V4 Detector Types — Base interfaces for all V4 detectors.
+ *
+ * V4 detectors operate on the unified CodeUnit IR instead of raw source.
+ * Only AI-unique detectors are included; traditional lint concerns are removed.
+ *
+ * @since 0.4.0
+ */
+import type { CodeUnit, SupportedLanguage } from '../../ir/types.js';
+import type { RegistryManager } from '../../registry/registry-manager.js';
+/**
+ * Result from a V4 detector. Each result represents a single detected issue.
+ */
+export interface DetectorResult {
+    /** Detector identifier */
+    detectorId: string;
+    /** Severity: error > warning > info */
+    severity: 'error' | 'warning' | 'info';
+    /** Issue category for scoring */
+    category: DetectorCategory;
+    /** Human-readable message (i18n key) */
+    messageKey: string;
+    /** Fallback message (English) */
+    message: string;
+    /** Affected file */
+    file: string;
+    /** Line number (1-based for output) */
+    line: number;
+    /** End line (optional) */
+    endLine?: number;
+    /** Confidence score 0-1 */
+    confidence: number;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * V4 detector categories aligned with V3 scoring dimensions.
+ */
+export type DetectorCategory = 'ai-faithfulness' | 'code-freshness' | 'context-coherence' | 'implementation';
+/**
+ * Context provided to detectors during analysis.
+ */
+export interface DetectorContext {
+    /** Project root directory */
+    projectRoot: string;
+    /** All file paths in the project */
+    allFiles: string[];
+    /** Registry manager for package verification */
+    registryManager?: RegistryManager;
+    /** Configuration overrides */
+    config?: Record<string, unknown>;
+}
+/**
+ * V4 Detector — the unified detector interface for V4.
+ *
+ * All V4 detectors operate on CodeUnit[] (the unified IR),
+ * never on raw source code or CST nodes.
+ */
+export interface V4Detector {
+    /** Unique detector ID */
+    readonly id: string;
+    /** Human-readable name */
+    readonly name: string;
+    /** Which category this contributes to */
+    readonly category: DetectorCategory;
+    /** Which languages this detector supports (empty = all) */
+    readonly supportedLanguages: SupportedLanguage[];
+    /**
+     * Analyze CodeUnits and return issues.
+     * Detectors receive already-parsed, language-neutral CodeUnits.
+     */
+    detect(units: CodeUnit[], context: DetectorContext): Promise<DetectorResult[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/detectors/v4/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/detectors/v4/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAI1E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,iCAAiC;IACjC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAID;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,GACjB,gBAAgB,GAChB,mBAAmB,GACnB,gBAAgB,CAAC;AAIrB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gDAAgD;IAChD,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAID;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,2DAA2D;IAC3D,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IAEjD;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAChF"}

package/dist/detectors/v4/types.js

@@ -0,0 +1,10 @@
+/**
+ * V4 Detector Types — Base interfaces for all V4 detectors.
+ *
+ * V4 detectors operate on the unified CodeUnit IR instead of raw source.
+ * Only AI-unique detectors are included; traditional lint concerns are removed.
+ *
+ * @since 0.4.0
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/detectors/v4/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/detectors/v4/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}