@opencodereview/core 1.9.1

package/dist/reporter/v4-terminal.js.map

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

package/dist/scanner/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Scanner Module — V4 Scan Orchestrator
+ *
+ * Provides the V4Scanner which orchestrates parsing, detection, and scoring.
+ *
+ * @since 0.4.0
+ */
+export { V4Scanner, createV4Scanner, DEFAULT_INCLUDE_PATTERNS, DEFAULT_EXCLUDE_PATTERNS, type V4ScanConfig, type V4ScanResult, type SLALevel, } from './v4-scanner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/scanner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scanner/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,SAAS,EACT,eAAe,EACf,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,QAAQ,GACd,MAAM,iBAAiB,CAAC"}

package/dist/scanner/index.js

@@ -0,0 +1,9 @@
+/**
+ * Scanner Module — V4 Scan Orchestrator
+ *
+ * Provides the V4Scanner which orchestrates parsing, detection, and scoring.
+ *
+ * @since 0.4.0
+ */
+export { V4Scanner, createV4Scanner, DEFAULT_INCLUDE_PATTERNS, DEFAULT_EXCLUDE_PATTERNS, } from './v4-scanner.js';
+//# sourceMappingURL=index.js.map

package/dist/scanner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scanner/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,SAAS,EACT,eAAe,EACf,wBAAwB,EACxB,wBAAwB,GAIzB,MAAM,iBAAiB,CAAC"}

package/dist/scanner/v4-scanner.d.ts

@@ -0,0 +1,162 @@
+/**
+ * V4 Scan Orchestrator
+ *
+ * The top-level orchestrator that ties together parsing, detection, and scoring.
+ * Supports multiple SLA levels (L1/L2/L3) and internationalization.
+ *
+ * @since 0.4.0
+ */
+import type { CodeUnit, SupportedLanguage } from '../ir/types.js';
+import type { RegistryOptions } from '../registry/types.js';
+import type { V4Detector, DetectorResult } from '../detectors/v4/types.js';
+import { type Locale } from '../i18n/index.js';
+/**
+ * SLA level for scan depth.
+ * - L1: Fast — Structural analysis only
+ * - L2: Standard — Structural + Embedding + Local AI
+ * - L3: Deep — Structural + Embedding + Remote AI
+ */
+export type SLALevel = 'L1' | 'L2' | 'L3';
+/**
+ * Configuration for V4 scan.
+ */
+export interface V4ScanConfig {
+    /** Project root directory */
+    projectRoot: string;
+    /** Languages to scan (auto-detect if empty) */
+    languages?: SupportedLanguage[];
+    /** SLA level */
+    sla?: SLALevel;
+    /** Registry configuration */
+    registry?: RegistryOptions;
+    /** Locale for output */
+    locale?: Locale;
+    /** Custom detectors (overrides default set) */
+    detectors?: V4Detector[];
+    /** File patterns to include (globs) */
+    include?: string[];
+    /** File patterns to exclude (globs) */
+    exclude?: string[];
+    /** Scoring threshold (default: 70) */
+    threshold?: number;
+    /** AI pipeline configuration (for L2/L3) */
+    ai?: {
+        embedding?: {
+            provider?: 'local' | 'openai' | 'ollama';
+            model?: string;
+            baseUrl?: string;
+        };
+        llm?: {
+            provider?: 'ollama' | 'openai' | 'anthropic';
+            model?: string;
+            endpoint?: string;
+        };
+        remote?: {
+            provider?: 'openai' | 'anthropic';
+            model?: string;
+            apiKey?: string;
+        };
+    };
+}
+/**
+ * Result of a V4 scan.
+ */
+export interface V4ScanResult {
+    /** All issues found */
+    issues: DetectorResult[];
+    /** Parsed code units */
+    codeUnits: CodeUnit[];
+    /** Files scanned (relative paths) */
+    files: string[];
+    /** Languages detected */
+    languages: SupportedLanguage[];
+    /** Total scan duration in ms */
+    durationMs: number;
+    /** Per-stage timing */
+    stages: {
+        discovery: number;
+        parsing: number;
+        detection: number;
+        ai?: number;
+    };
+    /** Score (if scoring enabled) */
+    score?: {
+        total: number;
+        grade: string;
+        dimensions: Record<string, number>;
+    };
+    /** Project root */
+    projectRoot: string;
+    /** SLA level used */
+    sla: SLALevel;
+}
+/**
+ * V4 Scanner — orchestrates the full scan pipeline.
+ *
+ * Pipeline stages:
+ * 1. File discovery — walk project root, respect include/exclude patterns
+ * 2. Parsing — tree-sitter parse, extract CodeUnit IR
+ * 3. Detection — run all structural detectors
+ * 4. AI analysis (L2/L3 only) — embedding recall + LLM deep scan
+ * 5. Scoring — compute quality score
+ *
+ * @example
+ * ```ts
+ * const scanner = new V4Scanner({
+ *   projectRoot: '/path/to/project',
+ *   sla: 'L1',
+ *   locale: 'en',
+ * });
+ *
+ * const result = await scanner.scan();
+ * console.log(`Found ${result.issues.length} issues`);
+ * ```
+ */
+export declare class V4Scanner {
+    private config;
+    private parserManager;
+    private registryManager?;
+    private detectors;
+    private i18n;
+    private extractors;
+    constructor(config: V4ScanConfig);
+    /**
+     * Run the full scan pipeline.
+     */
+    scan(): Promise<V4ScanResult>;
+    /**
+     * Discover files to scan based on include/exclude patterns.
+     */
+    private discoverFiles;
+    /**
+     * Walk directory recursively, filtering by include/exclude patterns.
+     */
+    private walkDirectory;
+    /**
+     * Check if a directory should be excluded.
+     */
+    private shouldExcludeDir;
+    /**
+     * Check if a file should be included based on patterns.
+     */
+    private shouldIncludeFile;
+    /**
+     * Detect language from file extension.
+     */
+    private detectLanguage;
+    /**
+     * Get the extractor for a language.
+     */
+    private getExtractor;
+    /**
+     * Build AIConfig from V4ScanConfig for the AI pipeline.
+     */
+    private buildAIConfig;
+}
+export declare const DEFAULT_INCLUDE_PATTERNS: string[];
+export declare const DEFAULT_EXCLUDE_PATTERNS: string[];
+/**
+ * Create a V4 scanner with the given configuration.
+ */
+export declare function createV4Scanner(config: V4ScanConfig): V4Scanner;
+//# sourceMappingURL=v4-scanner.d.ts.map

package/dist/scanner/v4-scanner.d.ts.map

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

package/dist/scanner/v4-scanner.js

@@ -0,0 +1,327 @@
+/**
+ * V4 Scan Orchestrator
+ *
+ * The top-level orchestrator that ties together parsing, detection, and scoring.
+ * Supports multiple SLA levels (L1/L2/L3) and internationalization.
+ *
+ * @since 0.4.0
+ */
+import { readdir, readFile } from 'node:fs/promises';
+import { join, relative, extname } from 'node:path';
+import { ParserManager } from '../parser/manager.js';
+import { TypeScriptExtractor } from '../parser/extractors/typescript.js';
+import { PythonExtractor } from '../parser/extractors/python.js';
+import { JavaExtractor } from '../parser/extractors/java.js';
+import { GoExtractor } from '../parser/extractors/go.js';
+import { KotlinExtractor } from '../parser/extractors/kotlin.js';
+import { RegistryManager } from '../registry/registry-manager.js';
+import { createV4Detectors } from '../detectors/v4/index.js';
+import { DefaultI18nProvider } from '../i18n/index.js';
+import { AIScanPipeline } from '../ai/v4/pipeline.js';
+// ─── V4 Scanner ────────────────────────────────────────────────────
+/**
+ * V4 Scanner — orchestrates the full scan pipeline.
+ *
+ * Pipeline stages:
+ * 1. File discovery — walk project root, respect include/exclude patterns
+ * 2. Parsing — tree-sitter parse, extract CodeUnit IR
+ * 3. Detection — run all structural detectors
+ * 4. AI analysis (L2/L3 only) — embedding recall + LLM deep scan
+ * 5. Scoring — compute quality score
+ *
+ * @example
+ * ```ts
+ * const scanner = new V4Scanner({
+ *   projectRoot: '/path/to/project',
+ *   sla: 'L1',
+ *   locale: 'en',
+ * });
+ *
+ * const result = await scanner.scan();
+ * console.log(`Found ${result.issues.length} issues`);
+ * ```
+ */
+export class V4Scanner {
+    config;
+    parserManager;
+    registryManager;
+    detectors;
+    i18n;
+    extractors;
+    constructor(config) {
+        this.config = config;
+        this.parserManager = new ParserManager();
+        this.i18n = new DefaultI18nProvider(config.locale);
+        this.detectors = config.detectors ?? createV4Detectors();
+        // Initialize registry manager if config provided
+        if (config.registry) {
+            this.registryManager = new RegistryManager(config.registry);
+        }
+        // Initialize extractors for all supported languages
+        this.extractors = new Map([
+            ['typescript', new TypeScriptExtractor()],
+            ['javascript', new TypeScriptExtractor()], // JS uses TS extractor
+            ['python', new PythonExtractor()],
+            ['java', new JavaExtractor()],
+            ['go', new GoExtractor()],
+            ['kotlin', new KotlinExtractor()],
+        ]);
+    }
+    /**
+     * Run the full scan pipeline.
+     */
+    async scan() {
+        const startTime = Date.now();
+        // 1. Initialize parser
+        const initStart = Date.now();
+        await this.parserManager.init();
+        // Init time not tracked separately, included in parsing
+        // 2. Discover files
+        const discoveryStart = Date.now();
+        const files = await this.discoverFiles();
+        const discoveryDuration = Date.now() - discoveryStart;
+        // 3. Parse all files → CodeUnits
+        const parseStart = Date.now();
+        const allUnits = [];
+        for (const file of files) {
+            const language = this.detectLanguage(file);
+            if (!language)
+                continue;
+            try {
+                const absolutePath = join(this.config.projectRoot, file);
+                const source = await readFile(absolutePath, 'utf-8');
+                const tree = this.parserManager.parse(source, language);
+                const extractor = this.extractors.get(language);
+                if (extractor) {
+                    const units = extractor.extract(tree, file, source);
+                    allUnits.push(...units);
+                }
+            }
+            catch {
+                // Skip files that can't be parsed
+                continue;
+            }
+        }
+        const parseDuration = Date.now() - parseStart;
+        // 4. Run structural detectors
+        const detectStart = Date.now();
+        const context = {
+            projectRoot: this.config.projectRoot,
+            allFiles: files,
+            registryManager: this.registryManager,
+        };
+        const allIssues = [];
+        for (const detector of this.detectors) {
+            try {
+                const issues = await detector.detect(allUnits, context);
+                allIssues.push(...issues);
+            }
+            catch {
+                // Skip detectors that fail
+                continue;
+            }
+        }
+        const detectDuration = Date.now() - detectStart;
+        // 5. AI pipeline (L2/L3 only)
+        let aiDuration;
+        const sla = this.config.sla ?? 'L1';
+        if (sla !== 'L1' && allUnits.length > 0) {
+            const aiStartTime = Date.now();
+            try {
+                const aiConfig = this.buildAIConfig(sla);
+                const pipeline = new AIScanPipeline(aiConfig);
+                const aiResult = await pipeline.scan(allUnits, allIssues);
+                // Merge AI issues (skip the structural stage which is duplicated)
+                for (const stage of aiResult.stages) {
+                    if (stage.stage !== 'structural') {
+                        allIssues.push(...stage.issues);
+                    }
+                }
+            }
+            catch {
+                // Graceful degradation: AI pipeline failure doesn't block scan
+            }
+            aiDuration = Date.now() - aiStartTime;
+        }
+        // 6. Build result
+        const result = {
+            issues: allIssues,
+            codeUnits: allUnits,
+            files,
+            languages: [...new Set(allUnits.map(u => u.language))],
+            durationMs: Date.now() - startTime,
+            stages: {
+                discovery: discoveryDuration,
+                parsing: parseDuration,
+                detection: detectDuration,
+                ai: aiDuration,
+            },
+            projectRoot: this.config.projectRoot,
+            sla,
+        };
+        return result;
+    }
+    /**
+     * Discover files to scan based on include/exclude patterns.
+     */
+    async discoverFiles() {
+        const projectRoot = this.config.projectRoot;
+        const include = this.config.include ?? DEFAULT_INCLUDE_PATTERNS;
+        const exclude = this.config.exclude ?? DEFAULT_EXCLUDE_PATTERNS;
+        const files = await this.walkDirectory(projectRoot, include, exclude);
+        return files.map(f => relative(projectRoot, f));
+    }
+    /**
+     * Walk directory recursively, filtering by include/exclude patterns.
+     */
+    async walkDirectory(dir, include, exclude) {
+        const files = [];
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                // Check if directory should be excluded
+                if (this.shouldExcludeDir(entry.name, exclude)) {
+                    continue;
+                }
+                // Recurse into subdirectory
+                const subFiles = await this.walkDirectory(fullPath, include, exclude);
+                files.push(...subFiles);
+            }
+            else if (entry.isFile()) {
+                // Check if file should be included
+                if (this.shouldIncludeFile(entry.name, include, exclude)) {
+                    files.push(fullPath);
+                }
+            }
+        }
+        return files;
+    }
+    /**
+     * Check if a directory should be excluded.
+     */
+    shouldExcludeDir(name, exclude) {
+        const excludeDirs = exclude
+            .filter(p => p.includes('/**/') || p.endsWith('/**'))
+            .map(p => p.replace('/**', '').replace('**/', '').replace('**', ''));
+        return excludeDirs.includes(name) ||
+            name === 'node_modules' ||
+            name === 'dist' ||
+            name === 'build' ||
+            name === '.git' ||
+            name === 'vendor' ||
+            name === '__pycache__' ||
+            name === 'target';
+    }
+    /**
+     * Check if a file should be included based on patterns.
+     */
+    shouldIncludeFile(name, include, exclude) {
+        // Check extension against include patterns
+        const ext = extname(name).toLowerCase();
+        const includedExtensions = include
+            .filter(p => p.startsWith('**/*.'))
+            .map(p => p.replace('**/*', ''));
+        const hasMatchingInclude = includedExtensions.length === 0 || includedExtensions.includes(ext);
+        // Check exclusion patterns
+        const isExcluded = exclude.some(pattern => {
+            if (pattern.includes(name))
+                return true;
+            if (pattern.startsWith('**/*') && pattern.endsWith(ext))
+                return true;
+            return false;
+        });
+        return hasMatchingInclude && !isExcluded;
+    }
+    /**
+     * Detect language from file extension.
+     */
+    detectLanguage(filePath) {
+        const ext = extname(filePath).toLowerCase();
+        const mapping = {
+            '.ts': 'typescript',
+            '.tsx': 'typescript',
+            '.js': 'javascript',
+            '.jsx': 'javascript',
+            '.mjs': 'javascript',
+            '.cjs': 'javascript',
+            '.py': 'python',
+            '.java': 'java',
+            '.go': 'go',
+            '.kt': 'kotlin',
+            '.kts': 'kotlin',
+        };
+        return mapping[ext] ?? null;
+    }
+    /**
+     * Get the extractor for a language.
+     */
+    getExtractor(language) {
+        return this.extractors.get(language);
+    }
+    /**
+     * Build AIConfig from V4ScanConfig for the AI pipeline.
+     */
+    buildAIConfig(sla) {
+        const ai = this.config.ai;
+        const aiConfig = {
+            sla,
+            embedding: ai?.embedding ? {
+                provider: ai.embedding.provider ?? 'local',
+                model: ai.embedding.model,
+                baseUrl: ai.embedding.baseUrl,
+            } : { provider: 'local' },
+        };
+        // Wire up local LLM config from ai.llm
+        if (ai?.llm?.provider === 'ollama' && ai.llm.model) {
+            aiConfig.local = {
+                provider: 'ollama',
+                model: ai.llm.model,
+                baseUrl: ai.llm.endpoint ?? 'http://localhost:11434',
+            };
+        }
+        // Wire up remote LLM config
+        if (ai?.remote?.provider && ai.remote.apiKey) {
+            aiConfig.remote = {
+                provider: ai.remote.provider,
+                model: ai.remote.model ?? 'gpt-4o-mini',
+                apiKey: ai.remote.apiKey,
+            };
+        }
+        return aiConfig;
+    }
+}
+// ─── Default Patterns ───────────────────────────────────────────────
+export const DEFAULT_INCLUDE_PATTERNS = [
+    '**/*.ts',
+    '**/*.tsx',
+    '**/*.js',
+    '**/*.jsx',
+    '**/*.mjs',
+    '**/*.cjs',
+    '**/*.py',
+    '**/*.java',
+    '**/*.go',
+    '**/*.kt',
+    '**/*.kts',
+];
+export const DEFAULT_EXCLUDE_PATTERNS = [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/.git/**',
+    '**/vendor/**',
+    '**/__pycache__/**',
+    '**/target/**',
+    '**/*.test.*',
+    '**/*.spec.*',
+    '**/__tests__/**',
+];
+// ─── Factory ────────────────────────────────────────────────────────
+/**
+ * Create a V4 scanner with the given configuration.
+ */
+export function createV4Scanner(config) {
+    return new V4Scanner(config);
+}
+//# sourceMappingURL=v4-scanner.js.map

package/dist/scanner/v4-scanner.js.map

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

package/dist/scorer/report.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Report Generator V3
+ *
+ * Formats validation results into various output formats:
+ * - Terminal (human-readable with colors and SLA metrics)
+ * - JSON (machine-readable)
+ * - Markdown (for PR comments)
+ * - GitLab Code Quality (for CI integration)
+ *
+ * V3 additions:
+ * - Support for new AggregateScoreV3 / FileScoreV3 types
+ * - SLA metrics section in terminal and markdown output
+ * - Dimension-based breakdown (AI Faithfulness, Code Freshness, etc.)
+ * - Backward compatible with legacy AggregateScore
+ */
+import type { AggregateScore, AggregateScoreV3 } from './scoring-engine.js';
+import type { SLAMetrics } from '../sla/types.js';
+/** Output format type */
+export type ReportFormat = 'terminal' | 'json' | 'markdown' | 'gitlab-report';
+/** GitLab Code Quality issue format for CI/CD integration. */
+export interface GitLabCodeQualityIssue {
+    description: string;
+    check_name: string;
+    fingerprint: string;
+    severity: 'info' | 'minor' | 'major' | 'critical' | 'blocker';
+    location: {
+        path: string;
+        lines: {
+            begin: number;
+        };
+    };
+}
+export declare class ReportGenerator {
+    /**
+     * Generate a V3 report with optional SLA metrics.
+     */
+    generateV3(result: AggregateScoreV3, format: ReportFormat, slaMetrics?: SLAMetrics): string;
+    /**
+     * Generate a legacy report (backward compatible).
+     */
+    generate(result: AggregateScore, format: ReportFormat): string;
+    private formatTerminalV3;
+    private formatJSONV3;
+    private formatMarkdownV3;
+    private formatGitLabReportV3;
+    private formatTerminal;
+    private formatJSON;
+    private formatMarkdown;
+    private formatGitLabReport;
+}
+export default ReportGenerator;
+//# sourceMappingURL=report.d.ts.map

package/dist/scorer/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/scorer/report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,cAAc,EAGd,gBAAgB,EAGjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,yBAAyB;AACzB,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,CAAC;AAE9E,8DAA8D;AAC9D,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IAC9D,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1B,CAAC;CACH;AAqCD,qBAAa,eAAe;IAC1B;;OAEG;IACH,UAAU,CACR,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,YAAY,EACpB,UAAU,CAAC,EAAE,UAAU,GACtB,MAAM;IAUT;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM;IAY9D,OAAO,CAAC,gBAAgB;IA+ExB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,gBAAgB;IAiExB,OAAO,CAAC,oBAAoB;IA0B5B,OAAO,CAAC,cAAc;IA8CtB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,kBAAkB;CA4B3B;AAmCD,eAAe,eAAe,CAAC"}