@opencodereview/core 1.9.1

package/dist/ai/v4/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Open Code Review V4 — AI Pipeline Module
+ *
+ * Two-stage AI scan pipeline for detecting AI-generated code defects:
+ * - Stage 1 (Embedding): Fast similarity-based defect detection
+ * - Stage 2 (LLM): Deep analysis of suspicious code blocks
+ *
+ * SLA levels control which stages run:
+ * - L1 Fast: Structural detectors only (no AI)
+ * - L2 Standard: + Embedding recall + Local LLM (Ollama)
+ * - L3 Deep: + Remote LLM (OpenAI/Claude)
+ *
+ * @since 0.4.0
+ *
+ * @example
+ * ```ts
+ * import {
+ *   AIScanPipeline,
+ *   createPipelineForSLA,
+ *   LocalEmbeddingProvider,
+ *   OllamaLLMProvider,
+ *   DEFECT_PATTERNS,
+ * } from 'open-code-review-core';
+ *
+ * // Create pipeline for L2 (standard) with local LLM
+ * const pipeline = createPipelineForSLA('L2', {
+ *   local: { provider: 'ollama', model: 'codellama:13b' },
+ * });
+ *
+ * // Run the scan
+ * const result = await pipeline.scan(codeUnits, structuralResults);
+ *
+ * console.log(`Found ${result.totalIssues} issues in ${result.totalDurationMs}ms`);
+ * console.log(`SLA level: ${result.slaLevel}`);
+ *
+ * for (const stage of result.stages) {
+ *   console.log(`Stage ${stage.stage}: ${stage.issues.length} issues`);
+ * }
+ * ```
+ */
+export type { SLALevel, EmbeddingProvider, LLMProvider, LLMOptions, LLMResponse, AIConfig, ScanStageResult, AIPipelineResult, } from './types.js';
+export { LocalEmbeddingProvider, OpenAIEmbeddingProvider, OllamaEmbeddingProvider, tokenize, cosineSimilarity, findTopMatches, } from './embedding/index.js';
+export { OllamaLLMProvider, OpenAILLMProvider, AnthropicLLMProvider } from './llm/index.js';
+export { OllamaLLMProvider as OllamaProvider } from './llm/index.js';
+export { OpenAILLMProvider as OpenAIProvider } from './llm/index.js';
+export { AnthropicLLMProvider as AnthropicProvider } from './llm/index.js';
+export type { DefectPattern } from './patterns/index.js';
+export { DEFECT_PATTERNS, getPatternsByCategory, getPatternsForLanguage, getPatternText, } from './patterns/index.js';
+export { AIScanPipeline } from './pipeline.js';
+export { SLA_DESCRIPTIONS, DEFAULT_SLA_CONFIGS, createPipelineForSLA, getRecommendedSLA, validateSLAConfig, } from './sla.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/v4/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/v4/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAIH,YAAY,EACV,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,WAAW,EACX,QAAQ,EACR,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAIpB,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,QAAQ,EACR,gBAAgB,EAChB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAG5F,OAAO,EAAE,iBAAiB,IAAI,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,iBAAiB,IAAI,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,oBAAoB,IAAI,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAI3E,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAI/C,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,UAAU,CAAC"}

package/dist/ai/v4/index.js

@@ -0,0 +1,54 @@
+/**
+ * Open Code Review V4 — AI Pipeline Module
+ *
+ * Two-stage AI scan pipeline for detecting AI-generated code defects:
+ * - Stage 1 (Embedding): Fast similarity-based defect detection
+ * - Stage 2 (LLM): Deep analysis of suspicious code blocks
+ *
+ * SLA levels control which stages run:
+ * - L1 Fast: Structural detectors only (no AI)
+ * - L2 Standard: + Embedding recall + Local LLM (Ollama)
+ * - L3 Deep: + Remote LLM (OpenAI/Claude)
+ *
+ * @since 0.4.0
+ *
+ * @example
+ * ```ts
+ * import {
+ *   AIScanPipeline,
+ *   createPipelineForSLA,
+ *   LocalEmbeddingProvider,
+ *   OllamaLLMProvider,
+ *   DEFECT_PATTERNS,
+ * } from 'open-code-review-core';
+ *
+ * // Create pipeline for L2 (standard) with local LLM
+ * const pipeline = createPipelineForSLA('L2', {
+ *   local: { provider: 'ollama', model: 'codellama:13b' },
+ * });
+ *
+ * // Run the scan
+ * const result = await pipeline.scan(codeUnits, structuralResults);
+ *
+ * console.log(`Found ${result.totalIssues} issues in ${result.totalDurationMs}ms`);
+ * console.log(`SLA level: ${result.slaLevel}`);
+ *
+ * for (const stage of result.stages) {
+ *   console.log(`Stage ${stage.stage}: ${stage.issues.length} issues`);
+ * }
+ * ```
+ */
+// ─── Embedding Providers ───
+export { LocalEmbeddingProvider, OpenAIEmbeddingProvider, OllamaEmbeddingProvider, tokenize, cosineSimilarity, findTopMatches, } from './embedding/index.js';
+// ─── LLM Providers ───
+export { OllamaLLMProvider, OpenAILLMProvider, AnthropicLLMProvider } from './llm/index.js';
+// Backward compatibility aliases
+export { OllamaLLMProvider as OllamaProvider } from './llm/index.js';
+export { OpenAILLMProvider as OpenAIProvider } from './llm/index.js';
+export { AnthropicLLMProvider as AnthropicProvider } from './llm/index.js';
+export { DEFECT_PATTERNS, getPatternsByCategory, getPatternsForLanguage, getPatternText, } from './patterns/index.js';
+// ─── Pipeline ───
+export { AIScanPipeline } from './pipeline.js';
+// ─── SLA Router ───
+export { SLA_DESCRIPTIONS, DEFAULT_SLA_CONFIGS, createPipelineForSLA, getRecommendedSLA, validateSLAConfig, } from './sla.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/v4/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/v4/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAeH,8BAA8B;AAE9B,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,QAAQ,EACR,gBAAgB,EAChB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B,wBAAwB;AAExB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE5F,iCAAiC;AACjC,OAAO,EAAE,iBAAiB,IAAI,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,iBAAiB,IAAI,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,oBAAoB,IAAI,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAK3E,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,mBAAmB;AAEnB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,qBAAqB;AAErB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,UAAU,CAAC"}

package/dist/ai/v4/llm/anthropic.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Anthropic LLM Provider
+ *
+ * Provides LLM inference via Anthropic Messages API.
+ * Used for L3 SLA level as an alternative to OpenAI.
+ *
+ * @since 0.4.0
+ */
+import type { LLMProvider, LLMOptions, LLMResponse } from '../types.js';
+/**
+ * Anthropic provider for remote LLM inference using Claude models.
+ *
+ * Requires an API key. Supports Claude 3.5 and newer models.
+ *
+ * @example
+ * ```ts
+ * const provider = new AnthropicProvider(process.env.ANTHROPIC_API_KEY, 'claude-3-5-haiku-20241022');
+ * if (await provider.isAvailable()) {
+ *   const response = await provider.complete('Review this code:', { maxTokens: 1000 });
+ * }
+ * ```
+ */
+export declare class AnthropicLLMProvider implements LLMProvider {
+    private apiKey;
+    private model;
+    private baseUrl;
+    readonly name = "anthropic";
+    constructor(apiKey: string, model?: string, baseUrl?: string);
+    /**
+     * Send a completion request to Anthropic Messages API.
+     */
+    complete(prompt: string, options?: LLMOptions): Promise<LLMResponse>;
+    /**
+     * Check if the provider is available (has API key configured).
+     */
+    isAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/ai/v4/llm/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../../src/ai/v4/llm/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,qBAAa,oBAAqB,YAAW,WAAW;IAIpD,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,OAAO;IALjB,QAAQ,CAAC,IAAI,eAAe;gBAGlB,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAoC,EAC3C,OAAO,GAAE,MAAuC;IAG1D;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IA2D1E;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC"}

package/dist/ai/v4/llm/anthropic.js

@@ -0,0 +1,86 @@
+/**
+ * Anthropic LLM Provider
+ *
+ * Provides LLM inference via Anthropic Messages API.
+ * Used for L3 SLA level as an alternative to OpenAI.
+ *
+ * @since 0.4.0
+ */
+/**
+ * Anthropic provider for remote LLM inference using Claude models.
+ *
+ * Requires an API key. Supports Claude 3.5 and newer models.
+ *
+ * @example
+ * ```ts
+ * const provider = new AnthropicProvider(process.env.ANTHROPIC_API_KEY, 'claude-3-5-haiku-20241022');
+ * if (await provider.isAvailable()) {
+ *   const response = await provider.complete('Review this code:', { maxTokens: 1000 });
+ * }
+ * ```
+ */
+export class AnthropicLLMProvider {
+    apiKey;
+    model;
+    baseUrl;
+    name = 'anthropic';
+    constructor(apiKey, model = 'claude-3-5-haiku-20241022', baseUrl = 'https://api.anthropic.com/v1') {
+        this.apiKey = apiKey;
+        this.model = model;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Send a completion request to Anthropic Messages API.
+     */
+    async complete(prompt, options) {
+        const url = `${this.baseUrl}/messages`;
+        const startTime = Date.now();
+        const body = {
+            model: this.model,
+            max_tokens: options?.maxTokens ?? 4096,
+            messages: [{ role: 'user', content: prompt }],
+        };
+        if (options?.system) {
+            body.system = options.system;
+        }
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': this.apiKey,
+                'anthropic-version': '2023-06-01',
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(60_000),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text().catch(() => 'unknown error');
+            throw new Error(`Anthropic API error (${response.status}): ${errorBody}`);
+        }
+        const data = (await response.json());
+        const latencyMs = Date.now() - startTime;
+        // Extract text from content blocks
+        const content = data.content
+            .filter(block => block.type === 'text')
+            .map(block => block.text ?? '')
+            .join('');
+        return {
+            content,
+            usage: data.usage
+                ? {
+                    prompt: data.usage.input_tokens,
+                    completion: data.usage.output_tokens,
+                    total: data.usage.input_tokens + data.usage.output_tokens,
+                }
+                : undefined,
+            latencyMs,
+        };
+    }
+    /**
+     * Check if the provider is available (has API key configured).
+     */
+    async isAvailable() {
+        return !!this.apiKey && this.apiKey.length > 0;
+    }
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/ai/v4/llm/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../../../src/ai/v4/llm/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,oBAAoB;IAIrB;IACA;IACA;IALD,IAAI,GAAG,WAAW,CAAC;IAE5B,YACU,MAAc,EACd,QAAgB,2BAA2B,EAC3C,UAAkB,8BAA8B;QAFhD,WAAM,GAAN,MAAM,CAAQ;QACd,UAAK,GAAL,KAAK,CAAsC;QAC3C,YAAO,GAAP,OAAO,CAAyC;IACvD,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,OAAoB;QACjD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,WAAW,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,IAAI,GAA4B;YACpC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI;YACtC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;SAC9C,CAAC;QAEF,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/B,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,WAAW,EAAE,IAAI,CAAC,MAAM;gBACxB,mBAAmB,EAAE,YAAY;aAClC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAMlC,CAAC;QAEF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAEzC,mCAAmC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO;aACzB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;aACtC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;aAC9B,IAAI,CAAC,EAAE,CAAC,CAAC;QAEZ,OAAO;YACL,OAAO;YACP,KAAK,EAAE,IAAI,CAAC,KAAK;gBACf,CAAC,CAAC;oBACE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY;oBAC/B,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa;oBACpC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa;iBAC1D;gBACH,CAAC,CAAC,SAAS;YACb,SAAS;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/ai/v4/llm/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * LLM Providers for V4 AI Pipeline Stage 2.
+ *
+ * @since 0.4.0
+ */
+export { OllamaLLMProvider } from './ollama.js';
+export { OpenAILLMProvider } from './openai.js';
+export { AnthropicLLMProvider } from './anthropic.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/v4/llm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai/v4/llm/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/ai/v4/llm/index.js

@@ -0,0 +1,9 @@
+/**
+ * LLM Providers for V4 AI Pipeline Stage 2.
+ *
+ * @since 0.4.0
+ */
+export { OllamaLLMProvider } from './ollama.js';
+export { OpenAILLMProvider } from './openai.js';
+export { AnthropicLLMProvider } from './anthropic.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/v4/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ai/v4/llm/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/ai/v4/llm/ollama.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Ollama LLM Provider
+ *
+ * Provides local LLM inference via Ollama API.
+ * Used for L2 SLA level where local models are preferred.
+ *
+ * @since 0.4.0
+ */
+import type { LLMProvider, LLMOptions, LLMResponse } from '../types.js';
+/**
+ * Ollama provider for local LLM inference.
+ *
+ * Requires Ollama to be running locally with the specified model pulled.
+ *
+ * @example
+ * ```ts
+ * const provider = new OllamaProvider('codellama:13b');
+ * if (await provider.isAvailable()) {
+ *   const response = await provider.complete('Explain this code:', { maxTokens: 500 });
+ * }
+ * ```
+ */
+export declare class OllamaLLMProvider implements LLMProvider {
+    private model;
+    private baseUrl;
+    readonly name = "ollama";
+    constructor(model?: string, baseUrl?: string);
+    /**
+     * Send a completion request to Ollama.
+     *
+     * Uses the /api/generate endpoint with streaming disabled.
+     */
+    complete(prompt: string, options?: LLMOptions): Promise<LLMResponse>;
+    /**
+     * Check if Ollama is running and the model is available.
+     */
+    isAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=ollama.d.ts.map

package/dist/ai/v4/llm/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../../../src/ai/v4/llm/ollama.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IAIjD,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,OAAO;IAJjB,QAAQ,CAAC,IAAI,YAAY;gBAGf,KAAK,GAAE,MAAwB,EAC/B,OAAO,GAAE,MAAiC;IAGpD;;;;OAIG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAqD1E;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAsBtC"}

package/dist/ai/v4/llm/ollama.js

@@ -0,0 +1,95 @@
+/**
+ * Ollama LLM Provider
+ *
+ * Provides local LLM inference via Ollama API.
+ * Used for L2 SLA level where local models are preferred.
+ *
+ * @since 0.4.0
+ */
+/**
+ * Ollama provider for local LLM inference.
+ *
+ * Requires Ollama to be running locally with the specified model pulled.
+ *
+ * @example
+ * ```ts
+ * const provider = new OllamaProvider('codellama:13b');
+ * if (await provider.isAvailable()) {
+ *   const response = await provider.complete('Explain this code:', { maxTokens: 500 });
+ * }
+ * ```
+ */
+export class OllamaLLMProvider {
+    model;
+    baseUrl;
+    name = 'ollama';
+    constructor(model = 'codellama:13b', baseUrl = 'http://localhost:11434') {
+        this.model = model;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Send a completion request to Ollama.
+     *
+     * Uses the /api/generate endpoint with streaming disabled.
+     */
+    async complete(prompt, options) {
+        const url = `${this.baseUrl}/api/generate`;
+        const startTime = Date.now();
+        const body = {
+            model: this.model,
+            prompt,
+            stream: false,
+        };
+        if (options?.system) {
+            body.system = options.system;
+        }
+        if (options?.maxTokens) {
+            body.options = { ...body.options, num_predict: options.maxTokens };
+        }
+        if (options?.temperature !== undefined) {
+            body.options = { ...body.options, temperature: options.temperature };
+        }
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(120_000), // 2 minute timeout for local LLM
+        });
+        if (!response.ok) {
+            const errorBody = await response.text().catch(() => 'unknown error');
+            throw new Error(`Ollama API error (${response.status}): ${errorBody}`);
+        }
+        const data = (await response.json());
+        const latencyMs = Date.now() - startTime;
+        return {
+            content: data.response,
+            usage: {
+                prompt: data.prompt_eval_count ?? 0,
+                completion: data.eval_count ?? 0,
+                total: (data.prompt_eval_count ?? 0) + (data.eval_count ?? 0),
+            },
+            latencyMs,
+        };
+    }
+    /**
+     * Check if Ollama is running and the model is available.
+     */
+    async isAvailable() {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/tags`, {
+                method: 'GET',
+                signal: AbortSignal.timeout(5_000),
+            });
+            if (!response.ok)
+                return false;
+            const data = (await response.json());
+            // Check if our model exists (exact match or without tag)
+            const modelName = this.model.split(':')[0];
+            return (data.models ?? []).some(m => m.name === this.model || m.name.startsWith(`${modelName}:`));
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=ollama.js.map

package/dist/ai/v4/llm/ollama.js.map

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

package/dist/ai/v4/llm/openai.d.ts

@@ -0,0 +1,38 @@
+/**
+ * OpenAI LLM Provider
+ *
+ * Provides LLM inference via OpenAI Chat Completions API.
+ * Used for L3 SLA level where remote high-quality models are needed.
+ *
+ * @since 0.4.0
+ */
+import type { LLMProvider, LLMOptions, LLMResponse } from '../types.js';
+/**
+ * OpenAI provider for remote LLM inference.
+ *
+ * Requires an API key. Supports all OpenAI chat models.
+ *
+ * @example
+ * ```ts
+ * const provider = new OpenAIProvider(process.env.OPENAI_API_KEY, 'gpt-4o-mini');
+ * if (await provider.isAvailable()) {
+ *   const response = await provider.complete('Review this code:', { maxTokens: 1000 });
+ * }
+ * ```
+ */
+export declare class OpenAILLMProvider implements LLMProvider {
+    private apiKey;
+    private model;
+    private baseUrl;
+    readonly name = "openai";
+    constructor(apiKey: string, model?: string, baseUrl?: string);
+    /**
+     * Send a completion request to OpenAI Chat Completions API.
+     */
+    complete(prompt: string, options?: LLMOptions): Promise<LLMResponse>;
+    /**
+     * Check if the provider is available (has API key configured).
+     */
+    isAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/ai/v4/llm/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../../src/ai/v4/llm/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IAIjD,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,OAAO;IALjB,QAAQ,CAAC,IAAI,YAAY;gBAGf,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAsB,EAC7B,OAAO,GAAE,MAAoC;IAGvD;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAiE1E;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC"}

package/dist/ai/v4/llm/openai.js

@@ -0,0 +1,88 @@
+/**
+ * OpenAI LLM Provider
+ *
+ * Provides LLM inference via OpenAI Chat Completions API.
+ * Used for L3 SLA level where remote high-quality models are needed.
+ *
+ * @since 0.4.0
+ */
+/**
+ * OpenAI provider for remote LLM inference.
+ *
+ * Requires an API key. Supports all OpenAI chat models.
+ *
+ * @example
+ * ```ts
+ * const provider = new OpenAIProvider(process.env.OPENAI_API_KEY, 'gpt-4o-mini');
+ * if (await provider.isAvailable()) {
+ *   const response = await provider.complete('Review this code:', { maxTokens: 1000 });
+ * }
+ * ```
+ */
+export class OpenAILLMProvider {
+    apiKey;
+    model;
+    baseUrl;
+    name = 'openai';
+    constructor(apiKey, model = 'gpt-4o-mini', baseUrl = 'https://api.openai.com/v1') {
+        this.apiKey = apiKey;
+        this.model = model;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Send a completion request to OpenAI Chat Completions API.
+     */
+    async complete(prompt, options) {
+        const url = `${this.baseUrl}/chat/completions`;
+        const startTime = Date.now();
+        const messages = [];
+        if (options?.system) {
+            messages.push({ role: 'system', content: options.system });
+        }
+        messages.push({ role: 'user', content: prompt });
+        const body = {
+            model: this.model,
+            messages,
+        };
+        if (options?.maxTokens) {
+            body.max_tokens = options.maxTokens;
+        }
+        if (options?.temperature !== undefined) {
+            body.temperature = options.temperature;
+        }
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(60_000),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text().catch(() => 'unknown error');
+            throw new Error(`OpenAI API error (${response.status}): ${errorBody}`);
+        }
+        const data = (await response.json());
+        const latencyMs = Date.now() - startTime;
+        const content = data.choices[0]?.message?.content ?? '';
+        return {
+            content,
+            usage: data.usage
+                ? {
+                    prompt: data.usage.prompt_tokens,
+                    completion: data.usage.completion_tokens,
+                    total: data.usage.total_tokens,
+                }
+                : undefined,
+            latencyMs,
+        };
+    }
+    /**
+     * Check if the provider is available (has API key configured).
+     */
+    async isAvailable() {
+        return !!this.apiKey && this.apiKey.length > 0;
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/ai/v4/llm/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../../src/ai/v4/llm/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,iBAAiB;IAIlB;IACA;IACA;IALD,IAAI,GAAG,QAAQ,CAAC;IAEzB,YACU,MAAc,EACd,QAAgB,aAAa,EAC7B,UAAkB,2BAA2B;QAF7C,WAAM,GAAN,MAAM,CAAQ;QACd,UAAK,GAAL,KAAK,CAAwB;QAC7B,YAAO,GAAP,OAAO,CAAsC;IACpD,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,OAAoB;QACjD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,mBAAmB,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,QAAQ,GAA6C,EAAE,CAAC;QAE9D,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAEjD,MAAM,IAAI,GAA4B;YACpC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ;SACT,CAAC;QAEF,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QACtC,CAAC;QAED,IAAI,OAAO,EAAE,WAAW,KAAK,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACzC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACvC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAOlC,CAAC;QAEF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;QAExD,OAAO;YACL,OAAO;YACP,KAAK,EAAE,IAAI,CAAC,KAAK;gBACf,CAAC,CAAC;oBACE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa;oBAChC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB;oBACxC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY;iBAC/B;gBACH,CAAC,CAAC,SAAS;YACb,SAAS;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/ai/v4/patterns/defect-patterns.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Defect Pattern Database
+ *
+ * Curated set of AI-generated code defect patterns.
+ * These are used as embedding comparison targets in Stage 1 (Embedding Recall).
+ *
+ * Each pattern includes:
+ * - Unique ID for tracking
+ * - Category aligned with V4 scoring dimensions
+ * - Description used for embedding generation
+ * - Example code snippets matching the pattern
+ * - Severity and applicable languages
+ *
+ * @since 0.4.0
+ */
+import type { DetectorCategory } from '../../../detectors/v4/types.js';
+import type { SupportedLanguage } from '../../../ir/types.js';
+export interface DefectPattern {
+    /** Unique pattern identifier */
+    id: string;
+    /** Scoring category */
+    category: DetectorCategory;
+    /** Human-readable description (also used for embedding) */
+    description: string;
+    /** Code examples that match this pattern */
+    examples: string[];
+    /** Issue severity */
+    severity: 'error' | 'warning' | 'info';
+    /** Languages this pattern applies to (empty = all languages) */
+    languages: SupportedLanguage[];
+}
+/**
+ * Curated defect patterns that AI commonly generates.
+ * These are used as embedding comparison targets in Stage 1.
+ *
+ * Organized by category:
+ * - ai-faithfulness: Hallucinated imports, phantom APIs, fabricated types
+ * - code-freshness: Deprecated APIs, outdated patterns, stale knowledge
+ * - context-coherence: Inconsistencies, contradictions, style shifts
+ * - implementation: Over-engineering, security, incomplete implementations
+ */
+export declare const DEFECT_PATTERNS: DefectPattern[];
+/**
+ * Get all defect patterns for a specific category.
+ */
+export declare function getPatternsByCategory(category: DetectorCategory): DefectPattern[];
+/**
+ * Get all defect patterns applicable to a specific language.
+ * Patterns with empty languages array apply to all languages.
+ */
+export declare function getPatternsForLanguage(language: SupportedLanguage): DefectPattern[];
+/**
+ * Get the combined text representation of a pattern for embedding.
+ * Concatenates description and examples for richer embedding.
+ */
+export declare function getPatternText(pattern: DefectPattern): string;
+//# sourceMappingURL=defect-patterns.d.ts.map

package/dist/ai/v4/patterns/defect-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defect-patterns.d.ts","sourceRoot":"","sources":["../../../../src/ai/v4/patterns/defect-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAI9D,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,uBAAuB;IACvB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,qBAAqB;IACrB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,gEAAgE;IAChE,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAID;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,EAkS1C,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,gBAAgB,GACzB,aAAa,EAAE,CAEjB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,iBAAiB,GAC1B,aAAa,EAAE,CAIjB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE7D"}