lamps-code-review 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Lamps (AppleLamps)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,357 @@
+# LampsCodeReview
+
+> AI-powered code review SDK and CLI for modern web codebases
+
+[![GitHub](https://img.shields.io/badge/GitHub-AppleLamps-black?logo=github)](https://github.com/AppleLamps)
+[![X (Twitter)](https://img.shields.io/badge/X-@lamps__apple-black?logo=x)](https://x.com/lamps_apple)
+
+LampsCodeReview analyzes your codebase using AI to identify security vulnerabilities, performance issues, bugs, and code quality problems. It supports Next.js, React, TypeScript, JavaScript, and Python projects.
+
+## Features
+
+- **AI-Powered Analysis** - Uses OpenRouter to access Claude, GPT-4, Gemini, and other models
+- **Full Codebase Context** - Sends entire codebase to AI for holistic understanding of file interactions
+- **Framework Detection** - Automatically detects Next.js, React, Express, FastAPI, Django, and more
+- **Configurable Models** - Easily switch between AI models via config file or CLI flag
+- **Multiple Output Formats** - JSON, Markdown, and HTML reports
+- **Dual Interface** - Use as CLI tool or import as SDK
+- **Extensible** - Add custom analyzers for project-specific rules
+
+## Quick Start
+
+```bash
+# Install
+npm install lamps-code-review
+
+# Set API key
+export OPENROUTER_API_KEY=your-key-here
+
+# Run review
+lamps-review ./my-project
+```
+
+## Installation
+
+```bash
+npm install lamps-code-review
+```
+
+Or install globally:
+
+```bash
+npm install -g lamps-code-review
+```
+
+## Setup
+
+Get an API key from [OpenRouter](https://openrouter.ai/) and set it as an environment variable:
+
+```bash
+# Linux/macOS
+export OPENROUTER_API_KEY=your-api-key-here
+
+# Windows (PowerShell)
+$env:OPENROUTER_API_KEY="your-api-key-here"
+
+# Windows (CMD)
+set OPENROUTER_API_KEY=your-api-key-here
+```
+
+## CLI Usage
+
+```bash
+# Review current directory
+lamps-review
+
+# Review a specific path
+lamps-review ./my-project
+
+# Use a different AI model
+lamps-review ./my-project --model openai/gpt-4o
+
+# Save report to file
+lamps-review ./my-project --output report.json
+
+# Markdown report
+lamps-review ./my-project --format markdown --output report.md
+
+# Verbose mode (shows progress)
+lamps-review ./my-project --verbose
+```
+
+### CLI Options
+
+| Option | Description |
+|--------|-------------|
+| `-o, --output <file>` | Write report to file |
+| `-f, --format <format>` | Output format: `json`, `markdown`, `html` |
+| `-m, --model <model>` | Override AI model (e.g., `openai/gpt-4o`) |
+| `-v, --verbose` | Enable verbose output |
+| `-c, --config <file>` | Path to config file |
+
+### Example Output
+
+```
+🔍 LampsCodeReview - Analyzing: ./my-project
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📊 Review Summary
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🟢 Health Score: 85/100
+📁 Files Analyzed: 24
+
+🔧 Frameworks Detected:
+   • typescript (95%)
+   • react (90%)
+   • nextjs (85%)
+
+📋 Findings:
+   ⚠️  Warnings: 3
+   ℹ️  Info: 5
+
+⏱️  Completed in 18543ms
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Configuration
+
+Create a `lamps.config.json` in your project root:
+
+```json
+{
+  "ai": {
+    "model": "minimax/minimax-m2.1",
+    "customPrompt": "Focus on security and performance issues",
+    "maxTokens": 4096,
+    "temperature": 0.3
+  },
+  "scan": {
+    "ignorePatterns": ["*.test.ts", "*.spec.ts", "**/__mocks__/**"],
+    "maxFileSize": 102400,
+    "includeExtensions": [".ts", ".tsx", ".js", ".jsx", ".py"]
+  },
+  "format": "json"
+}
+```
+
+### Configuration Reference
+
+#### AI Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `model` | string | `minimax/minimax-m2.1` | OpenRouter model ID |
+| `customPrompt` | string | - | Additional instructions for the AI reviewer |
+| `maxTokens` | number | `150000` | Maximum tokens in AI response |
+| `temperature` | number | `0.3` | AI temperature (0-1, lower = more focused) |
+
+#### Scan Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `ignorePatterns` | string[] | `[]` | Glob patterns to ignore |
+| `maxFileSize` | number | `1048576` | Max file size in bytes (default 1MB) |
+| `includeExtensions` | string[] | - | Only include these extensions |
+| `useGitignore` | boolean | `true` | Respect .gitignore files |
+
+### Available Models
+
+Any model on [OpenRouter](https://openrouter.ai/models) works, including:
+
+| Model | ID | Best For |
+|-------|-----|----------|
+| MiniMax M2.1 | `minimax/minimax-m2.1` | Large context, fast (default) |
+| Claude Sonnet 4 | `anthropic/claude-sonnet-4` | Balanced quality/speed |
+| Claude Opus 4 | `anthropic/claude-opus-4` | Highest quality |
+| GPT-4o | `openai/gpt-4o` | Fast, good quality |
+| Gemini 2.0 Flash | `google/gemini-2.0-flash-thinking-exp-1219` | Very fast |
+| Llama 3.1 405B | `meta-llama/llama-3.1-405b-instruct` | Open source |
+
+## SDK Usage
+
+```typescript
+import { LampsCodeReview } from 'lamps-code-review';
+
+// Basic usage
+const reviewer = new LampsCodeReview();
+const report = await reviewer.review('./my-project');
+
+console.log(`Health Score: ${report.summary.healthScore}/100`);
+console.log(`Findings: ${report.summary.totalFindings}`);
+
+// With configuration
+const reviewer = new LampsCodeReview({
+  verbose: true,
+  ai: {
+    model: 'openai/gpt-4o',
+    customPrompt: 'Focus on security vulnerabilities',
+  },
+  scan: {
+    ignorePatterns: ['*.test.ts'],
+    maxFileSize: 500 * 1024,
+  },
+});
+
+const report = await reviewer.review('./my-project');
+
+// Format report
+const json = reviewer.formatReport(report, 'json');
+const markdown = reviewer.formatReport(report, 'markdown');
+```
+
+### Custom Analyzers
+
+Add your own analysis rules:
+
+```typescript
+import { LampsCodeReview, BaseAnalyzer } from 'lamps-code-review';
+import type { AnalysisContext, AnalysisResult } from 'lamps-code-review';
+
+class MyCustomAnalyzer extends BaseAnalyzer {
+  readonly name = 'my-analyzer';
+  readonly phase = 'static'; // 'static' | 'ai' | 'post'
+  readonly description = 'My custom analysis rules';
+
+  async analyze(context: AnalysisContext): Promise<AnalysisResult> {
+    const startTime = Date.now();
+    const findings = [];
+
+    // Your analysis logic here
+    for (const file of context.files) {
+      if (file.relativePath.includes('TODO')) {
+        findings.push({
+          ruleId: 'my-analyzer/todo-file',
+          severity: 'warning',
+          file: file.relativePath,
+          message: 'File contains TODO in name',
+        });
+      }
+    }
+
+    return this.createResult(findings, startTime);
+  }
+}
+
+const reviewer = new LampsCodeReview();
+reviewer.registerAnalyzer(new MyCustomAnalyzer());
+```
+
+## What Gets Analyzed
+
+The AI reviewer checks for:
+
+- **Security** - SQL injection, XSS, command injection, auth issues, secrets exposure
+- **Bugs** - Logic errors, null handling, race conditions, off-by-one errors
+- **Performance** - N+1 queries, memory leaks, unnecessary re-renders, inefficient algorithms
+- **Code Quality** - Complexity, readability, maintainability, code smells
+- **Best Practices** - Framework patterns, TypeScript/Python idioms, error handling
+- **Architecture** - Coupling, cohesion, separation of concerns
+
+## Report Structure
+
+```typescript
+interface ReviewReport {
+  version: string;
+  timestamp: string;
+  repository: {
+    path: string;
+    filesAnalyzed: number;
+  };
+  frameworks: {
+    frameworks: FrameworkDetection[];
+    primary: Framework | null;
+    languages: string[];
+  };
+  summary: {
+    totalFindings: number;
+    bySeverity: Record<Severity, number>;
+    byAnalyzer: Record<string, number>;
+    healthScore: number; // 0-100
+  };
+  findings: Finding[];
+  analyzerResults: AnalysisResult[];
+}
+
+interface Finding {
+  ruleId: string;      // e.g., 'ai/security-sql-injection'
+  severity: 'error' | 'warning' | 'info' | 'hint';
+  file: string;
+  line?: number;
+  message: string;
+  suggestion?: string;
+}
+```
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/AppleLamps/lamps-code-review.git
+cd lamps-code-review
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Type check
+npm run lint
+
+# Run locally
+node bin/lamps-review.js ./path/to/project
+```
+
+## Architecture
+
+```
+src/
+├── index.ts              # SDK entry point
+├── cli/                  # CLI implementation
+│   ├── index.ts          # Command parsing
+│   └── commands/
+│       └── review.ts     # Review command
+├── core/
+│   ├── config/           # Configuration loading
+│   ├── scanner/          # Repository scanning
+│   ├── detector/         # Framework detection
+│   ├── analyzer/
+│   │   ├── static/       # Static analysis rules
+│   │   └── ai/           # AI-powered analysis
+│   │       ├── openrouter.ts  # OpenRouter client
+│   │       └── prompts.ts     # Review prompts
+│   └── reporter/         # Report generation
+├── types/                # TypeScript types
+└── utils/                # Common utilities
+```
+
+## Troubleshooting
+
+### "OPENROUTER_API_KEY not set"
+
+Make sure you've exported the environment variable in your current shell session.
+
+### AI analysis is slow
+
+- Large codebases take longer (all files are sent for context)
+- Try a faster model: `--model google/gemini-2.0-flash-thinking-exp-1219`
+- Use `--verbose` to see progress
+
+### Files are being skipped
+
+Check your `.gitignore` and `lamps.config.json` ignore patterns. Use `--verbose` to see which files are scanned.
+
+## Author
+
+**Lamps** - [@lamps_apple](https://x.com/lamps_apple)
+
+- GitHub: [AppleLamps](https://github.com/AppleLamps)
+- X: [@lamps_apple](https://x.com/lamps_apple)
+
+## License
+
+MIT

package/bin/lamps-review.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * CLI executable shim
+ * This file is the entry point for the `lamps-review` command
+ */
+
+import('../dist/cli/index.js');

package/dist/cli/commands/review.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Review command implementation
+ */
+import type { CLIOptions } from '../../types/index.js';
+/**
+ * Execute the review command
+ */
+export declare function executeReview(targetPath: string, options: CLIOptions): Promise<void>;
+//# sourceMappingURL=review.d.ts.map

package/dist/cli/commands/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/review.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,sBAAsB,CAAC;AAErE;;GAEG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAoDf"}

package/dist/cli/commands/review.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * Review command implementation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeReview = executeReview;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const index_js_1 = require("../../index.js");
+/**
+ * Execute the review command
+ */
+async function executeReview(targetPath, options) {
+    const absolutePath = path.resolve(targetPath);
+    // Validate path exists
+    if (!fs.existsSync(absolutePath)) {
+        console.error(`Error: Path does not exist: ${absolutePath}`);
+        process.exit(1);
+    }
+    console.log(`\n🔍 LampsCodeReview - Analyzing: ${absolutePath}\n`);
+    // Show AI model info
+    if (options.model) {
+        console.log(`🤖 AI Model: ${options.model}\n`);
+    }
+    try {
+        // Create reviewer instance
+        const reviewer = new index_js_1.LampsCodeReview({
+            verbose: options.verbose,
+            format: options.format,
+            output: options.output,
+            ai: options.model ? { model: options.model } : undefined,
+        });
+        // Run the review
+        const startTime = Date.now();
+        const report = await reviewer.review(absolutePath);
+        const duration = Date.now() - startTime;
+        // Output results
+        if (options.output) {
+            // Write to file
+            const formatted = reviewer.formatReport(report, options.format || 'json');
+            fs.writeFileSync(options.output, formatted);
+            console.log(`📄 Report written to: ${options.output}`);
+        }
+        else {
+            // Print summary to console
+            printSummary(report, duration);
+        }
+        // Exit with error code if there are errors
+        if (report.summary.bySeverity.error > 0) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error('Error during review:', error);
+        process.exit(1);
+    }
+}
+/**
+ * Print a summary of the review to console
+ */
+function printSummary(report, duration) {
+    console.log('━'.repeat(50));
+    console.log('📊 Review Summary');
+    console.log('━'.repeat(50));
+    // Health score with color
+    const score = report.summary.healthScore;
+    const scoreColor = score >= 80 ? '🟢' : score >= 50 ? '🟡' : '🔴';
+    console.log(`\n${scoreColor} Health Score: ${score}/100`);
+    // Files analyzed
+    console.log(`📁 Files Analyzed: ${report.repository.filesAnalyzed}`);
+    // Frameworks detected
+    if (report.frameworks.frameworks.length > 0) {
+        console.log('\n🔧 Frameworks Detected:');
+        for (const fw of report.frameworks.frameworks) {
+            const confidence = Math.round(fw.confidence * 100);
+            console.log(`   • ${fw.framework} (${confidence}%)`);
+        }
+    }
+    // Findings summary
+    const { bySeverity } = report.summary;
+    console.log('\n📋 Findings:');
+    if (bySeverity.error > 0)
+        console.log(`   ❌ Errors: ${bySeverity.error}`);
+    if (bySeverity.warning > 0)
+        console.log(`   ⚠️  Warnings: ${bySeverity.warning}`);
+    if (bySeverity.info > 0)
+        console.log(`   ℹ️  Info: ${bySeverity.info}`);
+    if (bySeverity.hint > 0)
+        console.log(`   💡 Hints: ${bySeverity.hint}`);
+    if (report.summary.totalFindings === 0) {
+        console.log('   ✨ No issues found!');
+    }
+    // Print individual findings
+    if (report.findings.length > 0 && report.findings.length <= 10) {
+        console.log('\n📝 Details:');
+        for (const finding of report.findings) {
+            const icon = finding.severity === 'error'
+                ? '❌'
+                : finding.severity === 'warning'
+                    ? '⚠️'
+                    : finding.severity === 'info'
+                        ? 'ℹ️'
+                        : '💡';
+            console.log(`\n   ${icon} [${finding.ruleId}]`);
+            console.log(`      ${finding.file}${finding.line ? `:${finding.line}` : ''}`);
+            console.log(`      ${finding.message}`);
+        }
+    }
+    else if (report.findings.length > 10) {
+        console.log(`\n   (${report.findings.length} findings - use --output to see all)`);
+    }
+    // Duration
+    console.log(`\n⏱️  Completed in ${duration}ms`);
+    console.log('━'.repeat(50));
+}
+//# sourceMappingURL=review.js.map

package/dist/cli/commands/review.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * LampsCodeReview CLI
+ * Command-line interface for running code reviews
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/cli/index.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * LampsCodeReview CLI
+ * Command-line interface for running code reviews
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const review_js_1 = require("./commands/review.js");
+// Package version (will be replaced by actual version in production)
+const VERSION = '0.1.0';
+const program = new commander_1.Command();
+program
+    .name('lamps-review')
+    .description('AI-powered code review for modern web codebases')
+    .version(VERSION);
+program
+    .command('review')
+    .description('Run a code review on a repository or directory')
+    .argument('<path>', 'Path to the repository or directory to review')
+    .option('-o, --output <file>', 'Write report to file instead of stdout')
+    .option('-f, --format <format>', 'Output format: json, markdown, html', 'json')
+    .option('-m, --model <model>', 'Override AI model (e.g., openai/gpt-4o)')
+    .option('-v, --verbose', 'Enable verbose output', false)
+    .option('-c, --config <file>', 'Path to config file')
+    .action(async (targetPath, options) => {
+    await (0, review_js_1.executeReview)(targetPath, options);
+});
+// Default command: run review on current directory
+program
+    .argument('[path]', 'Path to review (defaults to current directory)', '.')
+    .option('-o, --output <file>', 'Write report to file instead of stdout')
+    .option('-f, --format <format>', 'Output format: json, markdown, html', 'json')
+    .option('-m, --model <model>', 'Override AI model (e.g., openai/gpt-4o)')
+    .option('-v, --verbose', 'Enable verbose output', false)
+    .action(async (targetPath, options) => {
+    await (0, review_js_1.executeReview)(targetPath, options);
+});
+// Parse and execute
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;AACA;;;GAGG;;AAEH,yCAAoC;AACpC,oDAAqD;AAErD,qEAAqE;AACrE,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,cAAc,CAAC;KACpB,WAAW,CAAC,iDAAiD,CAAC;KAC9D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,gDAAgD,CAAC;KAC7D,QAAQ,CAAC,QAAQ,EAAE,+CAA+C,CAAC;KACnE,MAAM,CAAC,qBAAqB,EAAE,wCAAwC,CAAC;KACvE,MAAM,CACL,uBAAuB,EACvB,qCAAqC,EACrC,MAAM,CACP;KACA,MAAM,CAAC,qBAAqB,EAAE,yCAAyC,CAAC;KACxE,MAAM,CAAC,eAAe,EAAE,uBAAuB,EAAE,KAAK,CAAC;KACvD,MAAM,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;KACpD,MAAM,CAAC,KAAK,EAAE,UAAkB,EAAE,OAAO,EAAE,EAAE;IAC5C,MAAM,IAAA,yBAAa,EAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC;AAEL,mDAAmD;AACnD,OAAO;KACJ,QAAQ,CAAC,QAAQ,EAAE,gDAAgD,EAAE,GAAG,CAAC;KACzE,MAAM,CAAC,qBAAqB,EAAE,wCAAwC,CAAC;KACvE,MAAM,CACL,uBAAuB,EACvB,qCAAqC,EACrC,MAAM,CACP;KACA,MAAM,CAAC,qBAAqB,EAAE,yCAAyC,CAAC;KACxE,MAAM,CAAC,eAAe,EAAE,uBAAuB,EAAE,KAAK,CAAC;KACvD,MAAM,CAAC,KAAK,EAAE,UAAkB,EAAE,OAAO,EAAE,EAAE;IAC5C,MAAM,IAAA,yBAAa,EAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC;AAEL,oBAAoB;AACpB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/core/analyzer/ai/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * AI Analyzer module
+ * Uses OpenRouter to perform AI-powered code review
+ */
+import type { AnalysisContext, AnalysisResult, AIConfig } from '../../../types/index.js';
+import { BaseAnalyzer } from '../types.js';
+/**
+ * AI-powered code analyzer using OpenRouter
+ */
+export declare class AIAnalyzer extends BaseAnalyzer {
+    private config;
+    readonly name = "ai";
+    readonly phase: "ai";
+    readonly description = "AI-powered code review using OpenRouter";
+    constructor(config: AIConfig);
+    analyze(context: AnalysisContext): Promise<AnalysisResult>;
+    /**
+     * Load file contents for AI analysis
+     * Respects size limits and filters appropriately
+     */
+    private loadFileContents;
+}
+/**
+ * Create an AI analyzer with the given configuration
+ */
+export declare function createAIAnalyzer(config: AIConfig): AIAnalyzer;
+export { OpenRouterError } from './openrouter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/analyzer/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/analyzer/ai/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAqB,MAAM,yBAAyB,CAAC;AAC5G,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAW3C;;GAEG;AACH,qBAAa,UAAW,SAAQ,YAAY;IAK9B,OAAO,CAAC,MAAM;IAJ1B,QAAQ,CAAC,IAAI,QAAQ;IACrB,QAAQ,CAAC,KAAK,EAAG,IAAI,CAAU;IAC/B,QAAQ,CAAC,WAAW,6CAA6C;gBAE7C,MAAM,EAAE,QAAQ;IAI9B,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAyFhE;;;OAGG;YACW,gBAAgB;CAyC/B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,CAE7D;AAGD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}