codereview-aia 0.1.3 → 0.2.0

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/{src/analysis/context/index.ts → dist/analysis/context/index.d.ts}

@@ -3,5 +3,4 @@
  *
  * 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/{src/analysis/index.ts → dist/analysis/index.d.ts}

@@ -3,6 +3,5 @@
  *
  * 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/static/wpPhpcsRunner.d.ts

@@ -0,0 +1,11 @@
+import type { WordPressStandardsFinding, WordPressStandardsReport } from '../../types/review';
+export interface WordPressPhpcsOptions {
+    enabled?: boolean;
+    phpcsPath?: string;
+    rulesetPath?: string;
+    testVersion?: string;
+}
+export declare function getCachedWordPressReport(projectRoot: string, files: string[], options: WordPressPhpcsOptions): Promise<WordPressStandardsReport>;
+export declare function resetWordPressReportCache(): void;
+export declare function summarizeWordPressReport(report: WordPressStandardsReport, limit?: number, projectRoot?: string): string;
+export declare function formatWordPressFinding(finding: WordPressStandardsFinding, projectRoot: string): string;

package/dist/analysis/static/wpPhpcsRunner.js

@@ -0,0 +1,219 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCachedWordPressReport = getCachedWordPressReport;
+exports.resetWordPressReportCache = resetWordPressReportCache;
+exports.summarizeWordPressReport = summarizeWordPressReport;
+exports.formatWordPressFinding = formatWordPressFinding;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const execa_1 = require("execa");
+const logger_1 = __importDefault(require("../../utils/logger"));
+const reportCache = new Map();
+function resolveDefaultRuleset(projectRoot) {
+    // 1. Check for project-level configuration (phpcs.xml or phpcs.xml.dist)
+    const projectConfigCandidates = [
+        node_path_1.default.join(projectRoot, 'phpcs.xml'),
+        node_path_1.default.join(projectRoot, 'phpcs.xml.dist'),
+    ];
+    for (const config of projectConfigCandidates) {
+        if (node_fs_1.default.existsSync(config)) {
+            logger_1.default.debug(`Found project-level PHPCS config: ${config}`);
+            return undefined; // Return undefined to let PHPCS auto-discover this
+        }
+    }
+    // 2. Check for WordPress Coding Standards in standard locations
+    const wpcsCandidates = [
+        node_path_1.default.resolve(projectRoot, '..', 'WordPress-Coding-Standards-develop', 'WordPress', 'ruleset.xml'),
+        node_path_1.default.resolve(projectRoot, 'WordPress-Coding-Standards-develop', 'WordPress', 'ruleset.xml'),
+        node_path_1.default.resolve(projectRoot, 'vendor', 'wp-coding-standards', 'wpcs', 'WordPress', 'ruleset.xml'),
+    ];
+    for (const candidate of wpcsCandidates) {
+        if (node_fs_1.default.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+function pickPhpcsBinary(customPath) {
+    if (customPath) {
+        return customPath;
+    }
+    if (process.env.PHPCS_BINARY) {
+        return process.env.PHPCS_BINARY;
+    }
+    return 'phpcs';
+}
+function filterPhpFiles(files) {
+    return files
+        .map((file) => node_path_1.default.resolve(file))
+        .filter((file) => /\.(php|phtml|inc|php5|php7)$/i.test(file));
+}
+async function executePhpcs(projectRoot, files, options) {
+    if (options.enabled === false) {
+        return {
+            status: 'skipped',
+            errors: 0,
+            warnings: 0,
+            findings: [],
+            reason: 'WordPress PHPCS disabled',
+        };
+    }
+    const phpFiles = filterPhpFiles(files);
+    if (phpFiles.length === 0) {
+        return {
+            status: 'skipped',
+            errors: 0,
+            warnings: 0,
+            findings: [],
+            reason: 'No PHP files provided for PHPCS scan',
+        };
+    }
+    const ruleset = options.rulesetPath || resolveDefaultRuleset(projectRoot);
+    // If ruleset is undefined here, it might mean we found a phpcs.xml, or we're relying on global config.
+    // We'll proceed and let PHPCS decide, unless we want to enforce a specific fallback.
+    const phpcsBinary = pickPhpcsBinary(options.phpcsPath);
+    // Base arguments
+    const baseArgs = [
+        '--report=json',
+        '--colors=false',
+        '--extensions=php,php5,inc,phtml',
+    ];
+    if (ruleset) {
+        baseArgs.push(`--standard=${ruleset}`);
+    }
+    if (options.testVersion) {
+        baseArgs.push('--runtime-set', 'testVersion', options.testVersion);
+    }
+    // Batch processing to avoid E2BIG
+    const BATCH_SIZE = 50;
+    const allFindings = [];
+    let totalErrors = 0;
+    let totalWarnings = 0;
+    let hasFailure = false;
+    let failureReason = '';
+    for (let i = 0; i < phpFiles.length; i += BATCH_SIZE) {
+        const batch = phpFiles.slice(i, i + BATCH_SIZE);
+        const args = [...baseArgs, ...batch];
+        try {
+            const { stdout } = await (0, execa_1.execa)(phpcsBinary, args, {
+                cwd: projectRoot,
+                reject: false,
+            });
+            if (!stdout || stdout.trim().length === 0) {
+                continue;
+            }
+            // Robust JSON parsing: find the first '{' and last '}'
+            const jsonStart = stdout.indexOf('{');
+            const jsonEnd = stdout.lastIndexOf('}');
+            if (jsonStart === -1 || jsonEnd === -1) {
+                logger_1.default.warn('PHPCS output does not contain valid JSON');
+                continue;
+            }
+            const jsonStr = stdout.substring(jsonStart, jsonEnd + 1);
+            let parsed;
+            try {
+                parsed = JSON.parse(jsonStr);
+            }
+            catch (error) {
+                logger_1.default.warn(`Failed to parse PHPCS output batch ${i}: ${error instanceof Error ? error.message : String(error)}`);
+                continue;
+            }
+            if (parsed.totals) {
+                totalErrors += Number(parsed.totals.errors ?? 0);
+                totalWarnings += Number(parsed.totals.warnings ?? 0);
+            }
+            if (parsed.files) {
+                for (const [fileName, data] of Object.entries(parsed.files)) {
+                    const messages = Array.isArray(data.messages) ? data.messages : [];
+                    for (const message of messages) {
+                        allFindings.push({
+                            filePath: fileName,
+                            line: message.line ?? 0,
+                            column: message.column ?? 0,
+                            type: message.type === 'ERROR' ? 'ERROR' : 'WARNING',
+                            severity: Number(message.severity ?? 0),
+                            message: message.message ?? 'Violation detected',
+                            source: message.source ?? 'WordPress',
+                        });
+                    }
+                }
+            }
+        }
+        catch (error) {
+            hasFailure = true;
+            failureReason =
+                error instanceof Error && 'code' in error && error.code === 'ENOENT'
+                    ? `PHPCS binary not found (${phpcsBinary})`
+                    : error instanceof Error
+                        ? error.message
+                        : 'Unknown error running PHPCS';
+            // If binary is missing, abort immediately
+            if (failureReason.includes('binary not found')) {
+                return {
+                    status: 'skipped',
+                    errors: 0,
+                    warnings: 0,
+                    findings: [],
+                    reason: failureReason,
+                };
+            }
+            logger_1.default.warn(`Error running PHPCS batch: ${failureReason}`);
+        }
+    }
+    if (hasFailure && allFindings.length === 0) {
+        return {
+            status: 'failed',
+            errors: 0,
+            warnings: 0,
+            findings: [],
+            reason: failureReason || 'PHPCS execution failed',
+        };
+    }
+    return {
+        status: 'ok',
+        errors: totalErrors,
+        warnings: totalWarnings,
+        findings: allFindings,
+    };
+}
+function getCachedWordPressReport(projectRoot, files, options) {
+    const cacheKey = `${projectRoot}|${options.rulesetPath || 'default'}|${options.phpcsPath || 'phpcs'}`;
+    if (!reportCache.has(cacheKey)) {
+        reportCache.set(cacheKey, executePhpcs(projectRoot, files, options));
+    }
+    return reportCache.get(cacheKey);
+}
+function resetWordPressReportCache() {
+    reportCache.clear();
+}
+function summarizeWordPressReport(report, limit = 5, projectRoot = process.cwd()) {
+    if (report.status === 'skipped') {
+        return `WordPress Coding Standards scan skipped: ${report.reason ?? 'not enabled'}`;
+    }
+    if (report.status === 'failed') {
+        return `WordPress Coding Standards scan failed: ${report.reason ?? 'unknown error'}`;
+    }
+    if (report.findings.length === 0) {
+        return 'WordPress Coding Standards scan passed with no issues.';
+    }
+    const lines = [
+        `WordPress Coding Standards: ${report.errors} error(s), ${report.warnings} warning(s).`,
+    ];
+    const topFindings = report.findings.slice(0, limit);
+    for (const finding of topFindings) {
+        const rel = node_path_1.default.relative(projectRoot, finding.filePath);
+        lines.push(`- ${rel || finding.filePath}:${finding.line} [${finding.type}] ${finding.source} – ${finding.message}`);
+    }
+    if (report.findings.length > limit) {
+        lines.push(`- ...and ${report.findings.length - limit} more finding(s)`);
+    }
+    return lines.join('\n');
+}
+function formatWordPressFinding(finding, projectRoot) {
+    const rel = node_path_1.default.relative(projectRoot, finding.filePath);
+    return `- ${rel || finding.filePath}:${finding.line} [${finding.type}] ${finding.source} – ${finding.message}`;
+}
+//# sourceMappingURL=wpPhpcsRunner.js.map

package/dist/analysis/static/wpPhpcsRunner.js.map

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

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;