codereview-aia 0.1.0 → 0.1.2

package/dist/analysis/context/ReviewContext.js

@@ -0,0 +1,294 @@
+"use strict";
+/**
+ * @fileoverview Review context for maintaining state between review passes.
+ *
+ * This module provides a class for maintaining context between multiple review passes.
+ * It stores information about the review, including file metadata, important code elements,
+ * and findings from previous passes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReviewContext = exports.CodeElementType = void 0;
+/**
+ * Type of code element tracked in the context
+ */
+var CodeElementType;
+(function (CodeElementType) {
+    CodeElementType["Function"] = "function";
+    CodeElementType["Class"] = "class";
+    CodeElementType["Interface"] = "interface";
+    CodeElementType["Variable"] = "variable";
+    CodeElementType["Import"] = "import";
+    CodeElementType["ExportedItem"] = "exported";
+    CodeElementType["Component"] = "component";
+    CodeElementType["EntryPoint"] = "entryPoint";
+})(CodeElementType || (exports.CodeElementType = CodeElementType = {}));
+/**
+ * Context for multi-pass reviews
+ */
+class ReviewContext {
+    /** Project name */
+    projectName;
+    /** Review type */
+    reviewType;
+    /** All files involved in the review */
+    allFiles;
+    /** Current pass number */
+    currentPass;
+    /** Important code elements tracked across passes */
+    codeElements;
+    /** Findings from previous passes */
+    findings;
+    /** File summaries from previous passes */
+    fileSummaries;
+    /** General notes about the codebase */
+    generalNotes;
+    /** Timestamp when context was created */
+    createdAt;
+    /** Timestamp of last update */
+    updatedAt;
+    /**
+     * Create a new review context
+     * @param projectName Name of the project
+     * @param reviewType Type of review
+     * @param files Files involved in the review
+     */
+    constructor(projectName, reviewType, files) {
+        this.projectName = projectName;
+        this.reviewType = reviewType;
+        this.allFiles = files.map((f) => f.path);
+        this.currentPass = 0;
+        this.codeElements = new Map();
+        this.findings = [];
+        this.fileSummaries = new Map();
+        this.generalNotes = [];
+        this.createdAt = new Date();
+        this.updatedAt = new Date();
+    }
+    /**
+     * Start a new review pass
+     * @returns Updated pass number
+     */
+    startPass() {
+        this.currentPass++;
+        this.updatedAt = new Date();
+        return this.currentPass;
+    }
+    /**
+     * Get the current pass number
+     * @returns Current pass number
+     */
+    getCurrentPass() {
+        return this.currentPass;
+    }
+    /**
+     * Add a code element to the context
+     * @param element Code element to add
+     */
+    addCodeElement(element) {
+        const key = `${element.type}:${element.file}:${element.name}`;
+        this.codeElements.set(key, element);
+        this.updatedAt = new Date();
+    }
+    /**
+     * Get all tracked code elements
+     * @returns Array of code elements
+     */
+    getCodeElements() {
+        return Array.from(this.codeElements.values());
+    }
+    /**
+     * Get code elements of a specific type
+     * @param type Type of code elements to get
+     * @returns Array of code elements of the specified type
+     */
+    getCodeElementsByType(type) {
+        return this.getCodeElements().filter((el) => el.type === type);
+    }
+    /**
+     * Get code elements in a specific file
+     * @param filePath Path of the file
+     * @returns Array of code elements in the file
+     */
+    getCodeElementsInFile(filePath) {
+        return this.getCodeElements().filter((el) => el.file === filePath);
+    }
+    /**
+     * Add a review finding
+     * @param finding Review finding to add
+     */
+    addFinding(finding) {
+        this.findings.push({
+            ...finding,
+            passNumber: this.currentPass,
+        });
+        this.updatedAt = new Date();
+    }
+    /**
+     * Get all findings
+     * @returns Array of all findings
+     */
+    getFindings() {
+        return [...this.findings];
+    }
+    /**
+     * Add or update a file summary
+     * @param summary File summary to add
+     */
+    addFileSummary(summary) {
+        this.fileSummaries.set(summary.path, {
+            ...summary,
+            passNumber: this.currentPass,
+        });
+        this.updatedAt = new Date();
+    }
+    /**
+     * Get summary for a specific file
+     * @param filePath Path of the file
+     * @returns File summary or undefined if not found
+     */
+    getFileSummary(filePath) {
+        return this.fileSummaries.get(filePath);
+    }
+    /**
+     * Get summaries for all files
+     * @returns Array of file summaries
+     */
+    getAllFileSummaries() {
+        return Array.from(this.fileSummaries.values());
+    }
+    /**
+     * Add a general note about the codebase
+     * @param note Note to add
+     */
+    addGeneralNote(note) {
+        this.generalNotes.push(note);
+        this.updatedAt = new Date();
+    }
+    /**
+     * Get all general notes
+     * @returns Array of general notes
+     */
+    getGeneralNotes() {
+        return [...this.generalNotes];
+    }
+    /**
+     * Generate a contextual prompt for the next pass
+     * @param files Files to include in the next pass
+     * @param maxContextLength Maximum length of context in characters
+     * @returns Formatted context string for inclusion in the next prompt
+     */
+    generateNextPassContext(files, maxContextLength = 2000) {
+        let context = `
+### Review Context (Pass ${this.currentPass})
+
+Project: ${this.projectName}
+Review Type: ${this.reviewType}
+Files in this pass: ${files.length} / ${this.allFiles.length}
+
+`;
+        // Add important findings from previous passes
+        const importantFindings = this.findings.sort((a, b) => b.severity - a.severity).slice(0, 5);
+        if (importantFindings.length > 0) {
+            context += '#### Key Findings from Previous Passes\n\n';
+            importantFindings.forEach((finding) => {
+                context += `- [${finding.type.toUpperCase()}] ${finding.description}${finding.file ? ` (in ${finding.file})` : ''}\n`;
+            });
+            context += '\n';
+        }
+        // Add summaries of files that are related but not in this pass
+        const relatedFiles = this.getAllFileSummaries()
+            .filter((summary) => !files.includes(summary.path))
+            .slice(0, 5);
+        if (relatedFiles.length > 0) {
+            context += '#### Related Files (Not in This Pass)\n\n';
+            relatedFiles.forEach((file) => {
+                context += `- ${file.path}: ${file.description}\n`;
+                if (file.keyElements.length > 0) {
+                    context += `  Key elements: ${file.keyElements.join(', ')}\n`;
+                }
+            });
+            context += '\n';
+        }
+        // Add important code elements relevant to this pass
+        const relevantElements = this.getCodeElements()
+            .filter((el) => files.includes(el.file) || el.importance > 7)
+            .sort((a, b) => b.importance - a.importance)
+            .slice(0, 10);
+        if (relevantElements.length > 0) {
+            context += '#### Important Code Elements\n\n';
+            relevantElements.forEach((element) => {
+                context += `- ${element.type} \`${element.name}\`${element.signature ? `: ${element.signature}` : ''} (in ${element.file})\n`;
+            });
+            context += '\n';
+        }
+        // Add general notes
+        if (this.generalNotes.length > 0) {
+            context += '#### General Notes\n\n';
+            this.generalNotes.slice(0, 3).forEach((note) => {
+                context += `- ${note}\n`;
+            });
+            context += '\n';
+        }
+        // Truncate if too long
+        if (context.length > maxContextLength) {
+            context = `${context.substring(0, maxContextLength - 3)}...`;
+        }
+        return context;
+    }
+    /**
+     * Serialize the context to JSON
+     * @returns JSON representation of the context
+     */
+    toJSON() {
+        return {
+            projectName: this.projectName,
+            reviewType: this.reviewType,
+            currentPass: this.currentPass,
+            codeElements: Array.from(this.codeElements.values()),
+            findings: this.findings,
+            fileSummaries: Array.from(this.fileSummaries.values()),
+            generalNotes: this.generalNotes,
+            createdAt: this.createdAt.toISOString(),
+            updatedAt: this.updatedAt.toISOString(),
+        };
+    }
+    /**
+     * Create a review context from JSON
+     * @param json JSON object
+     * @returns New ReviewContext instance
+     */
+    static fromJSON(json) {
+        const context = new ReviewContext(json.projectName, json.reviewType, json.allFiles || []);
+        context.currentPass = json.currentPass || 0;
+        // Restore code elements
+        if (Array.isArray(json.codeElements)) {
+            json.codeElements.forEach((element) => {
+                context.addCodeElement(element);
+            });
+        }
+        // Restore findings
+        if (Array.isArray(json.findings)) {
+            context.findings = json.findings;
+        }
+        // Restore file summaries
+        if (Array.isArray(json.fileSummaries)) {
+            json.fileSummaries.forEach((summary) => {
+                context.fileSummaries.set(summary.path, summary);
+            });
+        }
+        // Restore general notes
+        if (Array.isArray(json.generalNotes)) {
+            context.generalNotes = json.generalNotes;
+        }
+        // Restore timestamps
+        if (json.createdAt) {
+            context.createdAt = new Date(json.createdAt);
+        }
+        if (json.updatedAt) {
+            context.updatedAt = new Date(json.updatedAt);
+        }
+        return context;
+    }
+}
+exports.ReviewContext = ReviewContext;
+//# sourceMappingURL=ReviewContext.js.map

package/dist/analysis/context/ReviewContext.js.map

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

package/dist/analysis/context/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Context management exports.
+ *
+ * This module exports all context management related functions and types.
+ */
+export * from './ReviewContext';

package/dist/analysis/context/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * @fileoverview Context management exports.
+ *
+ * This module exports all context management related functions and types.
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ReviewContext"), exports);
+//# sourceMappingURL=index.js.map

package/dist/analysis/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analysis/context/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,kDAAgC"}

package/dist/analysis/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Analysis module exports.
+ *
+ * This module exports all analysis related functions and types.
+ */
+export * from './context';
+export * from './tokens';

package/dist/analysis/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * @fileoverview Analysis module exports.
+ *
+ * This module exports all analysis related functions and types.
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./context"), exports);
+__exportStar(require("./tokens"), exports);
+//# sourceMappingURL=index.js.map

package/dist/analysis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,4CAA0B;AAC1B,2CAAyB"}

package/dist/analysis/tokens/TokenAnalysisFormatter.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Formatter for token analysis results.
+ *
+ * This module provides utilities for formatting token analysis results into
+ * human-readable strings and other formats for display or logging.
+ */
+import type { FileTokenAnalysis, TokenAnalysisResult } from './TokenAnalyzer';
+/**
+ * Format token analysis result as a human-readable string
+ * @param analysis Token analysis result
+ * @param modelName Name of the model used
+ * @param includedFiles Whether to include detailed file listing
+ * @returns Formatted string representation of the analysis
+ */
+export declare function formatTokenAnalysis(analysis: TokenAnalysisResult, modelName: string, includeFiles?: boolean): string;
+/**
+ * Format token analysis result as JSON
+ * @param analysis Token analysis result
+ * @returns JSON string representation of the analysis
+ */
+export declare function formatTokenAnalysisAsJson(analysis: TokenAnalysisResult): string;
+/**
+ * Format a single file token analysis as a string
+ * @param fileAnalysis File token analysis
+ * @returns Formatted string representation of the file analysis
+ */
+export declare function formatFileTokenAnalysis(fileAnalysis: FileTokenAnalysis): string;

package/dist/analysis/tokens/TokenAnalysisFormatter.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * @fileoverview Formatter for token analysis results.
+ *
+ * This module provides utilities for formatting token analysis results into
+ * human-readable strings and other formats for display or logging.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTokenAnalysis = formatTokenAnalysis;
+exports.formatTokenAnalysisAsJson = formatTokenAnalysisAsJson;
+exports.formatFileTokenAnalysis = formatFileTokenAnalysis;
+/**
+ * Format a number with commas as thousands separators
+ * @param num Number to format
+ * @returns Formatted number string
+ */
+function formatNumber(num) {
+    return num.toLocaleString();
+}
+/**
+ * Format a file size in bytes to a human-readable string
+ * @param bytes Size in bytes
+ * @returns Formatted size string (e.g., "1.23 KB")
+ */
+function formatFileSize(bytes) {
+    if (bytes < 1024) {
+        return `${bytes} B`;
+    }
+    if (bytes < 1024 * 1024) {
+        return `${(bytes / 1024).toFixed(2)} KB`;
+    }
+    return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+}
+/**
+ * Format token analysis result as a human-readable string
+ * @param analysis Token analysis result
+ * @param modelName Name of the model used
+ * @param includedFiles Whether to include detailed file listing
+ * @returns Formatted string representation of the analysis
+ */
+function formatTokenAnalysis(analysis, modelName, includeFiles = false) {
+    // Extract provider and model from both colon and slash formats
+    // Handle formats: "provider:model", "provider/model", or just "model"
+    let provider;
+    let model;
+    if (modelName.includes(':')) {
+        // Traditional format: "provider:model"
+        [provider, model] = modelName.split(':', 2);
+    }
+    else if (modelName.includes('/')) {
+        // OpenRouter format: "provider/model"
+        [provider, model] = modelName.split('/', 2);
+    }
+    else {
+        // Just model name
+        provider = undefined;
+        model = modelName;
+    }
+    const displayModel = model || modelName;
+    const displayProvider = provider
+        ? `${provider.charAt(0).toUpperCase() + provider.slice(1)}`
+        : 'Unknown';
+    let output = `
+=== Token Analysis Report ===
+
+Provider: ${displayProvider}
+Model: ${displayModel}
+Files: ${formatNumber(analysis.fileCount)} (${formatFileSize(analysis.totalSizeInBytes)})
+
+Token Information:
+  Content Tokens: ${formatNumber(analysis.totalTokens)}
+  Prompt Overhead: ${formatNumber(analysis.promptOverheadTokens)}
+  Total Estimated Tokens: ${formatNumber(analysis.estimatedTotalTokens)}
+  Context Window Size: ${formatNumber(analysis.contextWindowSize)}
+
+Context Utilization:
+  ${((analysis.estimatedTotalTokens / analysis.contextWindowSize) * 100).toFixed(2)}% of context window used
+
+`;
+    // Add chunking information if recommended
+    if (analysis.chunkingRecommendation.chunkingRecommended) {
+        output += `
+Multi-Pass Analysis:
+  Chunking Required: Yes
+  Reason: ${analysis.chunkingRecommendation.reason}
+  Estimated Passes: ${formatNumber(analysis.estimatedPassesNeeded)}
+`;
+        // Add chunk details
+        analysis.chunkingRecommendation.recommendedChunks.forEach((chunk, index) => {
+            output += `
+  Chunk ${index + 1}:
+    Files: ${formatNumber(chunk.files.length)}
+    Estimated Tokens: ${formatNumber(chunk.estimatedTokenCount)}
+    Priority: ${chunk.priority}
+`;
+        });
+    }
+    else {
+        output += `
+Multi-Pass Analysis:
+  Chunking Required: No
+  Reason: ${analysis.chunkingRecommendation.reason}
+`;
+    }
+    // Add file details if requested
+    if (includeFiles) {
+        output += `
+File Details:
+`;
+        // Sort files by token count (largest first)
+        const sortedFiles = [...analysis.files].sort((a, b) => b.tokenCount - a.tokenCount);
+        sortedFiles.forEach((file) => {
+            output += `  ${file.relativePath}:
+    Tokens: ${formatNumber(file.tokenCount)}
+    Size: ${formatFileSize(file.sizeInBytes)}
+    Tokens/Byte: ${file.tokensPerByte.toFixed(2)}
+`;
+        });
+    }
+    return output;
+}
+/**
+ * Format token analysis result as JSON
+ * @param analysis Token analysis result
+ * @returns JSON string representation of the analysis
+ */
+function formatTokenAnalysisAsJson(analysis) {
+    return JSON.stringify(analysis, null, 2);
+}
+/**
+ * Format a single file token analysis as a string
+ * @param fileAnalysis File token analysis
+ * @returns Formatted string representation of the file analysis
+ */
+function formatFileTokenAnalysis(fileAnalysis) {
+    return `
+File: ${fileAnalysis.relativePath}
+Tokens: ${formatNumber(fileAnalysis.tokenCount)}
+Size: ${formatFileSize(fileAnalysis.sizeInBytes)}
+Tokens/Byte: ${fileAnalysis.tokensPerByte.toFixed(2)}
+`;
+}
+//# sourceMappingURL=TokenAnalysisFormatter.js.map

package/dist/analysis/tokens/TokenAnalysisFormatter.js.map

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