codereview-aia 0.1.0 → 0.1.2

package/dist/utils/estimationUtils.js

@@ -0,0 +1,329 @@
+"use strict";
+/**
+ * @fileoverview Utilities for estimating token usage and costs for code reviews.
+ *
+ * This module provides functions for estimating token usage and costs for code reviews
+ * based on file content and model selection. It uses the tokenCounter utilities for
+ * basic token counting and cost calculation, and adds specialized functions for
+ * estimating review-specific token usage patterns.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.estimateOutputTokens = estimateOutputTokens;
+exports.estimateReviewCost = estimateReviewCost;
+exports.formatEstimation = formatEstimation;
+exports.estimateFromFilePaths = estimateFromFilePaths;
+exports.estimateMultiPassReviewCost = estimateMultiPassReviewCost;
+exports.formatMultiPassEstimation = formatMultiPassEstimation;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const tokenCounter_1 = require("../clients/utils/tokenCounter");
+const logger_1 = __importDefault(require("./logger"));
+/**
+ * Ratio of output tokens to input tokens based on empirical observations
+ * This is an approximation and may vary based on the specific review type and content
+ */
+const OUTPUT_TO_INPUT_RATIO = {
+    architectural: 0.6, // Architectural reviews tend to be more concise
+    'quick-fixes': 0.8, // Quick fixes often include code snippets
+    security: 0.7, // Security reviews are moderately detailed
+    performance: 0.7, // Performance reviews are similar to security
+    default: 0.75, // Default ratio if review type is not specified
+};
+/**
+ * Overhead tokens for review context, instructions, and formatting
+ * This is added to the total token count to account for the review framework
+ */
+const REVIEW_OVERHEAD_TOKENS = 1500;
+/**
+ * Context maintenance overhead factor for multi-pass reviews
+ * This factor is applied to estimate additional tokens needed for maintaining context
+ */
+const MULTI_PASS_CONTEXT_MAINTENANCE_FACTOR = 0.15;
+/**
+ * Additional overhead tokens per pass in multi-pass reviews
+ * This accounts for pass management, coordination, and state tracking
+ */
+const MULTI_PASS_OVERHEAD_PER_PASS = 800;
+/**
+ * Estimate the number of output tokens based on input tokens and review type
+ * @param inputTokens Number of input tokens
+ * @param reviewType Type of review
+ * @returns Estimated number of output tokens
+ */
+function estimateOutputTokens(inputTokens, reviewType) {
+    const ratio = OUTPUT_TO_INPUT_RATIO[reviewType] ||
+        OUTPUT_TO_INPUT_RATIO.default;
+    return Math.ceil(inputTokens * ratio);
+}
+/**
+ * Estimate token usage and cost for a set of files
+ *
+ * This function calculates the estimated token usage and cost for reviewing a set of files
+ * using a specified AI model. It considers:
+ * - The content of each file (code, comments, etc.)
+ * - The type of review being performed (quick, security, architectural, etc.)
+ * - The specific AI model being used and its pricing structure
+ *
+ * The estimation includes overhead tokens for system prompts and instructions that are
+ * included in every review, in addition to the tokens from the file content itself.
+ *
+ * @param files Array of file information objects containing file content and metadata
+ * @param reviewType Type of review (quick, security, architectural, performance)
+ * @param modelName Name of the model to use (e.g., 'openrouter:anthropic/claude-3-opus-20240229')
+ * @returns Estimated token usage and cost information including:
+ *   - inputTokens: Number of tokens in the input (files + prompts)
+ *   - outputTokens: Estimated number of tokens in the AI response
+ *   - totalTokens: Total token usage (input + output)
+ *   - estimatedCost: Estimated cost in USD
+ *   - formattedCost: Cost formatted as a string (e.g., '$0.12 USD')
+ *   - fileCount: Number of files being reviewed
+ *   - totalFileSize: Total size of all files in bytes
+ */
+async function estimateReviewCost(files, reviewType, modelName = process.env.AI_CODE_REVIEW_MODEL || 'openrouter:anthropic/claude-3-opus-20240229') {
+    // Calculate total input tokens from all files
+    let totalInputTokens = REVIEW_OVERHEAD_TOKENS; // Start with overhead tokens
+    let totalFileSize = 0;
+    for (const file of files) {
+        const fileTokens = (0, tokenCounter_1.estimateTokenCount)(file.content);
+        totalInputTokens += fileTokens;
+        totalFileSize += file.content.length;
+    }
+    // Estimate output tokens based on input tokens and review type
+    const estimatedOutputTokens = estimateOutputTokens(totalInputTokens, reviewType);
+    // Calculate cost information
+    const costInfo = (0, tokenCounter_1.getCostInfo)(totalInputTokens, estimatedOutputTokens, modelName);
+    return {
+        ...costInfo,
+        fileCount: files.length,
+        totalFileSize,
+    };
+}
+/**
+ * Format estimation results as a human-readable string
+ *
+ * This function takes the estimation results from estimateReviewCost or estimateFromFilePaths
+ * and formats them into a user-friendly string that can be displayed to the user.
+ *
+ * The formatted string includes:
+ * - Number of files being reviewed
+ * - Total file size
+ * - Input token count
+ * - Estimated output token count
+ * - Total token usage
+ * - Estimated cost in USD
+ *
+ * @param estimation Estimation results from estimateReviewCost or estimateFromFilePaths
+ * @param reviewType Type of review (quick, security, architectural, performance)
+ * @param modelName Name of the model being used
+ * @returns Formatted estimation string ready for display
+ * @example
+ * // Example output:
+ * // Estimation for 5 files (25.5 KB) using openrouter:anthropic/claude-3-opus-20240229:
+ * // - Review type: quick
+ * // - Input tokens: 5,000
+ * // - Output tokens: 2,500 (estimated)
+ * // - Total tokens: 7,500
+ * // - Estimated Cost: $0.015 USD
+ */
+function formatEstimation(estimation, reviewType, modelName) {
+    // Extract provider and model if available
+    const [provider, model] = modelName.includes(':') ? modelName.split(':') : [undefined, modelName];
+    const displayModel = model || modelName;
+    const displayProvider = provider
+        ? `${provider.charAt(0).toUpperCase() + provider.slice(1)}`
+        : 'Unknown';
+    const fileSizeInKB = (estimation.totalFileSize / 1024).toFixed(2);
+    const averageFileSize = estimation.fileCount > 0
+        ? (estimation.totalFileSize / estimation.fileCount / 1024).toFixed(2)
+        : '0.00';
+    return `
+=== Token Usage and Cost Estimation ===
+
+Review Type: ${reviewType}
+Provider: ${displayProvider}
+Model: ${displayModel}
+Files: ${estimation.fileCount} (${fileSizeInKB} KB total, ${averageFileSize} KB average)
+
+Token Usage:
+  Input Tokens: ${estimation.inputTokens.toLocaleString()} (includes ${REVIEW_OVERHEAD_TOKENS.toLocaleString()} overhead tokens)
+  Estimated Output Tokens: ${estimation.outputTokens.toLocaleString()}
+  Total Tokens: ${estimation.totalTokens.toLocaleString()}
+
+Estimated Cost: ${estimation.formattedCost}
+
+Note: This is an estimate based on approximate token counts and may vary
+      based on the actual content and model behavior.
+`;
+}
+/**
+ * Estimate token usage and cost for a set of file paths
+ *
+ * This function is a convenience wrapper around estimateReviewCost that takes file paths
+ * instead of FileInfo objects. It reads the content of each file and then calls
+ * estimateReviewCost to calculate the token usage and cost.
+ *
+ * This is particularly useful for the --estimate command line flag, which needs to
+ * estimate costs before actually performing a review.
+ *
+ * @param filePaths Array of file paths to estimate token usage for
+ * @param reviewType Type of review (quick, security, architectural, performance)
+ * @param modelName Name of the model to use (e.g., 'openrouter:anthropic/claude-3-opus-20240229')
+ * @returns Estimated token usage and cost information (same as estimateReviewCost)
+ * @throws Error if any file cannot be read
+ * @see estimateReviewCost for details on the return value
+ */
+async function estimateFromFilePaths(filePaths, reviewType, modelName = process.env.AI_CODE_REVIEW_MODEL || 'openrouter:anthropic/claude-3-opus-20240229') {
+    // Read file contents
+    const files = [];
+    for (const filePath of filePaths) {
+        try {
+            const content = await promises_1.default.readFile(filePath, 'utf-8');
+            files.push({
+                path: filePath,
+                relativePath: node_path_1.default.basename(filePath),
+                content,
+            });
+        }
+        catch (error) {
+            logger_1.default.error(`Error reading file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // Estimate cost
+    return await estimateReviewCost(files, reviewType, modelName);
+}
+/**
+ * Estimate token usage and cost for a multi-pass review
+ *
+ * This function extends the standard token estimation by accounting for the overhead
+ * of multi-pass reviews, including context maintenance between passes and additional
+ * overhead for each pass.
+ *
+ * @param files Array of file information objects containing file content and metadata
+ * @param reviewType Type of review (quick, security, architectural, performance)
+ * @param modelName Name of the model to use (e.g., 'openrouter:anthropic/claude-3-opus-20240229')
+ * @param options Additional estimation options
+ * @param options.passCount Number of passes to estimate (if known)
+ * @param options.contextMaintenanceFactor Factor for context maintenance overhead (0-1)
+ * @returns Estimated token usage and cost information for multi-pass review
+ */
+async function estimateMultiPassReviewCost(files, reviewType, modelName = process.env.AI_CODE_REVIEW_MODEL || 'openrouter:anthropic/claude-3-opus-20240229', options = {}) {
+    // Calculate total input tokens from all files
+    let totalFileTokens = 0;
+    let totalFileSize = 0;
+    for (const file of files) {
+        const fileTokens = (0, tokenCounter_1.estimateTokenCount)(file.content);
+        totalFileTokens += fileTokens;
+        totalFileSize += file.content.length;
+    }
+    // Calculate or determine the number of passes
+    const contextMaintenanceFactor = options.contextMaintenanceFactor || MULTI_PASS_CONTEXT_MAINTENANCE_FACTOR;
+    // Get a rough estimate of context window size based on the model
+    // This is a simplified approach; in production we'd pull this from provider metadata.
+    const getContextWindow = (model) => {
+        if (model.includes('claude'))
+            return 200000;
+        if (model.includes('gpt-4o'))
+            return 128000;
+        if (model.includes('gpt-4'))
+            return 128000;
+        return 128000; // Default for OpenRouter models
+    };
+    const contextWindow = getContextWindow(modelName);
+    const effectiveContextSize = Math.floor(contextWindow * (1 - contextMaintenanceFactor));
+    // Determine number of passes if not provided
+    const passCount = options.passCount || Math.max(1, Math.ceil(totalFileTokens / effectiveContextSize));
+    // Calculate tokens per pass (roughly equal distribution for estimation)
+    const tokensPerPass = totalFileTokens / passCount;
+    // Calculate per-pass costs
+    const perPassCosts = [];
+    let totalInputTokens = 0;
+    let totalOutputTokens = 0;
+    let totalEstimatedCost = 0;
+    for (let i = 0; i < passCount; i++) {
+        // Each pass has standard overhead plus context maintenance overhead
+        const passInputTokens = Math.ceil(tokensPerPass + REVIEW_OVERHEAD_TOKENS + MULTI_PASS_OVERHEAD_PER_PASS);
+        // For passes after the first, add context from previous passes
+        const contextTokens = i > 0 ? Math.ceil(i * MULTI_PASS_OVERHEAD_PER_PASS * 1.5) : 0;
+        const totalPassInputTokens = passInputTokens + contextTokens;
+        // Estimate output tokens
+        const passOutputTokens = estimateOutputTokens(totalPassInputTokens, reviewType);
+        // Calculate cost for this pass
+        const passCostInfo = (0, tokenCounter_1.getCostInfo)(totalPassInputTokens, passOutputTokens, modelName);
+        perPassCosts.push({
+            passNumber: i + 1,
+            inputTokens: totalPassInputTokens,
+            outputTokens: passOutputTokens,
+            totalTokens: totalPassInputTokens + passOutputTokens,
+            estimatedCost: passCostInfo.estimatedCost,
+        });
+        // Accumulate totals
+        totalInputTokens += totalPassInputTokens;
+        totalOutputTokens += passOutputTokens;
+        totalEstimatedCost += passCostInfo.estimatedCost;
+    }
+    return {
+        inputTokens: totalInputTokens,
+        outputTokens: totalOutputTokens,
+        totalTokens: totalInputTokens + totalOutputTokens,
+        estimatedCost: totalEstimatedCost,
+        formattedCost: (0, tokenCounter_1.formatCost)(totalEstimatedCost),
+        fileCount: files.length,
+        totalFileSize,
+        passCount,
+        perPassCosts,
+    };
+}
+/**
+ * Format multi-pass estimation results as a human-readable string
+ *
+ * @param estimation Multi-pass estimation results
+ * @param reviewType Type of review
+ * @param modelName Name of the model being used
+ * @returns Formatted estimation string
+ */
+function formatMultiPassEstimation(estimation, reviewType, modelName) {
+    // Extract provider and model if available
+    const [provider, model] = modelName.includes(':') ? modelName.split(':') : [undefined, modelName];
+    const displayModel = model || modelName;
+    const displayProvider = provider
+        ? `${provider.charAt(0).toUpperCase() + provider.slice(1)}`
+        : 'Unknown';
+    const fileSizeInKB = (estimation.totalFileSize / 1024).toFixed(2);
+    const averageFileSize = estimation.fileCount > 0
+        ? (estimation.totalFileSize / estimation.fileCount / 1024).toFixed(2)
+        : '0.00';
+    let output = `
+=== Multi-Pass Token Usage and Cost Estimation ===
+
+Review Type: ${reviewType}
+Provider: ${displayProvider}
+Model: ${displayModel}
+Files: ${estimation.fileCount} (${fileSizeInKB} KB total, ${averageFileSize} KB average)
+Passes: ${estimation.passCount}
+
+Total Token Usage:
+  Input Tokens: ${estimation.inputTokens.toLocaleString()}
+  Estimated Output Tokens: ${estimation.outputTokens.toLocaleString()}
+  Total Tokens: ${estimation.totalTokens.toLocaleString()}
+
+Estimated Total Cost: ${estimation.formattedCost}
+
+Per-Pass Breakdown:
+`;
+    estimation.perPassCosts.forEach((passCost) => {
+        output += `  Pass ${passCost.passNumber}:
+    Input Tokens: ${passCost.inputTokens.toLocaleString()}
+    Output Tokens: ${passCost.outputTokens.toLocaleString()}
+    Cost: ${(0, tokenCounter_1.formatCost)(passCost.estimatedCost)}
+`;
+    });
+    output += `
+Note: This is an estimate based on approximate token counts and may vary
+      based on the actual content and model behavior.
+`;
+    return output;
+}
+//# sourceMappingURL=estimationUtils.js.map

package/dist/utils/estimationUtils.js.map

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

package/dist/utils/fileFilters.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @fileoverview Utilities for filtering and selecting files for code review.
+ *
+ * This module provides functions for identifying, filtering, and selecting files
+ * for code review based on various criteria. It handles file discovery, gitignore
+ * pattern matching, file extension filtering, and test file identification.
+ * Supported file types include TypeScript, JavaScript, JSON, and Markdown.
+ */
+import type { FileInfo } from '../types/review';
+/**
+ * Check if a file is a test file
+ * @param filePath File path
+ * @returns True if the file is a test file
+ */
+export declare function isTestFile(filePath: string): boolean;
+/**
+ * Load gitignore patterns from a project directory
+ * @param projectDir Project directory path
+ * @returns Array of gitignore patterns
+ */
+export declare function loadGitignorePatterns(projectDir: string): Promise<string[]>;
+/**
+ * Check if a file should be excluded based on gitignore patterns
+ * @param filePath File path
+ * @param gitignorePatterns Array of gitignore patterns
+ * @returns True if the file should be excluded
+ */
+export declare function shouldExcludeFile(filePath: string, gitignorePatterns: string[]): boolean;
+/**
+ * Get the language for a file based on its extension
+ * @param filePath File path
+ * @returns Language identifier
+ */
+export declare function getLanguageForFile(filePath: string): string;
+/**
+ * Check if a file is supported for code review
+ * @param filePath File path
+ * @returns True if the file is supported
+ */
+export declare function isSupportedFile(filePath: string): boolean;
+/**
+ * Discover files in a directory recursively
+ * @param dirPath Directory path
+ * @param options Options for file discovery
+ * @returns Array of file paths
+ */
+export declare function discoverFiles(dirPath: string, options?: {
+    excludePatterns?: string[];
+    includeTests?: boolean;
+    maxDepth?: number;
+    currentDepth?: number;
+}): Promise<string[]>;
+/**
+ * Read file content and create a FileInfo object
+ * @param filePath File path
+ * @returns FileInfo object
+ */
+export declare function readFileInfo(filePath: string): Promise<FileInfo>;
+/**
+ * Read multiple files and create FileInfo objects
+ * @param filePaths Array of file paths
+ * @returns Array of FileInfo objects
+ */
+export declare function readMultipleFiles(filePaths: string[]): Promise<FileInfo[]>;
+/**
+ * Get files to review based on the target path
+ * @param targetPath The target file or directory path
+ * @param isFile Whether the target is a file
+ * @param includeTests Whether to include test files
+ * @returns Array of file paths to review
+ */
+export declare function getFilesToReview(targetPath: string, isFile: boolean, includeTests?: boolean, excludePatterns?: string[]): Promise<string[]>;