react-code-smell-detector 1.4.2 → 1.5.1

package/dist/index.d.ts

@@ -2,4 +2,9 @@ export { analyzeProject, type AnalyzerOptions } from './analyzer.js';
 export { reportResults, type ReporterOptions } from './reporter.js';
 export * from './types/index.js';
 export { parseFile, parseCode, type ParseResult, type ParsedComponent } from './parser/index.js';
+export { runInteractiveFix, previewFixes, type InteractiveFixOptions } from './interactiveFixer.js';
+export { generatePRComment, postPRComment, generateInlineComments, type PRCommentConfig } from './prComments.js';
+export { loadBudget, checkBudget, formatBudgetReport, createBudgetConfig, type PerformanceBudget, type BudgetCheckResult } from './performanceBudget.js';
+export { generateComponentDocs, writeComponentDocs, type DocGeneratorOptions } from './docGenerator.js';
+export { generateAIRefactoringSuggestions, generateAIAnalysisReport, getQuickRefactoringTemplates, type AIRefactoringSuggestion, type AIRefactoringConfig } from './aiRefactoring.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACpE,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACpE,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,sBAAsB,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACjH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACzJ,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxG,OAAO,EACL,gCAAgC,EAChC,wBAAwB,EACxB,4BAA4B,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -2,3 +2,8 @@ export { analyzeProject } from './analyzer.js';
 export { reportResults } from './reporter.js';
 export * from './types/index.js';
 export { parseFile, parseCode } from './parser/index.js';
+export { runInteractiveFix, previewFixes } from './interactiveFixer.js';
+export { generatePRComment, postPRComment, generateInlineComments } from './prComments.js';
+export { loadBudget, checkBudget, formatBudgetReport, createBudgetConfig } from './performanceBudget.js';
+export { generateComponentDocs, writeComponentDocs } from './docGenerator.js';
+export { generateAIRefactoringSuggestions, generateAIAnalysisReport, getQuickRefactoringTemplates } from './aiRefactoring.js';

package/dist/interactiveFixer.d.ts

@@ -0,0 +1,20 @@
+import { CodeSmell } from './types/index.js';
+export interface InteractiveFixOptions {
+    smells: CodeSmell[];
+    rootDir: string;
+    showDiff?: boolean;
+}
+export interface InteractiveFixResult {
+    applied: number;
+    skipped: number;
+    total: number;
+}
+/**
+ * Interactive fix mode - review and apply fixes one by one
+ */
+export declare function runInteractiveFix(options: InteractiveFixOptions): Promise<InteractiveFixResult>;
+/**
+ * Preview all fixable issues without applying
+ */
+export declare function previewFixes(smells: CodeSmell[], rootDir: string): void;
+//# sourceMappingURL=interactiveFixer.d.ts.map

package/dist/interactiveFixer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactiveFixer.d.ts","sourceRoot":"","sources":["../src/interactiveFixer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAa,MAAM,kBAAkB,CAAC;AAIxD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA6HrG;AAoCD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA6BvE"}

package/dist/interactiveFixer.js

@@ -0,0 +1,178 @@
+import chalk from 'chalk';
+import fs from 'fs/promises';
+import { isFixable, describeFixAction } from './fixer.js';
+import * as readline from 'readline';
+/**
+ * Interactive fix mode - review and apply fixes one by one
+ */
+export async function runInteractiveFix(options) {
+    const { smells, rootDir, showDiff = true } = options;
+    const fixableSmells = smells.filter(isFixable);
+    if (fixableSmells.length === 0) {
+        console.log(chalk.yellow('\nNo auto-fixable issues found.\n'));
+        return { applied: 0, skipped: 0, total: 0 };
+    }
+    console.log(chalk.cyan(`\n🔧 Interactive Fix Mode`));
+    console.log(chalk.dim(`Found ${fixableSmells.length} fixable issue(s). Review each one:\n`));
+    console.log(chalk.dim('Commands: [y]es, [n]o, [a]ll, [q]uit\n'));
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const question = (prompt) => {
+        return new Promise((resolve) => {
+            rl.question(prompt, resolve);
+        });
+    };
+    let applied = 0;
+    let skipped = 0;
+    let applyAll = false;
+    // Group smells by file for efficient processing
+    const smellsByFile = new Map();
+    for (const smell of fixableSmells) {
+        const existing = smellsByFile.get(smell.file) || [];
+        existing.push(smell);
+        smellsByFile.set(smell.file, existing);
+    }
+    for (const [file, fileSmells] of smellsByFile) {
+        let content = await fs.readFile(file, 'utf-8');
+        const lines = content.split('\n');
+        const relativePath = file.replace(rootDir, '').replace(/^\//, '');
+        // Sort by line descending to preserve line numbers when fixing
+        const sortedSmells = [...fileSmells].sort((a, b) => b.line - a.line);
+        for (const smell of sortedSmells) {
+            const lineIndex = smell.line - 1;
+            if (lineIndex < 0 || lineIndex >= lines.length) {
+                skipped++;
+                continue;
+            }
+            const originalLine = lines[lineIndex];
+            const fixedLine = getFixedLine(smell, originalLine);
+            if (fixedLine === originalLine) {
+                skipped++;
+                continue;
+            }
+            // Display the issue
+            console.log(chalk.white('─'.repeat(60)));
+            console.log(chalk.yellow(`${relativePath}:${smell.line}`));
+            console.log(chalk.red(`  ${smell.type}: ${smell.message}`));
+            console.log(chalk.blue(`  Fix: ${describeFixAction(smell.type)}`));
+            if (showDiff) {
+                console.log();
+                console.log(chalk.red(`  - ${originalLine.trim()}`));
+                if (fixedLine !== null) {
+                    console.log(chalk.green(`  + ${fixedLine.trim()}`));
+                }
+                else {
+                    console.log(chalk.green(`  + (line removed)`));
+                }
+                console.log();
+            }
+            let shouldApply = applyAll;
+            if (!applyAll) {
+                const answer = await question(chalk.cyan('Apply this fix? [y/n/a/q]: '));
+                const choice = answer.toLowerCase().trim();
+                if (choice === 'q') {
+                    console.log(chalk.yellow('\nQuitting interactive mode.\n'));
+                    rl.close();
+                    return { applied, skipped: skipped + (fixableSmells.length - applied - skipped), total: fixableSmells.length };
+                }
+                else if (choice === 'a') {
+                    applyAll = true;
+                    shouldApply = true;
+                }
+                else if (choice === 'y' || choice === 'yes') {
+                    shouldApply = true;
+                }
+                else {
+                    shouldApply = false;
+                }
+            }
+            if (shouldApply) {
+                if (fixedLine === null) {
+                    lines.splice(lineIndex, 1);
+                }
+                else {
+                    lines[lineIndex] = fixedLine;
+                }
+                applied++;
+                console.log(chalk.green('  ✓ Applied'));
+            }
+            else {
+                skipped++;
+                console.log(chalk.dim('  ○ Skipped'));
+            }
+        }
+        // Write back the file if any changes were made
+        if (applied > 0) {
+            await fs.writeFile(file, lines.join('\n'), 'utf-8');
+        }
+    }
+    rl.close();
+    console.log(chalk.white('\n' + '─'.repeat(60)));
+    console.log(chalk.green(`✓ Applied ${applied} fix(es)`));
+    console.log(chalk.dim(`○ Skipped ${skipped} issue(s)`));
+    console.log();
+    return { applied, skipped, total: fixableSmells.length };
+}
+/**
+ * Get the fixed version of a line
+ */
+function getFixedLine(smell, line) {
+    switch (smell.type) {
+        case 'debug-statement':
+            return fixDebugStatement(line);
+        case 'js-var-usage':
+            return line.replace(/\bvar\s+/, 'let ');
+        case 'js-loose-equality':
+            return line
+                .replace(/([^=!])={2}([^=])/g, '$1===$2')
+                .replace(/!={1}([^=])/g, '!==$1');
+        case 'a11y-missing-alt':
+            return line.replace(/<img\s+(?![^>]*\balt\b)([^>]*?)(\/?>)/gi, '<img $1alt="" $2');
+        default:
+            return line;
+    }
+}
+function fixDebugStatement(line) {
+    const trimmed = line.trim();
+    if (/^console\.(log|debug|info|warn|error|trace|dir)\s*\(.*\);?\s*$/.test(trimmed)) {
+        return null;
+    }
+    if (/^debugger;?\s*$/.test(trimmed)) {
+        return null;
+    }
+    if (/console\.(log|debug|info|warn|error|trace|dir)\s*\(/.test(line)) {
+        return line.replace(/console\.(log|debug|info|warn|error|trace|dir)\s*\([^)]*\);?/g, '/* $& */');
+    }
+    return line;
+}
+/**
+ * Preview all fixable issues without applying
+ */
+export function previewFixes(smells, rootDir) {
+    const fixableSmells = smells.filter(isFixable);
+    if (fixableSmells.length === 0) {
+        console.log(chalk.yellow('\nNo auto-fixable issues found.\n'));
+        return;
+    }
+    console.log(chalk.cyan(`\n📋 Fixable Issues Preview (${fixableSmells.length} total)\n`));
+    const grouped = new Map();
+    for (const smell of fixableSmells) {
+        const existing = grouped.get(smell.type) || [];
+        existing.push(smell);
+        grouped.set(smell.type, existing);
+    }
+    for (const [type, typeSmells] of grouped) {
+        console.log(chalk.yellow(`\n${type} (${typeSmells.length})`));
+        console.log(chalk.dim(`  Fix: ${describeFixAction(type)}`));
+        for (const smell of typeSmells.slice(0, 5)) {
+            const relativePath = smell.file.replace(rootDir, '').replace(/^\//, '');
+            console.log(chalk.white(`  ${relativePath}:${smell.line}`));
+        }
+        if (typeSmells.length > 5) {
+            console.log(chalk.dim(`  ... and ${typeSmells.length - 5} more`));
+        }
+    }
+    console.log();
+}

package/dist/performanceBudget.d.ts

@@ -0,0 +1,54 @@
+import { AnalysisResult, AnalysisSummary, SmellType } from './types/index.js';
+export interface PerformanceBudget {
+    maxTotalSmells?: number;
+    maxErrors?: number;
+    maxWarnings?: number;
+    minScore?: number;
+    minGrade?: 'A' | 'B' | 'C' | 'D' | 'F';
+    maxByType?: Partial<Record<SmellType, number>>;
+    maxCyclomaticComplexity?: number;
+    maxCognitiveComplexity?: number;
+    maxComponentLines?: number;
+    maxPropsCount?: number;
+    maxUseEffectsPerComponent?: number;
+    maxSmellsPerFile?: number;
+    maxNewSmells?: number;
+    allowedGrowthPercent?: number;
+}
+export interface BudgetCheckResult {
+    passed: boolean;
+    violations: BudgetViolation[];
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+    };
+}
+export interface BudgetViolation {
+    rule: string;
+    actual: number | string;
+    threshold: number | string;
+    message: string;
+    severity: 'error' | 'warning';
+}
+/**
+ * Load performance budget from config file
+ */
+export declare function loadBudget(configPath?: string): Promise<PerformanceBudget>;
+/**
+ * Check analysis results against performance budget
+ */
+export declare function checkBudget(result: AnalysisResult, budget: PerformanceBudget): BudgetCheckResult;
+/**
+ * Format budget check result for console output
+ */
+export declare function formatBudgetReport(result: BudgetCheckResult): string;
+/**
+ * Create a default budget config file
+ */
+export declare function createBudgetConfig(targetPath?: string): Promise<string>;
+/**
+ * Compare current results with baseline for growth limits
+ */
+export declare function checkGrowthLimits(current: AnalysisSummary, baseline: AnalysisSummary, budget: PerformanceBudget): BudgetViolation[];
+//# sourceMappingURL=performanceBudget.d.ts.map

package/dist/performanceBudget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performanceBudget.d.ts","sourceRoot":"","sources":["../src/performanceBudget.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAsB,SAAS,EAAiB,MAAM,kBAAkB,CAAC;AAEjH,MAAM,WAAW,iBAAiB;IAEhC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAGvC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAG/C,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAGhC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAGnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAOD;;GAEG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsChF;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,iBAAiB,GACxB,iBAAiB,CA6GnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAqBpE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoB7E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,iBAAiB,GACxB,eAAe,EAAE,CA6BnB"}

package/dist/performanceBudget.js

@@ -0,0 +1,218 @@
+import fs from 'fs/promises';
+import path from 'path';
+import chalk from 'chalk';
+const DEFAULT_BUDGET = {
+    maxErrors: 0,
+    minGrade: 'C',
+};
+/**
+ * Load performance budget from config file
+ */
+export async function loadBudget(configPath) {
+    const paths = configPath
+        ? [configPath]
+        : [
+            '.smellbudget.json',
+            '.smellrc.json',
+            'package.json',
+        ];
+    for (const p of paths) {
+        try {
+            const fullPath = path.resolve(process.cwd(), p);
+            const content = await fs.readFile(fullPath, 'utf-8');
+            const parsed = JSON.parse(content);
+            // In package.json, look for "smellBudget" key
+            if (p === 'package.json') {
+                if (parsed.smellBudget) {
+                    return { ...DEFAULT_BUDGET, ...parsed.smellBudget };
+                }
+                continue;
+            }
+            // In .smellrc.json, look for "budget" key
+            if (p === '.smellrc.json') {
+                if (parsed.budget) {
+                    return { ...DEFAULT_BUDGET, ...parsed.budget };
+                }
+                continue;
+            }
+            return { ...DEFAULT_BUDGET, ...parsed };
+        }
+        catch {
+            continue;
+        }
+    }
+    return DEFAULT_BUDGET;
+}
+/**
+ * Check analysis results against performance budget
+ */
+export function checkBudget(result, budget) {
+    const violations = [];
+    const { summary, debtScore } = result;
+    // Check total smells
+    if (budget.maxTotalSmells !== undefined && summary.totalSmells > budget.maxTotalSmells) {
+        violations.push({
+            rule: 'maxTotalSmells',
+            actual: summary.totalSmells,
+            threshold: budget.maxTotalSmells,
+            message: `Total issues (${summary.totalSmells}) exceeds budget (${budget.maxTotalSmells})`,
+            severity: 'error',
+        });
+    }
+    // Check errors
+    if (budget.maxErrors !== undefined && summary.smellsBySeverity.error > budget.maxErrors) {
+        violations.push({
+            rule: 'maxErrors',
+            actual: summary.smellsBySeverity.error,
+            threshold: budget.maxErrors,
+            message: `Errors (${summary.smellsBySeverity.error}) exceeds budget (${budget.maxErrors})`,
+            severity: 'error',
+        });
+    }
+    // Check warnings
+    if (budget.maxWarnings !== undefined && summary.smellsBySeverity.warning > budget.maxWarnings) {
+        violations.push({
+            rule: 'maxWarnings',
+            actual: summary.smellsBySeverity.warning,
+            threshold: budget.maxWarnings,
+            message: `Warnings (${summary.smellsBySeverity.warning}) exceeds budget (${budget.maxWarnings})`,
+            severity: 'warning',
+        });
+    }
+    // Check minimum score
+    if (budget.minScore !== undefined && debtScore.score < budget.minScore) {
+        violations.push({
+            rule: 'minScore',
+            actual: debtScore.score,
+            threshold: budget.minScore,
+            message: `Technical debt score (${debtScore.score}) is below minimum (${budget.minScore})`,
+            severity: 'error',
+        });
+    }
+    // Check minimum grade
+    if (budget.minGrade !== undefined) {
+        const gradeOrder = ['F', 'D', 'C', 'B', 'A'];
+        const actualIndex = gradeOrder.indexOf(debtScore.grade);
+        const minIndex = gradeOrder.indexOf(budget.minGrade);
+        if (actualIndex < minIndex) {
+            violations.push({
+                rule: 'minGrade',
+                actual: debtScore.grade,
+                threshold: budget.minGrade,
+                message: `Technical debt grade (${debtScore.grade}) is below minimum (${budget.minGrade})`,
+                severity: 'error',
+            });
+        }
+    }
+    // Check per-type thresholds
+    if (budget.maxByType) {
+        for (const [type, maxCount] of Object.entries(budget.maxByType)) {
+            const actual = summary.smellsByType[type] || 0;
+            if (maxCount !== undefined && actual > maxCount) {
+                violations.push({
+                    rule: `maxByType.${type}`,
+                    actual,
+                    threshold: maxCount,
+                    message: `${type} issues (${actual}) exceeds budget (${maxCount})`,
+                    severity: 'warning',
+                });
+            }
+        }
+    }
+    // Check max smells per file
+    if (budget.maxSmellsPerFile !== undefined) {
+        for (const file of result.files) {
+            if (file.smells.length > budget.maxSmellsPerFile) {
+                const relativePath = file.file.split('/').slice(-2).join('/');
+                violations.push({
+                    rule: 'maxSmellsPerFile',
+                    actual: file.smells.length,
+                    threshold: budget.maxSmellsPerFile,
+                    message: `${relativePath} has ${file.smells.length} issues (max: ${budget.maxSmellsPerFile})`,
+                    severity: 'warning',
+                });
+            }
+        }
+    }
+    const errorViolations = violations.filter(v => v.severity === 'error');
+    return {
+        passed: errorViolations.length === 0,
+        violations,
+        summary: {
+            total: violations.length,
+            passed: Object.keys(budget).length - violations.length,
+            failed: violations.length,
+        },
+    };
+}
+/**
+ * Format budget check result for console output
+ */
+export function formatBudgetReport(result) {
+    let output = '';
+    if (result.passed) {
+        output += chalk.green('\n✓ Performance budget check passed\n');
+    }
+    else {
+        output += chalk.red('\n✗ Performance budget check failed\n');
+    }
+    if (result.violations.length > 0) {
+        output += chalk.dim('\nViolations:\n');
+        for (const violation of result.violations) {
+            const icon = violation.severity === 'error' ? chalk.red('✗') : chalk.yellow('⚠');
+            output += `  ${icon} ${violation.message}\n`;
+        }
+    }
+    output += chalk.dim(`\nChecks: ${result.summary.passed} passed, ${result.summary.failed} failed\n`);
+    return output;
+}
+/**
+ * Create a default budget config file
+ */
+export async function createBudgetConfig(targetPath) {
+    const config = {
+        maxErrors: 0,
+        maxWarnings: 10,
+        minScore: 70,
+        minGrade: 'C',
+        maxSmellsPerFile: 5,
+        maxByType: {
+            'useEffect-overuse': 3,
+            'prop-drilling': 5,
+            'large-component': 2,
+        },
+    };
+    const filePath = targetPath || '.smellbudget.json';
+    const fullPath = path.resolve(process.cwd(), filePath);
+    await fs.writeFile(fullPath, JSON.stringify(config, null, 2), 'utf-8');
+    return fullPath;
+}
+/**
+ * Compare current results with baseline for growth limits
+ */
+export function checkGrowthLimits(current, baseline, budget) {
+    const violations = [];
+    const newSmells = current.totalSmells - baseline.totalSmells;
+    if (budget.maxNewSmells !== undefined && newSmells > budget.maxNewSmells) {
+        violations.push({
+            rule: 'maxNewSmells',
+            actual: newSmells,
+            threshold: budget.maxNewSmells,
+            message: `New issues (${newSmells}) exceeds allowed increase (${budget.maxNewSmells})`,
+            severity: 'error',
+        });
+    }
+    if (budget.allowedGrowthPercent !== undefined && baseline.totalSmells > 0) {
+        const growthPercent = ((newSmells / baseline.totalSmells) * 100);
+        if (growthPercent > budget.allowedGrowthPercent) {
+            violations.push({
+                rule: 'allowedGrowthPercent',
+                actual: `${growthPercent.toFixed(1)}%`,
+                threshold: `${budget.allowedGrowthPercent}%`,
+                message: `Issue growth (${growthPercent.toFixed(1)}%) exceeds allowed (${budget.allowedGrowthPercent}%)`,
+                severity: 'error',
+            });
+        }
+    }
+    return violations;
+}

package/dist/prComments.d.ts

@@ -0,0 +1,47 @@
+import { CodeSmell, AnalysisResult } from './types/index.js';
+export interface PRCommentConfig {
+    token: string;
+    repo: string;
+    owner: string;
+    prNumber: number;
+    commitSha?: string;
+    collapseThreshold?: number;
+    onlyNew?: boolean;
+}
+export interface PRComment {
+    body: string;
+    path?: string;
+    line?: number;
+    side?: 'LEFT' | 'RIGHT';
+}
+/**
+ * Generate a PR comment summary from analysis results
+ */
+export declare function generatePRComment(result: AnalysisResult, rootDir: string): string;
+/**
+ * Generate inline review comments for specific lines
+ */
+export declare function generateInlineComments(smells: CodeSmell[], rootDir: string): PRComment[];
+/**
+ * Post a comment to a GitHub PR using the GitHub API
+ */
+export declare function postPRComment(config: PRCommentConfig, comment: string): Promise<boolean>;
+/**
+ * Post inline review comments to a GitHub PR
+ */
+export declare function postInlineComments(config: PRCommentConfig, comments: PRComment[]): Promise<{
+    success: number;
+    failed: number;
+}>;
+/**
+ * Parse GitHub repository info from environment or git remote
+ */
+export declare function parseGitHubInfo(): {
+    owner: string;
+    repo: string;
+} | null;
+/**
+ * Get PR number from environment (GitHub Actions)
+ */
+export declare function getPRNumber(): number | null;
+//# sourceMappingURL=prComments.d.ts.map

package/dist/prComments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prComments.d.ts","sourceRoot":"","sources":["../src/prComments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAkFjF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAiCxF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4B9F;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,SAAS,EAAE,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAkD9C;AAgBD;;GAEG;AACH,wBAAgB,eAAe,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASxE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAyB3C"}