@opencodereview/core 1.9.1

package/dist/detectors/duplication.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Duplication Detector (V3)
+ *
+ * Detects AI-generated code redundancy patterns:
+ * 1. Near-identical function bodies (copy-paste with minor changes)
+ * 2. Repeated logic blocks that should be extracted
+ * 3. Duplicate import statements
+ *
+ * Implements the unified Detector interface.
+ *
+ * @since 0.2.0 (original)
+ * @since 0.3.0 (V3 unified interface)
+ */
+import type { Detector, UnifiedIssue, FileAnalysis } from '../types.js';
+/**
+ * @deprecated Use UnifiedIssue instead. Will be removed in v0.4.0.
+ */
+export interface DuplicationIssue {
+    type: 'duplicate-function' | 'duplicate-block' | 'duplicate-import';
+    severity: 'warning' | 'error';
+    file: string;
+    line: number;
+    message: string;
+    suggestion?: string;
+    duplicateOf?: {
+        file: string;
+        line: number;
+    };
+}
+/**
+ * @deprecated Use UnifiedIssue[] instead. Will be removed in v0.4.0.
+ */
+export interface DuplicationResult {
+    file: string;
+    issues: DuplicationIssue[];
+    score: number;
+}
+/**
+ * DuplicationDetector — detects AI-generated code duplication patterns.
+ *
+ * V3: Implements the unified Detector interface.
+ * V2 (deprecated): Old analyze() signature still works.
+ */
+export declare class DuplicationDetector implements Detector {
+    readonly name = "duplication";
+    readonly version = "2.0.0";
+    readonly tier: 1;
+    private similarityThreshold;
+    constructor(similarityThreshold?: number);
+    /**
+     * V3 unified detect method.
+     */
+    detect(files: FileAnalysis[]): Promise<UnifiedIssue[]>;
+    /**
+     * Analyze a single file for duplication issues.
+     * @deprecated Use detect(files) instead. Will be removed in v0.4.0.
+     */
+    analyze(filePath: string, source: string): DuplicationResult;
+}
+export default DuplicationDetector;
+//# sourceMappingURL=duplication.d.ts.map

package/dist/detectors/duplication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplication.d.ts","sourceRoot":"","sources":["../../src/detectors/duplication.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAY,MAAM,aAAa,CAAC;AAKlF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;IACpE,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAmID;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,QAAQ;IAClD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAG,CAAC,CAAU;IAE3B,OAAO,CAAC,mBAAmB,CAAS;gBAExB,mBAAmB,GAAE,MAAY;IAM7C;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAgB5D;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB;CAqC7D;AAED,eAAe,mBAAmB,CAAC"}

package/dist/detectors/duplication.js

@@ -0,0 +1,204 @@
+/**
+ * Duplication Detector (V3)
+ *
+ * Detects AI-generated code redundancy patterns:
+ * 1. Near-identical function bodies (copy-paste with minor changes)
+ * 2. Repeated logic blocks that should be extracted
+ * 3. Duplicate import statements
+ *
+ * Implements the unified Detector interface.
+ *
+ * @since 0.2.0 (original)
+ * @since 0.3.0 (V3 unified interface)
+ */
+import { AIDefectCategory } from '../types.js';
+// ─── Internal Detection Functions ───
+function normalizeLine(line) {
+    return line
+        .replace(/\/\/.*$/, '')
+        .replace(/\/\*.*?\*\//g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/** Extract the brace-delimited body starting at `startIdx`, returning normalized lines. */
+function extractBracedBody(lines, startIdx) {
+    const bodyLines = [];
+    let braceDepth = 0;
+    let started = false;
+    for (let j = startIdx; j < lines.length; j++) {
+        for (const ch of lines[j]) {
+            if (ch === '{') {
+                braceDepth++;
+                started = true;
+            }
+            if (ch === '}')
+                braceDepth--;
+        }
+        bodyLines.push(normalizeLine(lines[j]));
+        if (started && braceDepth === 0)
+            break;
+    }
+    return bodyLines;
+}
+/** Try to match a function declaration on a given line. */
+function matchFunctionDeclaration(line) {
+    const isDestructuring = /(?:const|let|var)\s*\{/.test(line) || /(?:const|let|var)\s*\[/.test(line);
+    if (isDestructuring)
+        return null;
+    const isSimpleAssignment = /(?:const|let|var)\s+\w+\s*=\s*[^(=>]/.test(line) &&
+        !/(?:async\s*)?\(/.test(line.split('=').slice(1).join('='));
+    if (isSimpleAssignment)
+        return null;
+    return line.match(/(?:(?:export\s+)?(?:async\s+)?function\s+(\w+)|(?:(?:public|private|protected|static|async|override)\s+)+(\w+)\s*\(|(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s*)?\()/);
+}
+function extractFunctionBlocks(lines) {
+    const blocks = [];
+    for (let i = 0; i < lines.length; i++) {
+        const funcMatch = matchFunctionDeclaration(lines[i]);
+        if (!funcMatch)
+            continue;
+        const name = funcMatch[1] || funcMatch[2] || funcMatch[3];
+        const bodyLines = extractBracedBody(lines, i);
+        if (bodyLines.length > 2) {
+            blocks.push({ name, startLine: i + 1, body: bodyLines });
+        }
+    }
+    return blocks;
+}
+function computeSimilarity(a, b) {
+    if (a.length === 0 || b.length === 0)
+        return 0;
+    const longer = a.length >= b.length ? a : b;
+    const shorter = a.length >= b.length ? b : a;
+    let matches = 0;
+    for (let i = 0; i < shorter.length; i++) {
+        if (shorter[i] === longer[i])
+            matches++;
+    }
+    return matches / longer.length;
+}
+function detectDuplicateImports(lines, filePath) {
+    const issues = [];
+    const seenImports = new Map();
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        const importMatch = line.match(/import\s+.*?\s+from\s+['"]([^'"]+)['"]/);
+        if (importMatch) {
+            const mod = importMatch[1];
+            if (seenImports.has(mod)) {
+                issues.push({
+                    type: 'duplicate-import',
+                    severity: 'warning',
+                    file: filePath,
+                    line: i + 1,
+                    message: `Duplicate import from '${mod}'`,
+                    suggestion: 'Merge imports from the same module into a single statement.',
+                    duplicateOf: { file: filePath, line: seenImports.get(mod) },
+                });
+            }
+            else {
+                seenImports.set(mod, i + 1);
+            }
+        }
+    }
+    return issues;
+}
+// ─── Severity & Category Mapping ───
+function mapSeverity(type) {
+    switch (type) {
+        case 'duplicate-function':
+            return 'low'; // Traditional tools cover this; V3 downgrades
+        case 'duplicate-block':
+            return 'low';
+        case 'duplicate-import':
+            return 'info';
+        default:
+            return 'low';
+    }
+}
+function toUnifiedIssue(issue, index) {
+    return {
+        id: `duplication:${index}`,
+        detector: 'duplication',
+        category: AIDefectCategory.DUPLICATION,
+        severity: mapSeverity(issue.type),
+        message: issue.message,
+        file: issue.file,
+        line: issue.line,
+        fix: issue.suggestion ? {
+            description: issue.suggestion,
+            autoFixable: false,
+        } : undefined,
+    };
+}
+// ─── Main Detector ───
+/**
+ * DuplicationDetector — detects AI-generated code duplication patterns.
+ *
+ * V3: Implements the unified Detector interface.
+ * V2 (deprecated): Old analyze() signature still works.
+ */
+export class DuplicationDetector {
+    name = 'duplication';
+    version = '2.0.0';
+    tier = 1;
+    similarityThreshold;
+    constructor(similarityThreshold = 0.8) {
+        this.similarityThreshold = similarityThreshold;
+    }
+    // ─── V3 Unified Interface ───
+    /**
+     * V3 unified detect method.
+     */
+    async detect(files) {
+        const allIssues = [];
+        let globalIndex = 0;
+        for (const file of files) {
+            const result = this.analyze(file.path, file.content);
+            for (const issue of result.issues) {
+                allIssues.push(toUnifiedIssue(issue, globalIndex++));
+            }
+        }
+        return allIssues;
+    }
+    // ─── V2 Legacy Interface (Deprecated) ───
+    /**
+     * Analyze a single file for duplication issues.
+     * @deprecated Use detect(files) instead. Will be removed in v0.4.0.
+     */
+    analyze(filePath, source) {
+        const lines = source.split('\n');
+        const rawIssues = [];
+        rawIssues.push(...detectDuplicateImports(lines, filePath));
+        const blocks = extractFunctionBlocks(lines);
+        for (let i = 0; i < blocks.length; i++) {
+            for (let j = i + 1; j < blocks.length; j++) {
+                const similarity = computeSimilarity(blocks[i].body, blocks[j].body);
+                if (similarity >= this.similarityThreshold) {
+                    rawIssues.push({
+                        type: 'duplicate-function',
+                        severity: 'warning',
+                        file: filePath,
+                        line: blocks[j].startLine,
+                        message: `Function '${blocks[j].name}' is ${Math.round(similarity * 100)}% similar to '${blocks[i].name}'`,
+                        suggestion: 'Extract common logic into a shared helper function.',
+                        duplicateOf: { file: filePath, line: blocks[i].startLine },
+                    });
+                }
+            }
+        }
+        const issues = rawIssues.filter(issue => {
+            if (issue.line <= 0)
+                return true;
+            const prevLine = lines[issue.line - 2] || '';
+            return !prevLine.includes('// ai-validator-ignore') && !prevLine.includes('// ai-validator-disable');
+        });
+        const errorCount = issues.filter(i => i.severity === 'error').length;
+        const warningCount = issues.filter(i => i.severity === 'warning').length;
+        const deductions = (errorCount * 15) + (warningCount * 5);
+        const score = Math.max(0, 100 - deductions);
+        return { file: filePath, issues, score };
+    }
+}
+export default DuplicationDetector;
+//# sourceMappingURL=duplication.js.map

package/dist/detectors/duplication.js.map

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

package/dist/detectors/hallucination.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Hallucination Detector (V3)
+ *
+ * Detects AI-generated code hallucination patterns:
+ * 1. References to non-existent npm packages (compared against package.json)
+ * 2. Calls to undefined functions/variables
+ * 3. Usage of non-existent API endpoints (if OpenAPI spec is provided)
+ * 4. Imported but never-defined types
+ *
+ * Implements the unified Detector interface.
+ * Backward compatible: old analyze() signature is preserved but deprecated.
+ *
+ * @since 0.2.0 (original)
+ * @since 0.3.0 (V3 unified interface)
+ */
+import type { Detector, UnifiedIssue, FileAnalysis } from '../types.js';
+/**
+ * @deprecated Use UnifiedIssue instead. Will be removed in v0.4.0.
+ */
+export interface HallucinationIssue {
+    type: 'phantom-package' | 'phantom-function' | 'phantom-api' | 'phantom-type';
+    severity: 'error' | 'warning';
+    file: string;
+    line: number;
+    column?: number;
+    message: string;
+    suggestion?: string;
+}
+/**
+ * @deprecated Use Detector.detect() instead. Will be removed in v0.4.0.
+ */
+export interface HallucinationDetectorOptions {
+    projectRoot: string;
+    openApiSpecPath?: string;
+    knownPackages?: string[];
+    ignoreDecorators?: boolean;
+}
+/**
+ * @deprecated Use UnifiedIssue[] instead. Will be removed in v0.4.0.
+ */
+export interface HallucinationResult {
+    file: string;
+    issues: HallucinationIssue[];
+    score: number;
+}
+/**
+ * HallucinationDetector — detects AI-generated hallucination patterns.
+ *
+ * V3: Implements the unified Detector interface.
+ * V2 (deprecated): Old analyze() signature still works for backward compatibility.
+ */
+export declare class HallucinationDetector implements Detector {
+    readonly name = "hallucination";
+    readonly version = "2.0.0";
+    readonly tier: 1;
+    private validPackages;
+    private options;
+    private ignoreDecorators;
+    constructor(options: HallucinationDetectorOptions);
+    /**
+     * V3 unified detect method.
+     * Processes multiple files and returns UnifiedIssue[].
+     */
+    detect(files: FileAnalysis[]): Promise<UnifiedIssue[]>;
+    /**
+     * Analyze a single file for hallucination issues.
+     * @deprecated Use detect(files) instead. Will be removed in v0.4.0.
+     */
+    analyze(filePath: string, source?: string): HallucinationResult;
+    /**
+     * Analyze multiple files.
+     * @deprecated Use detect(files) instead. Will be removed in v0.4.0.
+     */
+    analyzeMany(files: Array<{
+        path: string;
+        source?: string;
+    }>): HallucinationResult[];
+}
+export default HallucinationDetector;
+//# sourceMappingURL=hallucination.d.ts.map

package/dist/detectors/hallucination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hallucination.d.ts","sourceRoot":"","sources":["../../src/detectors/hallucination.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKxE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,iBAAiB,GAAG,kBAAkB,GAAG,aAAa,GAAG,cAAc,CAAC;IAC9E,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAsPD;;;;;GAKG;AACH,qBAAa,qBAAsB,YAAW,QAAQ;IACpD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAG,CAAC,CAAU;IAE3B,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,gBAAgB,CAAU;gBAEtB,OAAO,EAAE,4BAA4B;IAWjD;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAiB5D;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,mBAAmB;IAgD/D;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,mBAAmB,EAAE;CAGpF;AAED,eAAe,qBAAqB,CAAC"}