codereview-aia 0.1.3 → 0.1.4

package/dist/core/OutputManager.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * @fileoverview Output manager module.
+ *
+ * This module is responsible for formatting and saving review outputs to files.
+ * It centralizes the logic for generating output paths and writing review results.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addFileTreeToReview = addFileTreeToReview;
+exports.saveReviewOutput = saveReviewOutput;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const outputFormatter_1 = require("../formatters/outputFormatter");
+const aiDependencyAnalyzer_1 = require("../utils/dependencies/aiDependencyAnalyzer");
+const diagramGenerator_1 = require("../utils/diagramGenerator");
+const errorLogger_1 = require("../utils/errorLogger");
+const fileSystem_1 = require("../utils/fileSystem");
+const logger_1 = __importDefault(require("../utils/logger"));
+const treeGenerator_1 = require("../utils/treeGenerator");
+/**
+ * Add file tree visualization to a review
+ * @param formattedOutput Formatted review output (markdown or JSON)
+ * @param files Files included in the review
+ * @param outputFormat Output format (markdown or json)
+ * @returns Enhanced output with file tree
+ */
+function addFileTreeToReview(formattedOutput, files, outputFormat) {
+    if (!files || files.length === 0) {
+        logger_1.default.debug('No files provided for tree generation');
+        return formattedOutput;
+    }
+    logger_1.default.debug(`Adding file tree for ${files.length} files in ${outputFormat} format`);
+    // Extract relative paths from files
+    const relativePaths = files.map((file) => file.relativePath || file.path);
+    // Generate tree visualization
+    const fileTree = (0, treeGenerator_1.generateFileTree)(relativePaths);
+    if (outputFormat === 'json') {
+        // For JSON, parse and add tree visualization as property
+        try {
+            const reviewObj = JSON.parse(formattedOutput);
+            // Add both a flat list and a tree structure
+            reviewObj.analyzedFiles = relativePaths;
+            reviewObj.fileTree = fileTree.replace(/```/g, '').trim();
+            return JSON.stringify(reviewObj, null, 2);
+        }
+        catch (error) {
+            logger_1.default.warn(`Error enhancing JSON review with file tree: ${error}`);
+            return formattedOutput;
+        }
+    }
+    else {
+        // For markdown, find appropriate position to insert file tree section
+        const fileListSection = `\n## Files Analyzed\n\nThe following ${files.length} files were included in this review:\n\n${fileTree}\n\n`;
+        // Find the position to insert (before cost information section if it exists)
+        const costSectionMatch = formattedOutput.match(/^## Cost Information/m);
+        if (costSectionMatch?.index) {
+            // Insert before cost information
+            const position = costSectionMatch.index;
+            logger_1.default.debug('Inserting file list before Cost Information section');
+            return (formattedOutput.substring(0, position) +
+                fileListSection +
+                formattedOutput.substring(position));
+        }
+        // Find the position to insert before the closing markdown
+        const closingMatch = formattedOutput.match(/---\n\*Generated by Code Review Tool/);
+        if (closingMatch?.index) {
+            // Insert before the closing section
+            const position = closingMatch.index;
+            logger_1.default.debug('Inserting file list before closing section');
+            return (formattedOutput.substring(0, position) +
+                fileListSection +
+                formattedOutput.substring(position));
+        }
+        // If no suitable position found, append at the end
+        logger_1.default.debug('No insertion point found, appending file list to end');
+        return formattedOutput + fileListSection;
+    }
+}
+/**
+ * Format and save a review result to a file
+ * @param review Review result to save
+ * @param options Review options
+ * @param outputBaseDir Base directory for output
+ * @param modelName Name of the model used for the review
+ * @param targetName Name of the target file or directory
+ * @param files Optional array of file information to include in the review
+ * @returns Promise resolving to the path of the saved file
+ */
+async function saveReviewOutput(review, options, outputBaseDir, modelName, targetName, files) {
+    try {
+        // Generate a versioned output path
+        const extension = options.output === 'json' ? '.json' : '.md';
+        // Create unique filenames for different types of output
+        // For formatted review output
+        let outputPath = await (0, fileSystem_1.generateVersionedOutputPath)(outputBaseDir, `${options.type}-review`, extension, modelName, targetName);
+        // For raw review data (if needed for debugging)
+        const rawDataPath = await (0, fileSystem_1.generateUniqueOutputPath)(outputBaseDir, `${options.type}-review-raw-data-${node_path_1.default.basename(outputPath, extension)}.json`);
+        // Ensure costInfo is set if only cost is available
+        if (review.cost && !review.costInfo) {
+            review.costInfo = review.cost;
+        }
+        // Format the review output
+        logger_1.default.debug(`Formatting review output as ${options.output}`);
+        let formattedOutput = (0, outputFormatter_1.formatReviewOutput)(review, options.output || 'markdown');
+        // Add file tree to all review types if files are provided
+        if (files && files.length > 0) {
+            logger_1.default.info(`Adding file tree visualization for ${files.length} files`);
+            formattedOutput = addFileTreeToReview(formattedOutput, files, options.output || 'markdown');
+        }
+        // For architectural and security reviews, dependency analysis is ON by default unless explicitly disabled
+        const reviewTypeNeedsDependencyAnalysis = ['architectural', 'security'].includes(options.type);
+        if (reviewTypeNeedsDependencyAnalysis && options.includeDependencyAnalysis !== false) {
+            console.log(`=========== DEPENDENCY ANALYSIS FOR ${options.type.toUpperCase()} REVIEW ===========`);
+            logger_1.default.info(`=========== DEPENDENCY ANALYSIS FOR ${options.type.toUpperCase()} REVIEW ===========`);
+            try {
+                // Use the AI-powered dependency analyzer (no external dependencies required)
+                logger_1.default.info(`Performing AI-powered dependency analysis for ${options.type} review...`);
+                // Use project directory path instead of current working directory to ensure correct analysis
+                const projectPath = files && files.length > 0 ? node_path_1.default.dirname(files[0].path) : node_path_1.default.resolve(process.cwd());
+                console.log(`Project path for dependency analysis: ${projectPath}`);
+                logger_1.default.info(`Project path for dependency analysis: ${projectPath}`);
+                // Run the AI-powered dependency analysis
+                const dependencySection = await (0, aiDependencyAnalyzer_1.createAIDependencyAnalysis)(projectPath);
+                // Append dependency analysis section to the review
+                if (options.output === 'json') {
+                    try {
+                        // Parse JSON, add dependency analysis section, and stringify again
+                        const reviewObj = JSON.parse(formattedOutput);
+                        reviewObj.dependencyAnalysis = dependencySection;
+                        formattedOutput = JSON.stringify(reviewObj, null, 2);
+                        logger_1.default.info('AI-powered dependency analysis added to JSON review output');
+                    }
+                    catch (error) {
+                        logger_1.default.warn(`Error adding dependency analysis section to JSON review: ${error}`);
+                        // If JSON parsing fails, append as text
+                        formattedOutput += `\n\n${dependencySection}`;
+                        logger_1.default.info('AI-powered dependency analysis appended as text to JSON review (JSON parsing failed)');
+                    }
+                }
+                else {
+                    // For markdown, append at the end
+                    formattedOutput += `\n\n${dependencySection}`;
+                    logger_1.default.info('AI-powered dependency analysis added to markdown review output');
+                }
+            }
+            catch (error) {
+                logger_1.default.error(`Error performing AI-powered dependency analysis for ${options.type} review: ${error instanceof Error ? error.message : String(error)}`);
+                logger_1.default.error(error instanceof Error && error.stack ? error.stack : 'No stack trace available');
+            }
+        }
+        // Check if the output file already exists (to avoid overwriting)
+        try {
+            await promises_1.default.access(outputPath);
+            logger_1.default.warn(`Output file already exists: ${outputPath}`);
+            // Generate a new unique path to avoid overwriting
+            const uniqueOutputPath = await (0, fileSystem_1.generateUniqueOutputPath)(outputBaseDir, `${options.type}-review-${Date.now()}${extension}`);
+            logger_1.default.info(`Using alternative output path to avoid overwriting: ${uniqueOutputPath}`);
+            // Update the output path
+            const originalPath = outputPath;
+            outputPath = uniqueOutputPath;
+            // Log this change for debugging
+            logger_1.default.debug(`Changed output path from ${originalPath} to ${outputPath} to avoid collision`);
+        }
+        catch (_error) {
+            // File doesn't exist, which is good
+            logger_1.default.debug(`Output file doesn't exist yet, proceeding with: ${outputPath}`);
+        }
+        // Write the formatted output to the file
+        logger_1.default.debug(`Writing formatted review output to: ${outputPath}`);
+        await promises_1.default.writeFile(outputPath, formattedOutput);
+        logger_1.default.info(`Review output saved to: ${outputPath}`);
+        // Process and save any Mermaid diagrams if requested
+        if (options.diagram && options.type === 'architectural') {
+            const diagramPaths = await (0, diagramGenerator_1.processDiagrams)(formattedOutput, outputPath, options);
+            if (diagramPaths.length > 0) {
+                logger_1.default.info(`Generated ${diagramPaths.length} architecture diagram file(s)`);
+            }
+        }
+        // Optionally save raw review data for debugging (only if debug mode is enabled)
+        if (options.debug) {
+            logger_1.default.debug(`Saving raw review data for debugging to: ${rawDataPath}`);
+            await promises_1.default.writeFile(rawDataPath, JSON.stringify(review, null, 2));
+            logger_1.default.debug(`Raw review data saved to: ${rawDataPath}`);
+        }
+        return outputPath;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            const errorLogPath = await (0, errorLogger_1.logError)(error, {
+                operation: 'writeFile',
+                outputPath: 'unknown',
+                reviewType: options.type,
+            });
+            logger_1.default.error(`Error saving review output:`);
+            logger_1.default.error(`  Message: ${error.message}`);
+            logger_1.default.error(`  Error details logged to: ${errorLogPath}`);
+            // Add more detailed error information
+            if (error.stack) {
+                logger_1.default.debug(`Error stack trace: ${error.stack}`);
+            }
+            if (error.name === 'EACCES') {
+                logger_1.default.error(`  This appears to be a permission error. Please check that you have write access to the output directory.`);
+            }
+            else if (error.name === 'ENOSPC') {
+                logger_1.default.error(`  This appears to be a disk space error. Please free up some disk space and try again.`);
+            }
+        }
+        else {
+            logger_1.default.error(`Unknown error saving review output: ${String(error)}`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=OutputManager.js.map

package/dist/core/OutputManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutputManager.js","sourceRoot":"","sources":["../../src/core/OutputManager.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;AAoBH,kDAgEC;AAYD,4CA6KC;AA3QD,gEAAkC;AAClC,0DAA6B;AAC7B,mEAAmE;AAEnE,qFAAwF;AACxF,gEAA4D;AAC5D,sDAAgD;AAChD,oDAA4F;AAC5F,6DAAqC;AACrC,0DAA0D;AAE1D;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,eAAuB,EACvB,KAAiB,EACjB,YAAoB;IAEpB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,gBAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QACtD,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,gBAAM,CAAC,KAAK,CAAC,wBAAwB,KAAK,CAAC,MAAM,aAAa,YAAY,SAAS,CAAC,CAAC;IAErF,oCAAoC;IACpC,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1E,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,IAAA,gCAAgB,EAAC,aAAa,CAAC,CAAC;IAEjD,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;QAC5B,yDAAyD;QACzD,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YAC9C,4CAA4C;YAC5C,SAAS,CAAC,aAAa,GAAG,aAAa,CAAC;YACxC,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAEzD,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,gBAAM,CAAC,IAAI,CAAC,+CAA+C,KAAK,EAAE,CAAC,CAAC;YACpE,OAAO,eAAe,CAAC;QACzB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,sEAAsE;QACtE,MAAM,eAAe,GAAG,wCAAwC,KAAK,CAAC,MAAM,2CAA2C,QAAQ,MAAM,CAAC;QAEtI,6EAA6E;QAC7E,MAAM,gBAAgB,GAAG,eAAe,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAExE,IAAI,gBAAgB,EAAE,KAAK,EAAE,CAAC;YAC5B,iCAAiC;YACjC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC;YACxC,gBAAM,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;YACpE,OAAO,CACL,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC;gBACtC,eAAe;gBACf,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC,CACpC,CAAC;QACJ,CAAC;QACD,0DAA0D;QAC1D,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAEnF,IAAI,YAAY,EAAE,KAAK,EAAE,CAAC;YACxB,oCAAoC;YACpC,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC;YACpC,gBAAM,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAC3D,OAAO,CACL,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC;gBACtC,eAAe;gBACf,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC,CACpC,CAAC;QACJ,CAAC;QACD,mDAAmD;QACnD,gBAAM,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACrE,OAAO,eAAe,GAAG,eAAe,CAAC;IAC3C,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACI,KAAK,UAAU,gBAAgB,CACpC,MAAoB,EACpB,OAAsB,EACtB,aAAqB,EACrB,SAAiB,EACjB,UAAkB,EAClB,KAAkB;IAElB,IAAI,CAAC;QACH,mCAAmC;QACnC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QAE9D,wDAAwD;QACxD,8BAA8B;QAC9B,IAAI,UAAU,GAAG,MAAM,IAAA,wCAA2B,EAChD,aAAa,EACb,GAAG,OAAO,CAAC,IAAI,SAAS,EACxB,SAAS,EACT,SAAS,EACT,UAAU,CACX,CAAC;QAEF,gDAAgD;QAChD,MAAM,WAAW,GAAG,MAAM,IAAA,qCAAwB,EAChD,aAAa,EACb,GAAG,OAAO,CAAC,IAAI,oBAAoB,mBAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,OAAO,CAC/E,CAAC;QAEF,mDAAmD;QACnD,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;QAChC,CAAC;QAED,2BAA2B;QAC3B,gBAAM,CAAC,KAAK,CAAC,+BAA+B,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,IAAI,eAAe,GAAG,IAAA,oCAAkB,EAAC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC,CAAC;QAE/E,0DAA0D;QAC1D,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,gBAAM,CAAC,IAAI,CAAC,sCAAsC,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;YACxE,eAAe,GAAG,mBAAmB,CAAC,eAAe,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC,CAAC;QAC9F,CAAC;QAED,0GAA0G;QAC1G,MAAM,iCAAiC,GAAG,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/F,IAAI,iCAAiC,IAAI,OAAO,CAAC,yBAAyB,KAAK,KAAK,EAAE,CAAC;YACrF,OAAO,CAAC,GAAG,CACT,uCAAuC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,qBAAqB,CACvF,CAAC;YACF,gBAAM,CAAC,IAAI,CACT,uCAAuC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,qBAAqB,CACvF,CAAC;YACF,IAAI,CAAC;gBACH,6EAA6E;gBAC7E,gBAAM,CAAC,IAAI,CAAC,iDAAiD,OAAO,CAAC,IAAI,YAAY,CAAC,CAAC;gBAEvF,6FAA6F;gBAC7F,MAAM,WAAW,GACf,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBACxF,OAAO,CAAC,GAAG,CAAC,yCAAyC,WAAW,EAAE,CAAC,CAAC;gBACpE,gBAAM,CAAC,IAAI,CAAC,yCAAyC,WAAW,EAAE,CAAC,CAAC;gBAEpE,yCAAyC;gBACzC,MAAM,iBAAiB,GAAG,MAAM,IAAA,iDAA0B,EAAC,WAAW,CAAC,CAAC;gBAExE,mDAAmD;gBACnD,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;oBAC9B,IAAI,CAAC;wBACH,mEAAmE;wBACnE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;wBAC9C,SAAS,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;wBACjD,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;wBACrD,gBAAM,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;oBAC5E,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,gBAAM,CAAC,IAAI,CAAC,4DAA4D,KAAK,EAAE,CAAC,CAAC;wBACjF,wCAAwC;wBACxC,eAAe,IAAI,OAAO,iBAAiB,EAAE,CAAC;wBAC9C,gBAAM,CAAC,IAAI,CACT,sFAAsF,CACvF,CAAC;oBACJ,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,kCAAkC;oBAClC,eAAe,IAAI,OAAO,iBAAiB,EAAE,CAAC;oBAC9C,gBAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;gBAChF,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,gBAAM,CAAC,KAAK,CACV,uDAAuD,OAAO,CAAC,IAAI,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACxI,CAAC;gBACF,gBAAM,CAAC,KAAK,CACV,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,0BAA0B,CACjF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,iEAAiE;QACjE,IAAI,CAAC;YACH,MAAM,kBAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC5B,gBAAM,CAAC,IAAI,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAC;YAEzD,kDAAkD;YAClD,MAAM,gBAAgB,GAAG,MAAM,IAAA,qCAAwB,EACrD,aAAa,EACb,GAAG,OAAO,CAAC,IAAI,WAAW,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CACnD,CAAC;YAEF,gBAAM,CAAC,IAAI,CAAC,uDAAuD,gBAAgB,EAAE,CAAC,CAAC;YAEvF,yBAAyB;YACzB,MAAM,YAAY,GAAG,UAAU,CAAC;YAChC,UAAU,GAAG,gBAAgB,CAAC;YAE9B,gCAAgC;YAChC,gBAAM,CAAC,KAAK,CAAC,4BAA4B,YAAY,OAAO,UAAU,qBAAqB,CAAC,CAAC;QAC/F,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,oCAAoC;YACpC,gBAAM,CAAC,KAAK,CAAC,mDAAmD,UAAU,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,yCAAyC;QACzC,gBAAM,CAAC,KAAK,CAAC,uCAAuC,UAAU,EAAE,CAAC,CAAC;QAClE,MAAM,kBAAE,CAAC,SAAS,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;QAChD,gBAAM,CAAC,IAAI,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC;QAErD,qDAAqD;QACrD,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACxD,MAAM,YAAY,GAAG,MAAM,IAAA,kCAAe,EAAC,eAAe,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YACjF,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,gBAAM,CAAC,IAAI,CAAC,aAAa,YAAY,CAAC,MAAM,+BAA+B,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;QAED,gFAAgF;QAChF,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,gBAAM,CAAC,KAAK,CAAC,4CAA4C,WAAW,EAAE,CAAC,CAAC;YACxE,MAAM,kBAAE,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACjE,gBAAM,CAAC,KAAK,CAAC,6BAA6B,WAAW,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,YAAY,GAAG,MAAM,IAAA,sBAAQ,EAAC,KAAK,EAAE;gBACzC,SAAS,EAAE,WAAW;gBACtB,UAAU,EAAE,SAAS;gBACrB,UAAU,EAAE,OAAO,CAAC,IAAI;aACzB,CAAC,CAAC;YAEH,gBAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC5C,gBAAM,CAAC,KAAK,CAAC,cAAc,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5C,gBAAM,CAAC,KAAK,CAAC,8BAA8B,YAAY,EAAE,CAAC,CAAC;YAE3D,sCAAsC;YACtC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,gBAAM,CAAC,KAAK,CAAC,sBAAsB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YACpD,CAAC;YAED,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC5B,gBAAM,CAAC,KAAK,CACV,2GAA2G,CAC5G,CAAC;YACJ,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACnC,gBAAM,CAAC,KAAK,CACV,wFAAwF,CACzF,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,gBAAM,CAAC,KAAK,CAAC,uCAAuC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/core/ReviewGenerator.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Review generator module.
+ *
+ * This module coordinates OpenRouter reviews. All other provider implementations
+ * have been removed so we can focus on the only runtime dependency we actually use.
+ */
+import type { FileInfo, ReviewOptions, ReviewResult, ReviewType } from '../types/review';
+import type { ProjectDocs } from '../utils/projectDocs';
+import type { ApiClientConfig } from './ApiClientSelector';
+/**
+ * Generate an OpenRouter review.
+ */
+export declare function generateReview(fileInfos: FileInfo[], project: string, reviewType: ReviewType, projectDocs: ProjectDocs | null, options: ReviewOptions, apiClientConfig: ApiClientConfig): Promise<ReviewResult>;

package/dist/core/ReviewGenerator.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * @fileoverview Review generator module.
+ *
+ * This module coordinates OpenRouter reviews. All other provider implementations
+ * have been removed so we can focus on the only runtime dependency we actually use.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateReview = generateReview;
+const openRouterClientWrapper_1 = require("../clients/openRouterClientWrapper");
+const logger_1 = __importDefault(require("../utils/logger"));
+/**
+ * Generate an OpenRouter review.
+ */
+async function generateReview(fileInfos, project, reviewType, projectDocs, options, apiClientConfig) {
+    logger_1.default.debug('generateReview called');
+    logger_1.default.debug(`generateReview: apiClientConfig=${JSON.stringify(apiClientConfig)}`);
+    if (apiClientConfig.clientType !== 'OpenRouter') {
+        throw new Error(`Unsupported client type: ${apiClientConfig.clientType ?? 'unknown'}`);
+    }
+    let result;
+    try {
+        await (0, openRouterClientWrapper_1.initializeAnyOpenRouterModel)();
+        result = await (0, openRouterClientWrapper_1.generateOpenRouterConsolidatedReview)(fileInfos, project, reviewType, projectDocs, options);
+    }
+    catch (error) {
+        logger_1.default.error(`Error initializing or calling OpenRouter client: ${error instanceof Error ? error.message : String(error)}`);
+        throw error;
+    }
+    const reviewResult = result;
+    // Enhanced logging for debugging empty content issues
+    logger_1.default.debug(`generateReview completed:`);
+    logger_1.default.debug(`  Client type: ${apiClientConfig.clientType}`);
+    logger_1.default.debug(`  Model: ${apiClientConfig.modelName}`);
+    logger_1.default.debug(`  Result exists: ${!!reviewResult}`);
+    logger_1.default.debug(`  Content exists: ${!!(reviewResult && reviewResult.content)}`);
+    logger_1.default.debug(`  Content length: ${reviewResult && reviewResult.content ? reviewResult.content.length : 'N/A'}`);
+    logger_1.default.debug(`  Content preview: ${reviewResult && reviewResult.content ? reviewResult.content.substring(0, 100).replace(/\n/g, ' ') + '...' : 'N/A'}`);
+    // Get package version from process.env or hardcoded value
+    const packageVersion = process.env.npm_package_version || '2.1.1';
+    // Create a string representation of the command-line options
+    const commandOptions = Object.entries(options)
+        .filter(([key, value]) => {
+        // Filter out internal options and undefined values
+        if (key.startsWith('_') || value === undefined)
+            return false;
+        // Filter out ciData which can be very large
+        if (key === 'ciData')
+            return false;
+        // Filter out empty arrays and objects
+        if (Array.isArray(value) && value.length === 0)
+            return false;
+        if (typeof value === 'object' && value !== null && Object.keys(value).length === 0)
+            return false;
+        return true;
+    })
+        .map(([key, value]) => {
+        // Format boolean options as flags without values
+        if (typeof value === 'boolean') {
+            return value ? `--${key}` : '';
+        }
+        // Format arrays and objects as JSON strings
+        if (typeof value === 'object' && value !== null) {
+            return `--${key}='${JSON.stringify(value)}'`;
+        }
+        // Format other values normally
+        return `--${key}=${value}`;
+    })
+        .filter(Boolean) // Remove empty strings
+        .join(' ');
+    // Add metadata to the review result
+    reviewResult.toolVersion = packageVersion;
+    reviewResult.commandOptions = commandOptions;
+    // Ensure costInfo is set if only cost is available
+    if (reviewResult.cost && !reviewResult.costInfo) {
+        reviewResult.costInfo = reviewResult.cost;
+    }
+    // Ensure required fields are set to avoid undefined values in output
+    if (!reviewResult.filePath) {
+        logger_1.default.warn('Review result has no filePath. Setting to default value.');
+        reviewResult.filePath = reviewType;
+    }
+    if (!reviewResult.modelUsed) {
+        logger_1.default.warn('Review result has no modelUsed. Setting to default value.');
+        reviewResult.modelUsed = `${apiClientConfig.clientType}:${apiClientConfig.modelName}`;
+    }
+    // Final validation before returning
+    if (!reviewResult.content || reviewResult.content.trim() === '') {
+        logger_1.default.error('CRITICAL: generateReview is about to return a result with empty content!');
+        logger_1.default.error(`  Client: ${apiClientConfig.clientType}:${apiClientConfig.modelName}`);
+        logger_1.default.error(`  Files: ${fileInfos.length} files`);
+        logger_1.default.error(`  Review type: ${reviewType}`);
+        logger_1.default.error(`  Project: ${project}`);
+        // This is a critical error that should be investigated
+        throw new Error(`generateReview produced empty content for ${apiClientConfig.clientType}:${apiClientConfig.modelName}`);
+    }
+    return reviewResult;
+}
+//# sourceMappingURL=ReviewGenerator.js.map

package/dist/core/ReviewGenerator.js.map

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

package/dist/core/fileDiscovery.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview File discovery and filtering module.
+ *
+ * This module is responsible for finding, filtering, and reading files for review.
+ * It handles gitignore patterns, test exclusions, and file system operations.
+ */
+/**
+ * File information structure
+ */
+export interface FileInfo {
+    path: string;
+    relativePath: string;
+    content: string;
+}
+/**
+ * Discover files for review based on the target path and options
+ * @param target The target file or directory path
+ * @param projectPath The project root path
+ * @param includeTests Whether to include test files
+ * @returns Array of file paths to review
+ */
+export declare function discoverFiles(target: string, projectPath: string, includeTests?: boolean): Promise<string[]>;
+/**
+ * Read file contents and prepare file information for review
+ * @param filePaths Array of file paths to read
+ * @param projectPath The project root path
+ * @returns Array of FileInfo objects with file contents
+ */
+export declare function readFilesContent(filePaths: string[], projectPath: string): Promise<{
+    fileInfos: FileInfo[];
+    errors: Array<{
+        path: string;
+        error: string;
+    }>;
+}>;

package/dist/core/fileDiscovery.js

@@ -0,0 +1,202 @@
+"use strict";
+/**
+ * @fileoverview File discovery and filtering module.
+ *
+ * This module is responsible for finding, filtering, and reading files for review.
+ * It handles gitignore patterns, test exclusions, and file system operations.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverFiles = discoverFiles;
+exports.readFilesContent = readFilesContent;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const fileFilters_1 = require("../utils/fileFilters");
+const fileSystem_1 = require("../utils/fileSystem");
+const logger_1 = __importDefault(require("../utils/logger"));
+const smartFileSelector_1 = require("../utils/smartFileSelector");
+/**
+ * Validate target parameter and provide helpful error messages for common mistakes
+ * @param target The target parameter to validate
+ * @throws Error with helpful message if the target looks like a misformatted parameter
+ */
+function validateTargetParameter(target) {
+    // Check for common parameter format mistakes
+    if (target.includes('=')) {
+        const [key, ...valueParts] = target.split('=');
+        const value = valueParts.join('='); // Rejoin in case value contains =
+        const commonOptions = [
+            'type',
+            'output',
+            'model',
+            'language',
+            'debug',
+            'interactive',
+            'estimate',
+        ];
+        // Only flag as parameter if the key part matches a known option
+        // This avoids false positives for file paths like "src/file=name.ts"
+        if (commonOptions.includes(key)) {
+            throw new Error(`Invalid parameter format: '${target}'
+    
+It looks like you're trying to set the '${key}' option.
+Did you mean: --${key} ${value}
+
+Example usage:
+  cr-aia --${key} ${value}
+  cr-aia src --${key} ${value}
+  cr-aia . --${key} ${value}
+
+Run 'cr-aia --help' for more options.`);
+        }
+        if (!key.includes('/') && !key.includes('\\') && !key.includes('.')) {
+            // If the key doesn't look like a path (no slashes or dots), it's probably a parameter mistake
+            throw new Error(`Invalid parameter format: '${target}'
+    
+Parameters should use '--' prefix, not '=' format.
+Example: --type performance
+
+Common usage patterns:
+  cr-aia                    # Review current directory
+  cr-aia src                 # Review src directory
+  cr-aia src/index.ts        # Review specific file
+  cr-aia --type security     # Security review of current directory
+  cr-aia src --type performance  # Performance review of src
+
+Run 'cr-aia --help' for all options.`);
+        }
+        // If key looks like a path (contains / or \ or .), don't flag it as an error
+    }
+    // Check if the target looks like an option without proper prefix
+    const commonOptions = [
+        'type',
+        'output',
+        'model',
+        'language',
+        'debug',
+        'interactive',
+        'estimate',
+        'help',
+        'version',
+    ];
+    if (commonOptions.includes(target)) {
+        throw new Error(`'${target}' looks like an option but is missing '--' prefix.
+    
+Did you mean: --${target}
+
+Example usage:
+  cr-aia --${target}
+  cr-aia src --${target}
+
+For options that require values:
+  cr-aia --type performance
+  cr-aia --output json
+  cr-aia --model openai:gpt-4
+
+Run 'cr-aia --help' for more information.`);
+    }
+    // Check for other common mistakes
+    if (target.startsWith('-') && !target.startsWith('--')) {
+        throw new Error(`Invalid option format: '${target}'
+    
+Options should use double dashes (--), not single dash (-).
+Did you mean: -${target}?
+
+Example usage:
+  cr-aia --type security
+  cr-aia --debug
+  cr-aia --help
+
+Run 'cr-aia --help' for all available options.`);
+    }
+}
+/**
+ * Discover files for review based on the target path and options
+ * @param target The target file or directory path
+ * @param projectPath The project root path
+ * @param includeTests Whether to include test files
+ * @returns Array of file paths to review
+ */
+async function discoverFiles(target, projectPath, includeTests = false) {
+    try {
+        // First validate the target parameter for common mistakes
+        validateTargetParameter(target);
+        // Validate the target path
+        const resolvedTarget = node_path_1.default.resolve(projectPath, target);
+        // Check if the path is within the project directory
+        if (!(0, fileSystem_1.isPathWithinCwd)(resolvedTarget)) {
+            throw new Error(`Target must be within the project directory: ${projectPath}`);
+        }
+        const targetPath = resolvedTarget;
+        // Check if the target exists
+        const isFileTarget = (await (0, fileSystem_1.pathExists)(targetPath)) && !(await (0, fileSystem_1.isDirectory)(targetPath));
+        const isDirectoryTarget = await (0, fileSystem_1.isDirectory)(targetPath);
+        if (!isFileTarget && !isDirectoryTarget) {
+            throw new Error(`Target not found: ${target}`);
+        }
+        // Load gitignore patterns from target path, not project path
+        const gitignorePatterns = await (0, fileFilters_1.loadGitignorePatterns)(targetPath);
+        logger_1.default.debug(`Loaded ${gitignorePatterns.length} patterns from .gitignore in ${targetPath}`);
+        // Get files to review using the existing filter utility
+        let filesToReview = await (0, fileFilters_1.getFilesToReview)(targetPath, isFileTarget, includeTests, gitignorePatterns);
+        // Apply smart filtering (tsconfig.json and .eslintignore)
+        if (filesToReview.length > 0) {
+            logger_1.default.info('Applying smart filtering based on project configuration files...');
+            // Use the target directory for finding tsconfig.json, not the project root
+            const configDir = isFileTarget ? node_path_1.default.dirname(targetPath) : targetPath;
+            filesToReview = await (0, smartFileSelector_1.applySmartFiltering)(filesToReview, configDir);
+        }
+        if (filesToReview.length === 0) {
+            logger_1.default.info('No files found to review.');
+        }
+        else {
+            logger_1.default.info(`Found ${filesToReview.length} files to review.`);
+        }
+        return filesToReview;
+    }
+    catch (error) {
+        logger_1.default.error(`Error discovering files: ${error instanceof Error ? error.message : String(error)}`);
+        throw error; // Re-throw to allow the caller to handle it
+    }
+}
+/**
+ * Read file contents and prepare file information for review
+ * @param filePaths Array of file paths to read
+ * @param projectPath The project root path
+ * @returns Array of FileInfo objects with file contents
+ */
+async function readFilesContent(filePaths, projectPath) {
+    const fileInfos = [];
+    const errors = [];
+    for (const filePath of filePaths) {
+        try {
+            // Check if file exists and is readable
+            if (!(await (0, fileSystem_1.pathExists)(filePath))) {
+                errors.push({ path: filePath, error: 'File does not exist' });
+                continue;
+            }
+            // Read file content
+            const fileContent = await promises_1.default.readFile(filePath, 'utf-8');
+            // Get relative path from project root
+            const relativePath = node_path_1.default.relative(projectPath, filePath);
+            // Add to file infos
+            fileInfos.push({
+                path: filePath,
+                relativePath,
+                content: fileContent,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger_1.default.error(`Error reading file ${filePath}: ${errorMessage}`);
+            errors.push({ path: filePath, error: errorMessage });
+        }
+    }
+    if (errors.length > 0) {
+        logger_1.default.warn(`Failed to read ${errors.length} file(s)`);
+    }
+    return { fileInfos, errors };
+}
+//# sourceMappingURL=fileDiscovery.js.map

package/dist/core/fileDiscovery.js.map

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

package/dist/core/handlers/EstimationHandler.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Token and cost estimation handler for code review
+ *
+ * This module handles token usage estimation and cost analysis for code review
+ * using the TokenAnalyzer plus legacy fallbacks.
+ */
+import type { ReviewOptions } from '../../types/review';
+import type { FileInfo } from '../fileDiscovery';
+/**
+ * Perform token usage and cost estimation for review
+ *
+ * @param fileInfos Array of file information objects
+ * @param filesToReview Array of file paths
+ * @param options Review options
+ * @param modelName Model name to use for estimation
+ * @returns Promise that resolves when estimation is complete
+ */
+export declare function performEstimation(fileInfos: FileInfo[], filesToReview: string[], options: ReviewOptions, modelName: string): Promise<void>;